.. raw:: html

    <div class=section>

.. image:: images/pycairo.svg
   :align: center
   :width: 370px

|
|

.. toctree::
   :maxdepth: 1
   :titlesonly:
   :hidden:

   getting_started
   changelog
   Tutorial <tutorial>
   reference/index
   pycairo_c_api
   resources
   faq

.. currentmodule:: cairo
.. title:: Overview

.. include:: ../README.rst
    :start-after: |

----

PyPI:
    https://pypi.org/project/pycairo
Tarballs:
    https://github.com/pygobject/pycairo/releases
Git repo:
    https://github.com/pygobject/pycairo
Bug tracker:
    https://github.com/pygobject/pycairo/issues
Mailing list:
    https://lists.cairographics.org/cgi-bin/mailman/listinfo/cairo

See the ":ref:`reference_index`" for further details.

To use the pycairo library::

    import cairo

To build/install the library::

    python3 setup.py build
    python3 setup.py install

To run the tests::

    python3 setup.py test

For examples of pycairo code see the 'examples' directory that comes with the
pycairo distribution.

For author information see the git history as well as the now deleted
"ChangeLog" file in the git history.
