METADATA 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419
  1. Metadata-Version: 2.1
  2. Name: packaging
  3. Version: 20.9
  4. Summary: Core utilities for Python packages
  5. Home-page: https://github.com/pypa/packaging
  6. Author: Donald Stufft and individual contributors
  7. Author-email: donald@stufft.io
  8. License: BSD-2-Clause or Apache-2.0
  9. Platform: UNKNOWN
  10. Classifier: Development Status :: 5 - Production/Stable
  11. Classifier: Intended Audience :: Developers
  12. Classifier: License :: OSI Approved :: Apache Software License
  13. Classifier: License :: OSI Approved :: BSD License
  14. Classifier: Programming Language :: Python
  15. Classifier: Programming Language :: Python :: 2
  16. Classifier: Programming Language :: Python :: 2.7
  17. Classifier: Programming Language :: Python :: 3
  18. Classifier: Programming Language :: Python :: 3.4
  19. Classifier: Programming Language :: Python :: 3.5
  20. Classifier: Programming Language :: Python :: 3.6
  21. Classifier: Programming Language :: Python :: 3.7
  22. Classifier: Programming Language :: Python :: 3.8
  23. Classifier: Programming Language :: Python :: 3.9
  24. Classifier: Programming Language :: Python :: Implementation :: CPython
  25. Classifier: Programming Language :: Python :: Implementation :: PyPy
  26. Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
  27. Description-Content-Type: text/x-rst
  28. Requires-Dist: pyparsing (>=2.0.2)
  29. packaging
  30. =========
  31. .. start-intro
  32. Reusable core utilities for various Python Packaging
  33. `interoperability specifications <https://packaging.python.org/specifications/>`_.
  34. This library provides utilities that implement the interoperability
  35. specifications which have clearly one correct behaviour (eg: :pep:`440`)
  36. or benefit greatly from having a single shared implementation (eg: :pep:`425`).
  37. .. end-intro
  38. The ``packaging`` project includes the following: version handling, specifiers,
  39. markers, requirements, tags, utilities.
  40. Documentation
  41. -------------
  42. The `documentation`_ provides information and the API for the following:
  43. - Version Handling
  44. - Specifiers
  45. - Markers
  46. - Requirements
  47. - Tags
  48. - Utilities
  49. Installation
  50. ------------
  51. Use ``pip`` to install these utilities::
  52. pip install packaging
  53. Discussion
  54. ----------
  55. If you run into bugs, you can file them in our `issue tracker`_.
  56. You can also join ``#pypa`` on Freenode to ask questions or get involved.
  57. .. _`documentation`: https://packaging.pypa.io/
  58. .. _`issue tracker`: https://github.com/pypa/packaging/issues
  59. Code of Conduct
  60. ---------------
  61. Everyone interacting in the packaging project's codebases, issue trackers, chat
  62. rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.
  63. .. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md
  64. Contributing
  65. ------------
  66. The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as
  67. well as how to report a potential security issue. The documentation for this
  68. project also covers information about `project development`_ and `security`_.
  69. .. _`project development`: https://packaging.pypa.io/en/latest/development/
  70. .. _`security`: https://packaging.pypa.io/en/latest/security/
  71. Project History
  72. ---------------
  73. Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for
  74. recent changes and project history.
  75. .. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/
  76. Changelog
  77. ---------
  78. 20.9 - 2021-01-29
  79. ~~~~~~~~~~~~~~~~~
  80. * Run [isort](https://pypi.org/project/isort/) over the code base (`#377 <https://github.com/pypa/packaging/issues/377>`__)
  81. * Add support for the ``macosx_10_*_universal2`` platform tags (`#379 <https://github.com/pypa/packaging/issues/379>`__)
  82. * Introduce ``packaging.utils.parse_wheel_filename()`` and ``parse_sdist_filename()``
  83. (`#387 <https://github.com/pypa/packaging/issues/387>`__ and `#389 <https://github.com/pypa/packaging/issues/389>`__)
  84. 20.8 - 2020-12-11
  85. ~~~~~~~~~~~~~~~~~
  86. * Revert back to setuptools for compatibility purposes for some Linux distros (`#363 <https://github.com/pypa/packaging/issues/363>`__)
  87. * Do not insert an underscore in wheel tags when the interpreter version number
  88. is more than 2 digits (`#372 <https://github.com/pypa/packaging/issues/372>`__)
  89. 20.7 - 2020-11-28
  90. ~~~~~~~~~~~~~~~~~
  91. No unreleased changes.
  92. 20.6 - 2020-11-28
  93. ~~~~~~~~~~~~~~~~~
  94. .. note:: This release was subsequently yanked, and these changes were included in 20.7.
  95. * Fix flit configuration, to include LICENSE files (`#357 <https://github.com/pypa/packaging/issues/357>`__)
  96. * Make `intel` a recognized CPU architecture for the `universal` macOS platform tag (`#361 <https://github.com/pypa/packaging/issues/361>`__)
  97. * Add some missing type hints to `packaging.requirements` (issue:`350`)
  98. 20.5 - 2020-11-27
  99. ~~~~~~~~~~~~~~~~~
  100. * Officially support Python 3.9 (`#343 <https://github.com/pypa/packaging/issues/343>`__)
  101. * Deprecate the ``LegacyVersion`` and ``LegacySpecifier`` classes (`#321 <https://github.com/pypa/packaging/issues/321>`__)
  102. * Handle ``OSError`` on non-dynamic executables when attempting to resolve
  103. the glibc version string.
  104. 20.4 - 2020-05-19
  105. ~~~~~~~~~~~~~~~~~
  106. * Canonicalize version before comparing specifiers. (`#282 <https://github.com/pypa/packaging/issues/282>`__)
  107. * Change type hint for ``canonicalize_name`` to return
  108. ``packaging.utils.NormalizedName``.
  109. This enables the use of static typing tools (like mypy) to detect mixing of
  110. normalized and un-normalized names.
  111. 20.3 - 2020-03-05
  112. ~~~~~~~~~~~~~~~~~
  113. * Fix changelog for 20.2.
  114. 20.2 - 2020-03-05
  115. ~~~~~~~~~~~~~~~~~
  116. * Fix a bug that caused a 32-bit OS that runs on a 64-bit ARM CPU (e.g. ARM-v8,
  117. aarch64), to report the wrong bitness.
  118. 20.1 - 2020-01-24
  119. ~~~~~~~~~~~~~~~~~~~
  120. * Fix a bug caused by reuse of an exhausted iterator. (`#257 <https://github.com/pypa/packaging/issues/257>`__)
  121. 20.0 - 2020-01-06
  122. ~~~~~~~~~~~~~~~~~
  123. * Add type hints (`#191 <https://github.com/pypa/packaging/issues/191>`__)
  124. * Add proper trove classifiers for PyPy support (`#198 <https://github.com/pypa/packaging/issues/198>`__)
  125. * Scale back depending on ``ctypes`` for manylinux support detection (`#171 <https://github.com/pypa/packaging/issues/171>`__)
  126. * Use ``sys.implementation.name`` where appropriate for ``packaging.tags`` (`#193 <https://github.com/pypa/packaging/issues/193>`__)
  127. * Expand upon the API provded by ``packaging.tags``: ``interpreter_name()``, ``mac_platforms()``, ``compatible_tags()``, ``cpython_tags()``, ``generic_tags()`` (`#187 <https://github.com/pypa/packaging/issues/187>`__)
  128. * Officially support Python 3.8 (`#232 <https://github.com/pypa/packaging/issues/232>`__)
  129. * Add ``major``, ``minor``, and ``micro`` aliases to ``packaging.version.Version`` (`#226 <https://github.com/pypa/packaging/issues/226>`__)
  130. * Properly mark ``packaging`` has being fully typed by adding a `py.typed` file (`#226 <https://github.com/pypa/packaging/issues/226>`__)
  131. 19.2 - 2019-09-18
  132. ~~~~~~~~~~~~~~~~~
  133. * Remove dependency on ``attrs`` (`#178 <https://github.com/pypa/packaging/issues/178>`__, `#179 <https://github.com/pypa/packaging/issues/179>`__)
  134. * Use appropriate fallbacks for CPython ABI tag (`#181 <https://github.com/pypa/packaging/issues/181>`__, `#185 <https://github.com/pypa/packaging/issues/185>`__)
  135. * Add manylinux2014 support (`#186 <https://github.com/pypa/packaging/issues/186>`__)
  136. * Improve ABI detection (`#181 <https://github.com/pypa/packaging/issues/181>`__)
  137. * Properly handle debug wheels for Python 3.8 (`#172 <https://github.com/pypa/packaging/issues/172>`__)
  138. * Improve detection of debug builds on Windows (`#194 <https://github.com/pypa/packaging/issues/194>`__)
  139. 19.1 - 2019-07-30
  140. ~~~~~~~~~~~~~~~~~
  141. * Add the ``packaging.tags`` module. (`#156 <https://github.com/pypa/packaging/issues/156>`__)
  142. * Correctly handle two-digit versions in ``python_version`` (`#119 <https://github.com/pypa/packaging/issues/119>`__)
  143. 19.0 - 2019-01-20
  144. ~~~~~~~~~~~~~~~~~
  145. * Fix string representation of PEP 508 direct URL requirements with markers.
  146. * Better handling of file URLs
  147. This allows for using ``file:///absolute/path``, which was previously
  148. prevented due to the missing ``netloc``.
  149. This allows for all file URLs that ``urlunparse`` turns back into the
  150. original URL to be valid.
  151. 18.0 - 2018-09-26
  152. ~~~~~~~~~~~~~~~~~
  153. * Improve error messages when invalid requirements are given. (`#129 <https://github.com/pypa/packaging/issues/129>`__)
  154. 17.1 - 2017-02-28
  155. ~~~~~~~~~~~~~~~~~
  156. * Fix ``utils.canonicalize_version`` when supplying non PEP 440 versions.
  157. 17.0 - 2017-02-28
  158. ~~~~~~~~~~~~~~~~~
  159. * Drop support for python 2.6, 3.2, and 3.3.
  160. * Define minimal pyparsing version to 2.0.2 (`#91 <https://github.com/pypa/packaging/issues/91>`__).
  161. * Add ``epoch``, ``release``, ``pre``, ``dev``, and ``post`` attributes to
  162. ``Version`` and ``LegacyVersion`` (`#34 <https://github.com/pypa/packaging/issues/34>`__).
  163. * Add ``Version().is_devrelease`` and ``LegacyVersion().is_devrelease`` to
  164. make it easy to determine if a release is a development release.
  165. * Add ``utils.canonicalize_version`` to canonicalize version strings or
  166. ``Version`` instances (`#121 <https://github.com/pypa/packaging/issues/121>`__).
  167. 16.8 - 2016-10-29
  168. ~~~~~~~~~~~~~~~~~
  169. * Fix markers that utilize ``in`` so that they render correctly.
  170. * Fix an erroneous test on Python RC releases.
  171. 16.7 - 2016-04-23
  172. ~~~~~~~~~~~~~~~~~
  173. * Add support for the deprecated ``python_implementation`` marker which was
  174. an undocumented setuptools marker in addition to the newer markers.
  175. 16.6 - 2016-03-29
  176. ~~~~~~~~~~~~~~~~~
  177. * Add support for the deprecated, PEP 345 environment markers in addition to
  178. the newer markers.
  179. 16.5 - 2016-02-26
  180. ~~~~~~~~~~~~~~~~~
  181. * Fix a regression in parsing requirements with whitespaces between the comma
  182. separators.
  183. 16.4 - 2016-02-22
  184. ~~~~~~~~~~~~~~~~~
  185. * Fix a regression in parsing requirements like ``foo (==4)``.
  186. 16.3 - 2016-02-21
  187. ~~~~~~~~~~~~~~~~~
  188. * Fix a bug where ``packaging.requirements:Requirement`` was overly strict when
  189. matching legacy requirements.
  190. 16.2 - 2016-02-09
  191. ~~~~~~~~~~~~~~~~~
  192. * Add a function that implements the name canonicalization from PEP 503.
  193. 16.1 - 2016-02-07
  194. ~~~~~~~~~~~~~~~~~
  195. * Implement requirement specifiers from PEP 508.
  196. 16.0 - 2016-01-19
  197. ~~~~~~~~~~~~~~~~~
  198. * Relicense so that packaging is available under *either* the Apache License,
  199. Version 2.0 or a 2 Clause BSD license.
  200. * Support installation of packaging when only distutils is available.
  201. * Fix ``==`` comparison when there is a prefix and a local version in play.
  202. (`#41 <https://github.com/pypa/packaging/issues/41>`__).
  203. * Implement environment markers from PEP 508.
  204. 15.3 - 2015-08-01
  205. ~~~~~~~~~~~~~~~~~
  206. * Normalize post-release spellings for rev/r prefixes. `#35 <https://github.com/pypa/packaging/issues/35>`__
  207. 15.2 - 2015-05-13
  208. ~~~~~~~~~~~~~~~~~
  209. * Fix an error where the arbitary specifier (``===``) was not correctly
  210. allowing pre-releases when it was being used.
  211. * Expose the specifier and version parts through properties on the
  212. ``Specifier`` classes.
  213. * Allow iterating over the ``SpecifierSet`` to get access to all of the
  214. ``Specifier`` instances.
  215. * Allow testing if a version is contained within a specifier via the ``in``
  216. operator.
  217. 15.1 - 2015-04-13
  218. ~~~~~~~~~~~~~~~~~
  219. * Fix a logic error that was causing inconsistent answers about whether or not
  220. a pre-release was contained within a ``SpecifierSet`` or not.
  221. 15.0 - 2015-01-02
  222. ~~~~~~~~~~~~~~~~~
  223. * Add ``Version().is_postrelease`` and ``LegacyVersion().is_postrelease`` to
  224. make it easy to determine if a release is a post release.
  225. * Add ``Version().base_version`` and ``LegacyVersion().base_version`` to make
  226. it easy to get the public version without any pre or post release markers.
  227. * Support the update to PEP 440 which removed the implied ``!=V.*`` when using
  228. either ``>V`` or ``<V`` and which instead special cased the handling of
  229. pre-releases, post-releases, and local versions when using ``>V`` or ``<V``.
  230. 14.5 - 2014-12-17
  231. ~~~~~~~~~~~~~~~~~
  232. * Normalize release candidates as ``rc`` instead of ``c``.
  233. * Expose the ``VERSION_PATTERN`` constant, a regular expression matching
  234. a valid version.
  235. 14.4 - 2014-12-15
  236. ~~~~~~~~~~~~~~~~~
  237. * Ensure that versions are normalized before comparison when used in a
  238. specifier with a less than (``<``) or greater than (``>``) operator.
  239. 14.3 - 2014-11-19
  240. ~~~~~~~~~~~~~~~~~
  241. * **BACKWARDS INCOMPATIBLE** Refactor specifier support so that it can sanely
  242. handle legacy specifiers as well as PEP 440 specifiers.
  243. * **BACKWARDS INCOMPATIBLE** Move the specifier support out of
  244. ``packaging.version`` into ``packaging.specifiers``.
  245. 14.2 - 2014-09-10
  246. ~~~~~~~~~~~~~~~~~
  247. * Add prerelease support to ``Specifier``.
  248. * Remove the ability to do ``item in Specifier()`` and replace it with
  249. ``Specifier().contains(item)`` in order to allow flags that signal if a
  250. prerelease should be accepted or not.
  251. * Add a method ``Specifier().filter()`` which will take an iterable and returns
  252. an iterable with items that do not match the specifier filtered out.
  253. 14.1 - 2014-09-08
  254. ~~~~~~~~~~~~~~~~~
  255. * Allow ``LegacyVersion`` and ``Version`` to be sorted together.
  256. * Add ``packaging.version.parse()`` to enable easily parsing a version string
  257. as either a ``Version`` or a ``LegacyVersion`` depending on it's PEP 440
  258. validity.
  259. 14.0 - 2014-09-05
  260. ~~~~~~~~~~~~~~~~~
  261. * Initial release.
  262. .. _`master`: https://github.com/pypa/packaging/