gokogiri

README

Gokogiri

LibXML bindings for the Go programming language.

The gokogiri package provides a Go interface to the libxml2 library.

It is inspired by the ruby-based Nokogiri API, and allows one to parse, manipulate, and create HTML and XML documents. Nodes can be selected using either CSS selectors (in much the same fashion as jQuery) or XPath 1.0 expressions, and a simple DOM-like interface allows for building up documents from scratch.

It uses parsing default options that ignore errors or warnings, making it suitable for the poorly-formed 'tag soup' often found on the web. The xml.StrictParsingOption is conveniently provided for standards-compliant behaviour.

This fork incorporates changes required to compile on Go 1.4 and above.

To install:

• sudo apt-get install libxml2-dev libonig-dev
• go get github.com/jbowtie/gokogiri

To run test:

• go test github.com/jbowtie/gokogiri/html
• go test github.com/jbowtie/gokogiri/xml

Basic example:

package main

import (
  "net/http"
  "io/ioutil"
  "github.com/jbowtie/gokogiri"
)

func main() {
  // fetch and read a web page
  resp, _ := http.Get("http://www.google.com")
  page, _ := ioutil.ReadAll(resp.Body)

  // parse the web page
  doc, _ := gokogiri.ParseHtml(page)
  defer doc.Free()

  // perform operations on the parsed page -- consult the tests for examples
}

Original upstream version by Zhigang Chen and Hampton Catlin.

Documentation

Overview

The gokogiri package provides a Go interface to the libxml2 library.

It is inspired by the ruby-based Nokogiri API, and allows one to parse, manipulate, and create HTML and XML documents. Nodes can be selected using either CSS selectors (in much the same fashion as jQuery) or XPath 1.0 expressions, and a simple DOM-like inteface allows for building up documents from scratch.

Index

• func ParseHtml(content []byte) (doc *html.HtmlDocument, err error)
• func ParseXml(content []byte) (doc *xml.XmlDocument, err error)

Functions

func ParseHtml

func ParseHtml(content []byte) (doc *html.HtmlDocument, err error)

ParseHtml parses an UTF-8 encoded byte array and returns an html.HtmlDocument. It uses parsing default options that ignore errors or warnings, making it suitable for the poorly-formed 'tag soup' often found on the web.

If the content is not UTF-8 encoded or you want to customize the parsing options, you should call html.Parse directly.

func ParseXml

func ParseXml(content []byte) (doc *xml.XmlDocument, err error)

ParseXml parses an UTF-8 encoded byte array and returns an xml.XmlDocument. By default the parsing options ignore validation and suppress errors and warnings. This allows one to be liberal in accepting badly-formed documents, but is not standards-compliant.

If the content is not UTF-8 encoded or you want to customize the parsing options, you should call the Parse or ReadFile functions found in the github.com/jbowtie/gokogiri/xml package. The xml.StrictParsingOption is conveniently provided for standards-compliant behaviour.