Skip to main content

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.

Quickstart

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='http://google.com/')
>>> # d = pq(url='http://google.com/', opener=lambda url: urllib.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

News

1.1.1

Minor release. Include test file so you can run tests from the tarball.

1.1

fix issues 30, 31, 32 - py3 improvements / webob 1.2+ support

1.0

fix issues 24

0.7

Python 3 compatible

Add __unicode__ method

Add root and encoding attribute

fix issues 19, 20, 22, 23

0.6.1

Move README.txt at package root

Add CHANGES.txt and add it to long_description

0.6

Added PyQuery.outerHtml

Added PyQuery.fn

Added PyQuery.map

Change PyQuery.each behavior to reflect jQuery api

Metadata

Release files for pyquery 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distributions (sdists)

Source distribution for pyquery 1.1.1
File Size Uploaded
pyquery-1.1.1.zip 35.2 kB Details
pyquery-1.1.1.tar.gz 21.1 kB Details

Release files / pyquery-1.1.1.zip

Download URL pyquery-1.1.1.zip
Size 35.2 kB
Tags Source
SHA-256 checksum
How to use checksums
fd811d9434f0e891e4b8f5f2d363a86751684b2693f3fe03dfbef7d178729c5c
BLAKE2b-256 checksum
How to use checksums
911fa88ca3ec9756d51b49fad47517091e9e6f44acb79442ccecd2152f2d54f2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / pyquery-1.1.1.tar.gz

Download URL pyquery-1.1.1.tar.gz
Size 21.1 kB
Tags Source
SHA-256 checksum
How to use checksums
4bdc4b5add5d65055aeb05860c24f53557540db1d945413093c74b554db62a44
BLAKE2b-256 checksum
How to use checksums
6056ddd8dabed993d8a10762cef45bdb0993610cde269efb268cf7475cdfe521
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

2.1.0

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.4.3

2 release files

1.4.2

2 release files

1.4.1

2 release files

1.4.0

2 release files

1.3.0

2 release files

1.2.17

2 release files

1.2.16

2 release files

1.2.15

2 release files

1.2.14

2 release files

1.2.13

2 release files

1.2.12

2 release files

1.2.9

1 release file

1.2.8

1 release file

1.2.7

1 release file

1.2.6

1 release file

1.2.5

1 release file

1.2.4

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2

2 release files

This release

1.1.1 This release

2 release files

1.1

2 release files

1.0

2 release files

0.7

2 release files

0.6.1

2 release files

0.6

2 release files

0.5

1 release file

0.4

1 release file

0.3.1

1 release file

0.3

1 release file

0.2

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page