A jquery-like library for python
pyquery: a jquery-like library for python
pyquery allows you to make jquery queries on xml documents. The API is as much as possible the similar to jquery. pyquery uses lxml for fast xml and html manipulation.
The project is being actively developped on a git repository on Github. I have the policy of giving push access to anyone who wants it and then to review what he does. So if you want to contribute just email me.
Please report bugs on the github issue tracker.
You can use the PyQuery class to load an xml document from a string, a lxml document, from a file or from an url:
>>> from pyquery import PyQuery as pq >>> from lxml import etree >>> import urllib >>> d = pq("<html></html>") >>> d = pq(etree.fromstring("<html></html>")) >>> d = pq(url=your_url) >>> d = pq(url=your_url, ... opener=lambda url, **kw: urlopen(url).read()) >>> d = pq(filename=path_to_html_file)
Now d is like the $ in jquery:
>>> d("#hello") [<p#hello.hello>] >>> p = d("#hello") >>> print(p.html()) Hello world ! >>> p.html("you know <a href='http://python.org/'>Python</a> rocks") [<p#hello.hello>] >>> print(p.html()) you know <a href="http://python.org/">Python</a> rocks >>> print(p.text()) you know Python rocks
You can use some of the pseudo classes that are available in jQuery but that are not standard in css such as :first :last :even :odd :eq :lt :gt :checked :selected :file:
>>> d('p:first') [<p#hello.hello>]
See http://packages.python.org/pyquery/ for the full documentation
cssselect compat. See https://github.com/SimonSapin/cssselect/pull/22
tests improvments. no longer require a eth connection.
Moved to github. So a few files are renamed from .txt to .rst
Added .xhtml_to_html() and .remove_namespaces()
Use requests to fetch urls (if available)
Use restkit’s proxy instead of Paste (which will die with py3)
Allow to open https urls
python2.5 is no longer supported (may work, but tests are broken)
Allow to pass this in .filter() callback
Add .contents() .items()
Bug fixes: fix #35 #55 #64 #66
Fix cssselectpatch to match the newer implementation of cssselect. Fixes issue #62, #52 and #59 (Haoyu Bai)
Fix issue #37 (Caleb Burns)
Allow to use a custom css translator.
Fix issue 44: case problem with xml documents
PyQuery now use cssselect. See issue 43.
Fix issue 40: forward .html() extra arguments to lxml.etree.tostring
Minor release. Include test file so you can run tests from the tarball.
fix issues 30, 31, 32 - py3 improvements / webob 1.2+ support
fix issues 24
Python 3 compatible
Add __unicode__ method
Add root and encoding attribute
fix issues 19, 20, 22, 23
Move README.txt at package root
Add CHANGES.txt and add it to long_description
Change PyQuery.each behavior to reflect jQuery api