Metadata-Version: 2.1 Name: pyquery Version: 2.0.0 Summary: A jquery-like library for python Home-page: https://github.com/gawel/pyquery Author: Olivier Lauzanne Author-email: olauzanne@gmail.com Maintainer: Gael Pasgrimaud Maintainer-email: gael@gawel.org License: BSD Keywords: jquery html xml scraping Platform: UNKNOWN Classifier: Intended Audience :: Developers Classifier: Development Status :: 5 - Production/Stable Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.9 Classifier: Programming Language :: Python :: 3.10 License-File: LICENSE.txt Requires-Dist: lxml (>=2.1) Requires-Dist: cssselect (>=1.2.0) Provides-Extra: test Requires-Dist: requests ; extra == 'test' Requires-Dist: webob ; extra == 'test' Requires-Dist: webtest ; extra == 'test' Requires-Dist: pytest ; extra == 'test' Requires-Dist: pytest-cov ; extra == 'test' pyquery: a jquery-like library for python ========================================= .. image:: https://travis-ci.org/gawel/pyquery.svg :alt: Build Status :target: https://travis-ci.org/gawel/pyquery 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/ I've spent hours maintaining this software, with love. Please consider tipping if you like it: BTC: 1PruQAwByDndFZ7vTeJhyWefAghaZx9RZg ETH: 0xb6418036d8E06c60C4D91c17d72Df6e1e5b15CE6 LTC: LY6CdZcDbxnBX9GFBJ45TqVj8NykBBqsmT .. >>> (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.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 1.4.3 (2020-11-21) ------------------ - No longer use a universal wheel 1.4.2 (2020-11-21) ------------------ - Fix exception raised when calling `PyQuery("").text()` - python2 is no longer supported 1.4.1 (2019-10-26) ------------------ - This is the latest release with py2 support - Remove py33, py34 support - web scraping improvements: default timeout and session support - Add API methods to serialize form-related elements according to spec - Include HTML markup when querying textarea text/value 1.4.0 (2018-01-11) ------------------ - Refactoring of `.text()` to match firefox behavior. 1.3.0 (2017-10-21) ------------------ - Remove some unmaintained modules: ``pyquery.ajax`` and ``pyquery.rules`` - Code cleanup. No longer use ugly hacks required by python2.6/python3.2. - Run tests with python3.6 on CI - Add a ``method`` argument to ``.outer_html()`` 1.2.17 (2016-10-14) ------------------- - ``PyQuery('').val()`` is ``''`` - ``PyQuery('').val()`` is ``''`` 1.2.16 (2016-10-14) ------------------- - ``.attr('value', '')`` no longer removes the ``value`` attribute - ```` without ``value="..."`` have a ``.val()`` of ``'on'`` - ```` without ``value="..."`` have a ``.val()`` of ``'on'`` - ``