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