Metadata-Version: 2.2
Name: python-debian
Version: 1.0.1
Summary: Modules to read and manipulate many file formats related to Debian packages and repositories
Author-email: Debian python-debian Maintainers <pkg-python-debian-maint@lists.alioth.debian.org>
License: GPL-2.0-or-later
Project-URL: homepage, https://salsa.debian.org/python-debian-team/python-debian
Keywords: debian,linux,metadata,packages,packaging
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python
Classifier: Intended Audience :: Developers
Classifier: License :: DFSG approved
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Operating System :: POSIX
Requires-Python: >=3.7
Description-Content-Type: text/x-rst
Requires-Dist: charset-normalizer
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"

The `debian` Python modules work with Debian-related data formats,
providing a means to read data from files involved in Debian packaging,
and the distribution of Debian packages. The ability to create or edit
the files is also available for some formats.

Currently supported are:

  * Debtags information (`debian.debtags` module)
  * debian/changelog (`debian.changelog` module)
  * Packages files, pdiffs (`debian.debian_support` module)
  * Control files of single or multiple RFC822-style paragraphs, e.g.
    debian/control, .changes, .dsc, Packages, Sources, Release, etc.
    (`debian.deb822` module)
  * Raw .deb and .ar files, with (read-only) access to contained
    files and meta-information (`debian.debfile` module)

`API documentation`_, can be found online and throughout the code. There
are examples both within the code and in the examples_ directory.

.. _API documentation: https://python-debian-team.pages.debian.net/python-debian/html/

.. _examples: https://salsa.debian.org/python-debian-team/python-debian/tree/master/examples

Note that some modules can use `python-apt`_ to speed up processing.

.. _python-apt: https://packages.debian.org/unstable/python3-apt


Contributions to `python-debian` are most welcome, including expansion of the
module's capabilities. If you have a module that is for manipulation or
interrogation of Debian specific data then consider adding it to this package.
Please discuss your ideas on the `mailing list`_,
make merge requests via the `salsa repository`_,
and see the Contributing section of the documentation.

.. _mailing list: mailto:pkg-python-debian-maint@lists.alioth.debian.org

.. _salsa repository: https://salsa.debian.org/python-debian-team/python-debian