https://github.com/pypa/packaging

Core utilities for Python packages
https://github.com/pypa/packaging

Last synced: about 2 months ago
JSON representation

Core utilities for Python packages

• Host: GitHub
• URL: https://github.com/pypa/packaging
• Owner: pypa
• License: other
• Created: 2014-05-15T22:49:43.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2024-07-24T17:49:30.000Z (about 2 months ago)
• Last Synced: 2024-07-24T20:33:07.991Z (about 2 months ago)
• Language: Python
• Homepage: https://packaging.pypa.io/
• Size: 1.01 MB
• Stars: 601
• Watchers: 30
• Forks: 242
• Open Issues: 94
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

• best-of-python-dev - GitHub - 23% open · ⏱️ 20.05.2024): (Code Packaging)
• starred-awesome - packaging - Core utilities for Python packages (Python)
• jimsghstars - pypa/packaging - Core utilities for Python packages (Python)

README

        
packaging

=========

.. start-intro

Reusable core utilities for various Python Packaging

`interoperability 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

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 ``#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/