packaging

=========

.. start-intro

Reusable core utilities for various Python Packaging

`interoperability specifications <https://packaging.python.org/specifications/>`_.

This library provides utilities that implement the interoperability

specifications which have clearly one correct behaviour (eg: :pep:`440`)

or benefit greatly from having a single shared implementation (eg: :pep:`425`).

.. end-intro

The ``packaging`` project includes the following: version handling, specifiers,

markers, requirements, tags, utilities.

Documentation

-------------

The `documentation`_ provides information and the API for the following:

- Version Handling

- Specifiers

- Markers

- Requirements

- Tags

- Utilities

Installation

------------

Use ``pip`` to install these utilities::

pip install packaging

Discussion

----------

If you run into bugs, you can file them in our `issue tracker`_.

You can also join ``#pypa`` on Freenode to ask questions or get involved.

.. _`documentation`: https://packaging.pypa.io/

.. _`issue tracker`: https://github.com/pypa/packaging/issues

Code of Conduct

---------------

Everyone interacting in the packaging project's codebases, issue trackers, chat

rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.

.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md

Contributing

------------

The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as

well as how to report a potential security issue. The documentation for this

project also covers information about `project development`_ and `security`_.

.. _`project development`: https://packaging.pypa.io/en/latest/development/

.. _`security`: https://packaging.pypa.io/en/latest/security/

Project History

---------------

Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for

recent changes and project history.

.. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/