What is lxml?
=============

lxml is the most feature-rich and easy-to-use library for processing XML and HTML in the Python language.
It's also very fast and memory friendly, just so you know.

For an introduction and further documentation, see `doc/main.txt`_.

For installation information, see `INSTALL.txt`_.

For the issue tracker, see https://bugs.launchpad.net/lxml

Support the project
-------------------

lxml has been downloaded from the `Python Package Index`_
millions of times and is also available directly in many package
distributions, e.g. for Linux or macOS.

.. _`Python Package Index`: https://pypi.python.org/pypi/lxml

Most people who use lxml do so because they like using it.
You can show us that you like it by blogging about your experience
with it and linking to the project website.

If you are using lxml for your work and feel like giving a bit of
your own benefit back to support the project, consider sending us
money through GitHub Sponsors, Tidelift or PayPal that we can use
to buy us free time for the maintenance of this great library, to
fix bugs in the software, review and integrate code contributions,
to improve its features and documentation, or to just take a deep
breath and have a cup of tea every once in a while.
Please read the Legal Notice below, at the bottom of this page.
Thank you for your support.

.. class:: center

  Support lxml through `GitHub Sponsors <https://github.com/users/scoder/sponsorship>`_

  via a `Tidelift subscription <https://tidelift.com/subscription/pkg/pypi-lxml>`_

  or via PayPal:

  |Donate|_

.. _`Donate`: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=R56JE3VCPDA9N

Please `contact Stefan Behnel <http://consulting.behnel.de/>`_
for other ways to support the lxml project,
as well as commercial consulting, customisations and trainings on lxml and
fast Python XML processing.

Note that we are not accepting donations in crypto currencies.
Much of the development and hosting for lxml is done in a carbon-neutral way
or with compensated and very low emissions.
Crypto currencies do not fit into that ambition.

.. |Donate| image:: https://lxml.de/paypal_btn_donateCC_LG.png
            :width: 160
            :height: 47
            :alt: Donate to the lxml project

.. _`doc/main.txt`: https://github.com/lxml/lxml/blob/master/doc/main.txt
.. _`INSTALL.txt`: http://lxml.de/installation.html

`GitHub Actions <https://docs.github.com/en/actions>`_
supports the lxml project with their build and CI servers.


Project income report
---------------------

lxml has `well over 250 million downloads <https://pypistats.org/packages/lxml>`_
per month on PyPI.

* Total project income in 2025: EUR 3868.43  (322.37 € / month, 1.46 € / 1,000,000 downloads)

  - Tidelift: EUR 2642.35
  - thanks.dev: EUR 449.78
  - Paypal: EUR 388.15

* Total project income in 2024: EUR 3032.06  (252.57 € / month, 2.09 € / 1,000,000 downloads)

  - Tidelift: EUR 2777.34
  - thanks.dev: EUR 205.77
  - Paypal: EUR 48.95

* Total project income in 2023: EUR 2821,16  (235.09 € / month, 2.93 € / 1,000,000 downloads)

  - Tidelift: EUR 2738.46
  - thanks.dev: EUR 44.60
  - Paypal: EUR 38.10

* Total project income in 2022: EUR 2566.38  (213.87 € / month, 3.56 € / 1,000,000 downloads)

  - Tidelift: EUR 2539.38
  - Paypal: EUR 24.32

* Total project income in 2021: EUR 4640.37  (386.70 € / month)

  - Tidelift: EUR 4066.66
  - Paypal: EUR 223.71
  - other: EUR 350.00

* Total project income in 2020: EUR 6065,86  (506.49 € / month)

  - Tidelift: EUR 4064.77
  - Paypal: EUR 1401.09
  - other: EUR 600.00

* Total project income in 2019: EUR 717.52  (59.79 € / month)

  - Tidelift: EUR 360.30
  - Paypal: EUR 157.22
  - other: EUR 200.00


Legal Notice for Donations
--------------------------

Any donation that you make to the lxml project is voluntary and
is not a fee for any services, goods, or advantages.  By making
a donation to the lxml project, you acknowledge that we have the
right to use the money you donate in any lawful way and for any
lawful purpose we see fit and we are not obligated to disclose
the way and purpose to any party unless required by applicable
law.  Although lxml is free software, to the best of our knowledge
the lxml project does not have any tax exempt status.  The lxml
project is neither a registered non-profit corporation nor a
registered charity in any country.  Your donation may or may not
be tax-deductible; please consult your tax advisor in this matter.
We will not publish or disclose your name and/or e-mail address
without your consent, unless required by applicable law.  Your
donation is non-refundable.