Skip to main content

A jquery-like library for python

Project description

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 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.

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.2.3

Allow to pass this in .filter() callback

Add .contents() .items()

Add tox.ini

Bug fixes: fix #35 #55 #64 #66

1.2.2

Fix cssselectpatch to match the newer implementation of cssselect. Fixes issue #62, #52 and #59 (Haoyu Bai)

Fix issue #37 (Caleb Burns)

1.2.1

Allow to use a custom css translator.

Fix issue 44: case problem with xml documents

1.2

PyQuery now use cssselect. See issue 43.

Fix issue 40: forward .html() extra arguments to lxml.etree.tostring

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

pyquery-1.2.3.zip (36.9 kB view details)

Uploaded Source

pyquery-1.2.3.tar.gz (23.3 kB view details)

Uploaded Source

File details

Details for the file pyquery-1.2.3.zip.

File metadata

  • Download URL: pyquery-1.2.3.zip
  • Upload date:
  • Size: 36.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyquery-1.2.3.zip
Algorithm Hash digest
SHA256 548c68af551f5e0928623061ac6fb720e2f44f58e4ff6a12b78871fee38f96c0
MD5 0e5edc7fc1d7ebf90014cf8a68f9223f
BLAKE2b-256 6fc5bbd64d3feccb727d2362e1f05f4412af93e3954fab27882157a7c58d24b0

See more details on using hashes here.

Provenance

File details

Details for the file pyquery-1.2.3.tar.gz.

File metadata

  • Download URL: pyquery-1.2.3.tar.gz
  • Upload date:
  • Size: 23.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for pyquery-1.2.3.tar.gz
Algorithm Hash digest
SHA256 16805752f08c4449aba74285a549d6335f1c6773d45399ecdd885ffa1c4ba69a
MD5 ed84a42a9be41a538566bc2c67ac7df7
BLAKE2b-256 8496c3524ebb861799f1117506929100c20ddc1136db086481e7c8a0e59fe32c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page