projects / config.git / blame
| Commit | Line | Data |
|---|---|---|
| 53e6db90 DC |
1 | Metadata-Version: 2.1 |
| 2 | Name: packaging | |
| 3 | Version: 23.2 | |
| 4 | Summary: Core utilities for Python packages | |
| 5 | Author-email: Donald Stufft <donald@stufft.io> | |
| 6 | Requires-Python: >=3.7 | |
| 7 | Description-Content-Type: text/x-rst | |
| 8 | Classifier: Development Status :: 5 - Production/Stable | |
| 9 | Classifier: Intended Audience :: Developers | |
| 10 | Classifier: License :: OSI Approved :: Apache Software License | |
| 11 | Classifier: License :: OSI Approved :: BSD License | |
| 12 | Classifier: Programming Language :: Python | |
| 13 | Classifier: Programming Language :: Python :: 3 | |
| 14 | Classifier: Programming Language :: Python :: 3 :: Only | |
| 15 | Classifier: Programming Language :: Python :: 3.7 | |
| 16 | Classifier: Programming Language :: Python :: 3.8 | |
| 17 | Classifier: Programming Language :: Python :: 3.9 | |
| 18 | Classifier: Programming Language :: Python :: 3.10 | |
| 19 | Classifier: Programming Language :: Python :: 3.11 | |
| 20 | Classifier: Programming Language :: Python :: 3.12 | |
| 21 | Classifier: Programming Language :: Python :: Implementation :: CPython | |
| 22 | Classifier: Programming Language :: Python :: Implementation :: PyPy | |
| 23 | Classifier: Typing :: Typed | |
| 24 | Project-URL: Documentation, https://packaging.pypa.io/ | |
| 25 | Project-URL: Source, https://github.com/pypa/packaging | |
| 26 | ||
| 27 | packaging | |
| 28 | ========= | |
| 29 | ||
| 30 | .. start-intro | |
| 31 | ||
| 32 | Reusable core utilities for various Python Packaging | |
| 33 | `interoperability specifications <https://packaging.python.org/specifications/>`_. | |
| 34 | ||
| 35 | This library provides utilities that implement the interoperability | |
| 36 | specifications which have clearly one correct behaviour (eg: :pep:`440`) | |
| 37 | or benefit greatly from having a single shared implementation (eg: :pep:`425`). | |
| 38 | ||
| 39 | .. end-intro | |
| 40 | ||
| 41 | The ``packaging`` project includes the following: version handling, specifiers, | |
| 42 | markers, requirements, tags, utilities. | |
| 43 | ||
| 44 | Documentation | |
| 45 | ------------- | |
| 46 | ||
| 47 | The `documentation`_ provides information and the API for the following: | |
| 48 | ||
| 49 | - Version Handling | |
| 50 | - Specifiers | |
| 51 | - Markers | |
| 52 | - Requirements | |
| 53 | - Tags | |
| 54 | - Utilities | |
| 55 | ||
| 56 | Installation | |
| 57 | ------------ | |
| 58 | ||
| 59 | Use ``pip`` to install these utilities:: | |
| 60 | ||
| 61 | pip install packaging | |
| 62 | ||
| 63 | The ``packaging`` library uses calendar-based versioning (``YY.N``). | |
| 64 | ||
| 65 | Discussion | |
| 66 | ---------- | |
| 67 | ||
| 68 | If you run into bugs, you can file them in our `issue tracker`_. | |
| 69 | ||
| 70 | You can also join ``#pypa`` on Freenode to ask questions or get involved. | |
| 71 | ||
| 72 | ||
| 73 | .. _`documentation`: https://packaging.pypa.io/ | |
| 74 | .. _`issue tracker`: https://github.com/pypa/packaging/issues | |
| 75 | ||
| 76 | ||
| 77 | Code of Conduct | |
| 78 | --------------- | |
| 79 | ||
| 80 | Everyone interacting in the packaging project's codebases, issue trackers, chat | |
| 81 | rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. | |
| 82 | ||
| 83 | .. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md | |
| 84 | ||
| 85 | Contributing | |
| 86 | ------------ | |
| 87 | ||
| 88 | The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as | |
| 89 | well as how to report a potential security issue. The documentation for this | |
| 90 | project also covers information about `project development`_ and `security`_. | |
| 91 | ||
| 92 | .. _`project development`: https://packaging.pypa.io/en/latest/development/ | |
| 93 | .. _`security`: https://packaging.pypa.io/en/latest/security/ | |
| 94 | ||
| 95 | Project History | |
| 96 | --------------- | |
| 97 | ||
| 98 | Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for | |
| 99 | recent changes and project history. | |
| 100 | ||
| 101 | .. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/ | |
| 102 |