| single |
pyquery: a jquery-like library for python
=========================================
pyquery allows you to make jquery queries on xml documents.
The API is as much as possible 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 developed on a git repository on Github. I
have the policy of giving push access to anyone who wants it and then
reviewing
what they do. So if you want to contribute just email me.
Please report bugs on the [github
] issue
tracker.
.. _deliverance:
http://www.gawel.org/weblog/en/2008/12/skinning-with-pyquery-and-deliverance
.. _project: https://github.com/gawel/pyquery/
..
>>> (urlopen, your_url, path_to_html_file) = getfixture('readme_fixt')
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("")
>>> d = pq(etree.fromstring(""))
>>> 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 = d("#hello")
>>> print(p.html())
Hello world !
>>> p.html("you know Python rocks")
[]
>>> print(p.html())
you know Python 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 http://pyquery.rtfd.org/ for the full documentation
News
====
2.0.1 (2024-08-30)
------------------
- Breaking change: its seems no longer possible to use the html parser with
a xml file so its no longer tested
- Drop support for python 3.7
2.0.0 (2022-12-28)
------------------
- Breaking change: inputs starting with ``"http://" or "https://" like
PyQuery("http://example.com")`` will no longer fetch the contents of the
URL.
Users desiring the old behavior should switch to
``PyQuery(url="http://example.com")``.
- Add nextUntil method
- ``.remove()`` no longer inserts a space in place of the removed element
- Fix escaping of top-level element text in ``.html()`` output
- Support (and require) cssselect 1.2+
- Drop support for python 3.5/3.6
|