]>
Commit | Line | Data |
---|---|---|
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 |