Skip to main content

A jquery-like library for python

Project description

pyquery: a jquery-like library for python

Build Status

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.

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.

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=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://pyquery.rtfd.org/ for the full documentation

News

1.2.14 (2016-10-10)

  • fix val() for <textarea> and <select>, to match jQuery behavior

1.2.13 (2016-04-12)

  • Note explicit support for Python 3.5

1.2.12 (2016-04-12)

  • make_links_absolute now take care of whitespaces

  • added pseudo selector :has()

  • add cookies arguments as allowed arguments for requests

1.2.11 (2016-02-02)

  • Preserve namespaces attribute on PyQuery copies.

  • Do not raise an error when the http response code is 2XX

1.2.10 (2016-01-05)

  • Fixed #118: implemented usage lxml.etree.tostring within outer_html method

  • Fixed #117: Raise HTTP Error if HTTP status code is not equal to 200

  • Fixed #112: make_links_absolute does not apply to form actions

  • Fixed #98: contains act like jQuery

1.2.9 (2014-08-22)

  • Support for keyword arguments in PyQuery custom functions

  • Fixed #78: items must take care or the parent

  • Fixed #65 PyQuery.make_links_absolute() no longer creates ‘href’ attribute when it isn’t there

  • Fixed #19. is_() was broken.

  • Fixed #9. .replaceWith(PyQuery element) raises error

  • Remove official python3.2 support (mostly because of 3rd party semi-deps)

1.2.8 (2013-12-21)

  • Fixed #22: Open by filename fails when file contains invalid xml

  • Bug fix in .remove_class()

1.2.7 (2013-12-21)

  • Use pep8 name for methods but keep an alias for camel case method. Eg: remove_attr and removeAttr works Fix #57

  • .text() now return an empty string instead of None if there is no text node. Fix #45

  • Fixed #23: removeClass adds class attribute to elements which previously lacked one

1.2.6 (2013-10-11)

  • README_fixt.py was not include in the release. Fix #54.

1.2.5 (2013-10-10)

1.2.4

  • 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)

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 Distribution

pyquery-1.2.14.tar.gz (45.1 kB view details)

Uploaded Source

Built Distribution

pyquery-1.2.14-py2.py3-none-any.whl (22.3 kB view details)

Uploaded Python 2 Python 3

File details

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

File metadata

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

File hashes

Hashes for pyquery-1.2.14.tar.gz
Algorithm Hash digest
SHA256 71b6f243b70937f0f120f50982b8596e22749608f613bdeb68b1fa575fda34da
MD5 70fc5443ef71f03939d7f85a56744672
BLAKE2b-256 08a3c69a482601b459d4485ec8962515aea749e07874d8e451f4dbe2dec24f87

See more details on using hashes here.

Provenance

File details

Details for the file pyquery-1.2.14-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for pyquery-1.2.14-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4feaf6e4f5cdd1770e7bf6c31aed0244f9786f3c6846be6217d4f93cf6800945
MD5 fa3f4978d037b803461d9788ac59ef56
BLAKE2b-256 7124fee80004416b263ebad29067549403774152ed9145774657a5ccdce83e88

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