Skip to content

html5-parservsgoquery

Apache-2.0 1 1 700
17.6 thousand (month) Jun 03 2007 0.4.12(2023-11-19 15:09:54 ago)
14,926 3 3 BSD-3-Clause
Aug 29 2016 58.1 thousand (month) v1.12.0(2026-03-15 16:28:52 ago)

html5-parser is a Python library for parsing HTML and XML documents.

A fast implementation of the HTML 5 parsing spec for Python. Parsing is done in C using a variant of the gumbo parser. The gumbo parse tree is then transformed into an lxml tree, also in C, yielding parse times that can be a thirtieth of the html5lib parse times. That is a speedup of 30x. This differs, for instance, from the gumbo python bindings, where the initial parsing is done in C but the transformation into the final tree is done in python.

It is built on top of the popular lxml library and provides a simple and intuitive API for working with the document's structure.

html5-parser uses the HTML5 parsing algorithm, which is more lenient and forgiving than the traditional XML-based parsing algorithm. This means that it can parse HTML documents with malformed or missing tags and still produce a usable parse tree.

To use html5-parser, you first need to install it via pip by running pip install html5-parser. Once it is installed, you can use the html5_parser.parse() function to parse an HTML document and create a parse tree. For example:

``` from html5_parser import parse

html_string = "Hello, World!" root = parse(html_string) print(root.tag) # html ` You can also use `html5_parser.parse() with file-like objects, bytes or file paths.

Once you have a parse tree, you can use the find() and findall() methods to search for elements in the document similar to BeautifulSoup.

html5-parser also supports searching using xpath, similar to lxml.

goquery brings a syntax and a set of features similar to jQuery to the Go language. goquery is a popular and easy-to-use library for Go that allows you to use a CSS selector-like syntax to select elements from an HTML document.

It is based on Go's net/html package and the CSS Selector library cascadia. Since the net/html parser returns nodes, and not a full-featured DOM tree, jQuery's stateful manipulation functions (like height(), css(), detach()) have been left off.

Also, because the net/html parser requires UTF-8 encoding, so does goquery: it is the caller's responsibility to ensure that the source document provides UTF-8 encoded HTML. See the wiki for various options to do this. Syntax-wise, it is as close as possible to jQuery, with the same function names when possible, and that warm and fuzzy chainable interface. jQuery being the ultra-popular library that it is, I felt that writing a similar HTML-manipulating library was better to follow its API than to start anew (in the same spirit as Go's fmt package), even though some of its methods are less than intuitive (looking at you, index()...).

goquery can download HTML by itself (using built-in http client) though it's not recommended for web scraping as it's likely to be blocked.

Example Use


```python from html5_parser import parse html_string = "Hello, World!" root = parse(html_string) print(root.tag) # html body = root.find("body") # or find all print(body.text) # "Hello, World!" for el in root.findall("p"): print(el.text) # "Hello ```
```go package main import ( "fmt" "github.com/PuerkitoBio/goquery" ) func main() { // Use goquery.NewDocument to load an HTML document // This can load from URL doc, err := goquery.NewDocument("http://example.com") // or HTML string: doc, err := goquery.NewDocumentFromReader("some html") if err != nil { fmt.Println("Error:", err) return } // Use the Selection.Find method to select elements from the document doc.Find("a").Each(func(i int, s *goquery.Selection) { // Use the Selection.Text method to get the text of the element fmt.Println(s.Text()) // Use the Selection.Attr method to get the value of an attribute fmt.Println(s.Attr("href")) }) } ```

Alternatives / Similar


Was this page helpful?