packaging

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, metadata, lockfiles, utilities.

Documentation

The documentation_ provides information and the API for the following:

• Version Handling
• Specifiers
• Markers
• Requirements
• Tags
• Metadata
• Lockfiles
• Utilities

Installation

Use pip to install these utilities::

pip install packaging

The packaging library uses calendar-based versioning (YY.N).

Discussion

If you run into bugs, you can file them in our issue tracker_.

You can also join discussions on GitHub Discussions_ to ask questions or get involved.

.. _documentation: https://packaging.pypa.io/ .. _issue tracker: https://github.com/pypa/packaging/issues .. _GitHub Discussions: https://github.com/pypa/packaging/discussions

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/