Python bindings for Gumbo HTML parser
Gumbo is an implementation of the HTML5 parsing algorithm implemented as a pure C99 library with no outside dependencies. It’s designed to serve as a building block for other tools and libraries such as linters, validators, templating languages, and refactoring and analysis tools. This package contains the library itself, Python ctypes bindings for the library, and adapters for html5lib and BeautifulSoup (3.2) that give it the same API as those libaries.
Wishlist (aka “We couldn’t get these into the original release, but are hoping to add them soon”):
`pip install gumbo` should do it. If you have a local copy, `python setup.py install` from the root directory.
For the ctypes bindings:
import gumbo with gumbo.parse(text) as output: root = output.contents.root.contents # root is a Node object representing the root of the parse tree # tree-walk over it as necessary.
For the BeautifulSoup bindings:
import gumbo soup = gumbo.soup_parse(text) # soup is a BeautifulSoup object representing the parse tree.
For the html5lib bindings:
from gumbo import html5lib doc = html5lib.parse(text[, treebuilder='lxml'])
Recommended best-practice for Python usage is to use one of the adapters to an existing API (personally, I prefer BeautifulSoup) and write your program in terms of those. The raw CTypes bindings should be considered building blocks for higher-level libraries and rarely referenced directly.
See the source code, Pydoc, and implementation of soup_adapter and html5lib_adapter for more information.
We’ll make a best effort to preserve API compatibility between releases. The initial release is a 0.9 (beta) release to solicit comments from early adopters, but if no major problems are found with the API, a 1.0 release will follow shortly, and the API of that should be considered stable. If changes are necessary, we follow [semantic versioning].
We make no such guarantees about the ABI, and it’s very likely that subsequent versions may require a recompile of client code. For this reason, we recommend NOT using Gumbo data structures throughout a program, and instead limiting them to a translation layer that picks out whatever data is needed from the parse tree and then converts that to persistent data structures more appropriate for the application. The API is structured to encourage this use, with a single delete function for the whole parse tree, and is not designed with mutation in mind.
Most of this is transparent to Python usage, as the Python adapters are all built with this in mind. However, since ctypes requires ABI compatibility, it does mean you’ll have to re-deploy the gumboc library and C extension when upgrading to a new version.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|gumbo-0.10.0.macosx-10.10-x86_64.tar.gz (170.3 kB) Copy SHA256 Checksum SHA256||any||Dumb Binary||May 1, 2015|
|gumbo-0.10.0.tar.gz (160.0 kB) Copy SHA256 Checksum SHA256||–||Source||May 1, 2015|