123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453 |
- package html2text
- import (
- "bytes"
- "io"
- "regexp"
- "strings"
- "unicode"
- "github.com/olekukonko/tablewriter"
- "github.com/ssor/bom"
- "golang.org/x/net/html"
- "golang.org/x/net/html/atom"
- )
- // Options provide toggles and overrides to control specific rendering behaviors.
- type Options struct {
- PrettyTables bool // Turns on pretty ASCII rendering for table elements.
- }
- // FromHTMLNode renders text output from a pre-parsed HTML document.
- func FromHTMLNode(doc *html.Node, o ...Options) (string, error) {
- var options Options
- if len(o) > 0 {
- options = o[0]
- }
- ctx := textifyTraverseContext{
- buf: bytes.Buffer{},
- options: options,
- }
- if err := ctx.traverse(doc); err != nil {
- return "", err
- }
- text := strings.TrimSpace(newlineRe.ReplaceAllString(
- strings.Replace(ctx.buf.String(), "\n ", "\n", -1), "\n\n"),
- )
- return text, nil
- }
- // FromReader renders text output after parsing HTML for the specified
- // io.Reader.
- func FromReader(reader io.Reader, options ...Options) (string, error) {
- newReader, err := bom.NewReaderWithoutBom(reader)
- if err != nil {
- return "", err
- }
- doc, err := html.Parse(newReader)
- if err != nil {
- return "", err
- }
- return FromHTMLNode(doc, options...)
- }
- // FromString parses HTML from the input string, then renders the text form.
- func FromString(input string, options ...Options) (string, error) {
- bs := bom.CleanBom([]byte(input))
- text, err := FromReader(bytes.NewReader(bs), options...)
- if err != nil {
- return "", err
- }
- return text, nil
- }
- var (
- spacingRe = regexp.MustCompile(`[ \r\n\t]+`)
- newlineRe = regexp.MustCompile(`\n\n+`)
- )
- // traverseTableCtx holds text-related context.
- type textifyTraverseContext struct {
- buf bytes.Buffer
- prefix string
- tableCtx tableTraverseContext
- options Options
- endsWithSpace bool
- justClosedDiv bool
- blockquoteLevel int
- lineLength int
- }
- // tableTraverseContext holds table ASCII-form related context.
- type tableTraverseContext struct {
- header []string
- body [][]string
- footer []string
- tmpRow int
- isInFooter bool
- }
- func (tableCtx *tableTraverseContext) init() {
- tableCtx.body = [][]string{}
- tableCtx.header = []string{}
- tableCtx.footer = []string{}
- tableCtx.isInFooter = false
- tableCtx.tmpRow = 0
- }
- func (ctx *textifyTraverseContext) handleElement(node *html.Node) error {
- ctx.justClosedDiv = false
- switch node.DataAtom {
- case atom.Br:
- return ctx.emit("\n")
- case atom.H1, atom.H2, atom.H3:
- subCtx := textifyTraverseContext{}
- if err := subCtx.traverseChildren(node); err != nil {
- return err
- }
- str := subCtx.buf.String()
- dividerLen := 0
- for _, line := range strings.Split(str, "\n") {
- if lineLen := len([]rune(line)); lineLen-1 > dividerLen {
- dividerLen = lineLen - 1
- }
- }
- var divider string
- if node.DataAtom == atom.H1 {
- divider = strings.Repeat("*", dividerLen)
- } else {
- divider = strings.Repeat("-", dividerLen)
- }
- if node.DataAtom == atom.H3 {
- return ctx.emit("\n\n" + str + "\n" + divider + "\n\n")
- }
- return ctx.emit("\n\n" + divider + "\n" + str + "\n" + divider + "\n\n")
- case atom.Blockquote:
- ctx.blockquoteLevel++
- ctx.prefix = strings.Repeat(">", ctx.blockquoteLevel) + " "
- if err := ctx.emit("\n"); err != nil {
- return err
- }
- if ctx.blockquoteLevel == 1 {
- if err := ctx.emit("\n"); err != nil {
- return err
- }
- }
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- ctx.blockquoteLevel--
- ctx.prefix = strings.Repeat(">", ctx.blockquoteLevel)
- if ctx.blockquoteLevel > 0 {
- ctx.prefix += " "
- }
- return ctx.emit("\n\n")
- case atom.Div:
- if ctx.lineLength > 0 {
- if err := ctx.emit("\n"); err != nil {
- return err
- }
- }
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- var err error
- if !ctx.justClosedDiv {
- err = ctx.emit("\n")
- }
- ctx.justClosedDiv = true
- return err
- case atom.Li:
- if err := ctx.emit("* "); err != nil {
- return err
- }
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- return ctx.emit("\n")
- case atom.B, atom.Strong:
- subCtx := textifyTraverseContext{}
- subCtx.endsWithSpace = true
- if err := subCtx.traverseChildren(node); err != nil {
- return err
- }
- str := subCtx.buf.String()
- return ctx.emit("*" + str + "*")
- case atom.A:
- // If image is the only child, take its alt text as the link text.
- if img := node.FirstChild; img != nil && node.LastChild == img && img.DataAtom == atom.Img {
- if altText := getAttrVal(img, "alt"); altText != "" {
- if err := ctx.emit(altText); err != nil {
- return err
- }
- }
- } else if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- hrefLink := ""
- if attrVal := getAttrVal(node, "href"); attrVal != "" {
- attrVal = ctx.normalizeHrefLink(attrVal)
- if attrVal != "" {
- hrefLink = "( " + attrVal + " )"
- }
- }
- return ctx.emit(hrefLink)
- case atom.P, atom.Ul:
- return ctx.paragraphHandler(node)
- case atom.Table, atom.Tfoot, atom.Th, atom.Tr, atom.Td:
- if ctx.options.PrettyTables {
- return ctx.handleTableElement(node)
- } else if node.DataAtom == atom.Table {
- return ctx.paragraphHandler(node)
- }
- return ctx.traverseChildren(node)
- case atom.Style, atom.Script, atom.Head:
- // Ignore the subtree.
- return nil
- default:
- return ctx.traverseChildren(node)
- }
- }
- // paragraphHandler renders node children surrounded by double newlines.
- func (ctx *textifyTraverseContext) paragraphHandler(node *html.Node) error {
- if err := ctx.emit("\n\n"); err != nil {
- return err
- }
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- return ctx.emit("\n\n")
- }
- // handleTableElement is only to be invoked when options.PrettyTables is active.
- func (ctx *textifyTraverseContext) handleTableElement(node *html.Node) error {
- if !ctx.options.PrettyTables {
- panic("handleTableElement invoked when PrettyTables not active")
- }
- switch node.DataAtom {
- case atom.Table:
- if err := ctx.emit("\n\n"); err != nil {
- return err
- }
- // Re-intialize all table context.
- ctx.tableCtx.init()
- // Browse children, enriching context with table data.
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- buf := &bytes.Buffer{}
- table := tablewriter.NewWriter(buf)
- table.SetHeader(ctx.tableCtx.header)
- table.SetFooter(ctx.tableCtx.footer)
- table.AppendBulk(ctx.tableCtx.body)
- // Render the table using ASCII.
- table.Render()
- if err := ctx.emit(buf.String()); err != nil {
- return err
- }
- return ctx.emit("\n\n")
- case atom.Tfoot:
- ctx.tableCtx.isInFooter = true
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- ctx.tableCtx.isInFooter = false
- case atom.Tr:
- ctx.tableCtx.body = append(ctx.tableCtx.body, []string{})
- if err := ctx.traverseChildren(node); err != nil {
- return err
- }
- ctx.tableCtx.tmpRow++
- case atom.Th:
- res, err := ctx.renderEachChild(node)
- if err != nil {
- return err
- }
- ctx.tableCtx.header = append(ctx.tableCtx.header, res)
- case atom.Td:
- res, err := ctx.renderEachChild(node)
- if err != nil {
- return err
- }
- if ctx.tableCtx.isInFooter {
- ctx.tableCtx.footer = append(ctx.tableCtx.footer, res)
- } else {
- ctx.tableCtx.body[ctx.tableCtx.tmpRow] = append(ctx.tableCtx.body[ctx.tableCtx.tmpRow], res)
- }
- }
- return nil
- }
- func (ctx *textifyTraverseContext) traverse(node *html.Node) error {
- switch node.Type {
- default:
- return ctx.traverseChildren(node)
- case html.TextNode:
- data := strings.Trim(spacingRe.ReplaceAllString(node.Data, " "), " ")
- return ctx.emit(data)
- case html.ElementNode:
- return ctx.handleElement(node)
- }
- }
- func (ctx *textifyTraverseContext) traverseChildren(node *html.Node) error {
- for c := node.FirstChild; c != nil; c = c.NextSibling {
- if err := ctx.traverse(c); err != nil {
- return err
- }
- }
- return nil
- }
- func (ctx *textifyTraverseContext) emit(data string) error {
- if data == "" {
- return nil
- }
- var (
- lines = ctx.breakLongLines(data)
- err error
- )
- for _, line := range lines {
- runes := []rune(line)
- startsWithSpace := unicode.IsSpace(runes[0])
- if !startsWithSpace && !ctx.endsWithSpace {
- if err = ctx.buf.WriteByte(' '); err != nil {
- return err
- }
- ctx.lineLength++
- }
- ctx.endsWithSpace = unicode.IsSpace(runes[len(runes)-1])
- for _, c := range line {
- if _, err = ctx.buf.WriteString(string(c)); err != nil {
- return err
- }
- ctx.lineLength++
- if c == '\n' {
- ctx.lineLength = 0
- if ctx.prefix != "" {
- if _, err = ctx.buf.WriteString(ctx.prefix); err != nil {
- return err
- }
- }
- }
- }
- }
- return nil
- }
- const maxLineLen = 74
- func (ctx *textifyTraverseContext) breakLongLines(data string) []string {
- // Only break lines when in blockquotes.
- if ctx.blockquoteLevel == 0 {
- return []string{data}
- }
- var (
- ret = []string{}
- runes = []rune(data)
- l = len(runes)
- existing = ctx.lineLength
- )
- if existing >= maxLineLen {
- ret = append(ret, "\n")
- existing = 0
- }
- for l+existing > maxLineLen {
- i := maxLineLen - existing
- for i >= 0 && !unicode.IsSpace(runes[i]) {
- i--
- }
- if i == -1 {
- // No spaces, so go the other way.
- i = maxLineLen - existing
- for i < l && !unicode.IsSpace(runes[i]) {
- i++
- }
- }
- ret = append(ret, string(runes[:i])+"\n")
- for i < l && unicode.IsSpace(runes[i]) {
- i++
- }
- runes = runes[i:]
- l = len(runes)
- existing = 0
- }
- if len(runes) > 0 {
- ret = append(ret, string(runes))
- }
- return ret
- }
- func (ctx *textifyTraverseContext) normalizeHrefLink(link string) string {
- link = strings.TrimSpace(link)
- link = strings.TrimPrefix(link, "mailto:")
- return link
- }
- // renderEachChild visits each direct child of a node and collects the sequence of
- // textuual representaitons separated by a single newline.
- func (ctx *textifyTraverseContext) renderEachChild(node *html.Node) (string, error) {
- buf := &bytes.Buffer{}
- for c := node.FirstChild; c != nil; c = c.NextSibling {
- s, err := FromHTMLNode(c, ctx.options)
- if err != nil {
- return "", err
- }
- if _, err = buf.WriteString(s); err != nil {
- return "", err
- }
- if c.NextSibling != nil {
- if err = buf.WriteByte('\n'); err != nil {
- return "", err
- }
- }
- }
- return buf.String(), nil
- }
- func getAttrVal(node *html.Node, attrName string) string {
- for _, attr := range node.Attr {
- if attr.Key == attrName {
- return attr.Val
- }
- }
- return ""
- }
|