Skip to content

goqueryvslxml

BSD-3-Clause 3 3 14,116
58.1 thousand (month) Aug 29 2016 v1.10.0(3 months ago)
2,719 13 20 NOASSERTION
Dec 13 2022 107.4 million (month) 5.3.0(3 months ago)

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.

lxml is a low-level XML and HTML tree processor. It's used by many other libraries such as parsel or beautifulsoup for higher level HTML parsing.

One of the main features of lxml is its speed and efficiency.
It is built on top of the libxml2 and libxslt C libraries, which are known for their high performance and low memory footprint. This makes lxml well-suited for processing large and complex XML and HTML documents.

One of the key components of lxml is the ElementTree API, which is modeled after the ElementTree API from the Python standard library's xml module. This API provides a simple and intuitive way to access and manipulate the elements and attributes of an XML or HTML document. It also provides a powerful and flexible Xpath engine that allows you to select elements based on their names, attributes, and contents.

Another feature of lxml is its support for parsing and creating XML documents using the XSLT standard. The lxml library provides a powerful and easy-to-use interface for applying XSLT stylesheets to XML documents, which can be used to transform and convert XML documents into other formats, such as HTML, PDF, or even other XML formats.

For web scraping it's best to use other higher level libraries that use lxml like parsel or beautifulsoup

Highlights


low-levelfast

Example Use


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"))
  })
}
from lxml import etree

# this is our HTML page:
html = """
<head>
  <title>Hello World!</title>
</head>
<body>
  <div id="product">
    <h1>Product Title</h1>
    <p>paragraph 1</p>
    <p>paragraph2</p>
    <span class="price">$10</span>
  </div>
</body>
"""

tree = tree.fromstring(html)

# for parsing, LXML only supports XPath selectors:
tree.xpath('//span[@class="price"]')[0].text
"$10"

Alternatives / Similar


Was this page helpful?