skip to navigation
skip to content

pyquery 1.2.1

A jquery-like library for python

Package Documentation

Latest Version: 1.4.0

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.

This is not (or at least not yet) a library to produce or interact with javascript code. I just liked the jquery API and I missed it in python so I told myself “Hey let’s make jquery in python”. This is the result.

It can be used for many purposes, one idea that I might try in the future is to use it for templating with pure http templates that you modify using pyquery. I can also be used for web scrapping or for theming applications with Deliverance.

The project is being actively developped on a mercurial repository on Bitbucket. 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 bitbucket 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='')
>>> # d = pq(url='', opener=lambda url: urllib.urlopen(url).read())
>>> d = pq(filename=path_to_html_file)

Now d is like the $ in jquery:

>>> d("#hello")
>>> p = d("#hello")
>>> print(p.html())
Hello world !
>>> p.html("you know <a href=''>Python</a> rocks")
>>> print(p.html())
you know <a href="">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')

See for the full documentation



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


Added PyQuery.outerHtml

Added PyQuery.fn


Change PyQuery.each behavior to reflect jQuery api

File Type Py Version Uploaded on Size
pyquery-1.2.1.tar.gz (md5) Source 2012-05-08 21KB (md5) Source 2012-05-08 34KB