Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: Replaced by packvers based on https://github.com/pypa/packaging/issues/530#issuecomment-1362652137

packaging2 is friendly fork of packaging to work around the drop for LegacyVersion support. See https://github.com/pypa/packaging/issues/530

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).

The packaging2 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 packaging2

Discussion

If you run into bugs, you can file them in our issue tracker.

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.

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 History

Please review the CHANGELOG.rst file or the Changelog documentation for recent changes and project history.

Changelog

21.4 - 2022-12-22

21.3 - 2021-11-17

  • Add a pp3-none-any tag (#311)

  • Replace the blank pyparsing 3 exclusion with a 3.0.5 exclusion (#481, #486)

  • Fix a spelling mistake (#479)

21.2 - 2021-10-29

  • Update documentation entry for 21.1.

21.1 - 2021-10-29

  • Update pin to pyparsing to exclude 3.0.0.

21.0 - 2021-07-03

  • PEP 656: musllinux support (#411)

  • Drop support for Python 2.7, Python 3.4 and Python 3.5.

  • Replace distutils usage with sysconfig (#396)

  • Add support for zip files in parse_sdist_filename (#429)

  • Use cached _hash attribute to short-circuit tag equality comparisons (#417)

  • Specify the default value for the specifier argument to SpecifierSet (#437)

  • Proper keyword-only “warn” argument in packaging.tags (#403)

  • Correctly remove prerelease suffixes from ~= check (#366)

  • Fix type hints for Version.post and Version.dev (#393)

  • Use typing alias UnparsedVersion (#398)

  • Improve type inference for packaging.specifiers.filter() (#430)

  • Tighten the return type of canonicalize_version() (#402)

20.9 - 2021-01-29

  • Run isort over the code base (#377)

  • Add support for the macosx_10_*_universal2 platform tags (#379)

  • Introduce packaging.utils.parse_wheel_filename() and parse_sdist_filename() (#387 and #389)

20.8 - 2020-12-11

  • Revert back to setuptools for compatibility purposes for some Linux distros (#363)

  • Do not insert an underscore in wheel tags when the interpreter version number is more than 2 digits (#372)

20.7 - 2020-11-28

No unreleased changes.

20.6 - 2020-11-28

  • Fix flit configuration, to include LICENSE files (#357)

  • Make intel a recognized CPU architecture for the universal macOS platform tag (#361)

  • Add some missing type hints to packaging.requirements (issue:350)

20.5 - 2020-11-27

  • Officially support Python 3.9 (#343)

  • Deprecate the LegacyVersion and LegacySpecifier classes (#321)

  • Handle OSError on non-dynamic executables when attempting to resolve the glibc version string.

20.4 - 2020-05-19

  • Canonicalize version before comparing specifiers. (#282)

  • Change type hint for canonicalize_name to return packaging.utils.NormalizedName. This enables the use of static typing tools (like mypy) to detect mixing of normalized and un-normalized names.

20.3 - 2020-03-05

  • Fix changelog for 20.2.

20.2 - 2020-03-05

  • Fix a bug that caused a 32-bit OS that runs on a 64-bit ARM CPU (e.g. ARM-v8, aarch64), to report the wrong bitness.

20.1 - 2020-01-24

  • Fix a bug caused by reuse of an exhausted iterator. (#257)

20.0 - 2020-01-06

  • Add type hints (#191)

  • Add proper trove classifiers for PyPy support (#198)

  • Scale back depending on ctypes for manylinux support detection (#171)

  • Use sys.implementation.name where appropriate for packaging.tags (#193)

  • Expand upon the API provided by packaging.tags: interpreter_name(), mac_platforms(), compatible_tags(), cpython_tags(), generic_tags() (#187)

  • Officially support Python 3.8 (#232)

  • Add major, minor, and micro aliases to packaging.version.Version (#226)

  • Properly mark packaging has being fully typed by adding a py.typed file (#226)

19.2 - 2019-09-18

  • Remove dependency on attrs (#178, #179)

  • Use appropriate fallbacks for CPython ABI tag (#181, #185)

  • Add manylinux2014 support (#186)

  • Improve ABI detection (#181)

  • Properly handle debug wheels for Python 3.8 (#172)

  • Improve detection of debug builds on Windows (#194)

19.1 - 2019-07-30

  • Add the packaging.tags module. (#156)

  • Correctly handle two-digit versions in python_version (#119)

19.0 - 2019-01-20

  • Fix string representation of PEP 508 direct URL requirements with markers.

  • Better handling of file URLs

    This allows for using file:///absolute/path, which was previously prevented due to the missing netloc.

    This allows for all file URLs that urlunparse turns back into the original URL to be valid.

18.0 - 2018-09-26

  • Improve error messages when invalid requirements are given. (#129)

17.1 - 2017-02-28

  • Fix utils.canonicalize_version when supplying non PEP 440 versions.

17.0 - 2017-02-28

  • Drop support for python 2.6, 3.2, and 3.3.

  • Define minimal pyparsing version to 2.0.2 (#91).

  • Add epoch, release, pre, dev, and post attributes to Version and LegacyVersion (#34).

  • Add Version().is_devrelease and LegacyVersion().is_devrelease to make it easy to determine if a release is a development release.

  • Add utils.canonicalize_version to canonicalize version strings or Version instances (#121).

16.8 - 2016-10-29

  • Fix markers that utilize in so that they render correctly.

  • Fix an erroneous test on Python RC releases.

16.7 - 2016-04-23

  • Add support for the deprecated python_implementation marker which was an undocumented setuptools marker in addition to the newer markers.

16.6 - 2016-03-29

  • Add support for the deprecated, PEP 345 environment markers in addition to the newer markers.

16.5 - 2016-02-26

  • Fix a regression in parsing requirements with whitespaces between the comma separators.

16.4 - 2016-02-22

  • Fix a regression in parsing requirements like foo (==4).

16.3 - 2016-02-21

  • Fix a bug where packaging.requirements:Requirement was overly strict when matching legacy requirements.

16.2 - 2016-02-09

  • Add a function that implements the name canonicalization from PEP 503.

16.1 - 2016-02-07

  • Implement requirement specifiers from PEP 508.

16.0 - 2016-01-19

  • Relicense so that packaging is available under either the Apache License, Version 2.0 or a 2 Clause BSD license.

  • Support installation of packaging when only distutils is available.

  • Fix == comparison when there is a prefix and a local version in play. (#41).

  • Implement environment markers from PEP 508.

15.3 - 2015-08-01

  • Normalize post-release spellings for rev/r prefixes. #35

15.2 - 2015-05-13

  • Fix an error where the arbitrary specifier (===) was not correctly allowing pre-releases when it was being used.

  • Expose the specifier and version parts through properties on the Specifier classes.

  • Allow iterating over the SpecifierSet to get access to all of the Specifier instances.

  • Allow testing if a version is contained within a specifier via the in operator.

15.1 - 2015-04-13

  • Fix a logic error that was causing inconsistent answers about whether or not a pre-release was contained within a SpecifierSet or not.

15.0 - 2015-01-02

  • Add Version().is_postrelease and LegacyVersion().is_postrelease to make it easy to determine if a release is a post release.

  • Add Version().base_version and LegacyVersion().base_version to make it easy to get the public version without any pre or post release markers.

  • Support the update to PEP 440 which removed the implied !=V.* when using either >V or <V and which instead special cased the handling of pre-releases, post-releases, and local versions when using >V or <V.

14.5 - 2014-12-17

  • Normalize release candidates as rc instead of c.

  • Expose the VERSION_PATTERN constant, a regular expression matching a valid version.

14.4 - 2014-12-15

  • Ensure that versions are normalized before comparison when used in a specifier with a less than (<) or greater than (>) operator.

14.3 - 2014-11-19

  • BACKWARDS INCOMPATIBLE Refactor specifier support so that it can sanely handle legacy specifiers as well as PEP 440 specifiers.

  • BACKWARDS INCOMPATIBLE Move the specifier support out of packaging.version into packaging.specifiers.

14.2 - 2014-09-10

  • Add prerelease support to Specifier.

  • Remove the ability to do item in Specifier() and replace it with Specifier().contains(item) in order to allow flags that signal if a prerelease should be accepted or not.

  • Add a method Specifier().filter() which will take an iterable and returns an iterable with items that do not match the specifier filtered out.

14.1 - 2014-09-08

  • Allow LegacyVersion and Version to be sorted together.

  • Add packaging.version.parse() to enable easily parsing a version string as either a Version or a LegacyVersion depending on it’s PEP 440 validity.

14.0 - 2014-09-05

  • Initial release.

Metadata

Release files for packaging2 21.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for packaging2 21.4
File Size Uploaded
packaging2-21.4.tar.gz 84.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for packaging2 21.4
File Interpreter ABI Platform
packaging2-21.4-py3-none-any.whl Python 3 none any Details

Total release size: 125.6 kB

Release files / packaging2-21.4.tar.gz

Download URL packaging2-21.4.tar.gz
Size 84.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f5decadff459242de7678dfcf62fc0dd5313d79d8a3dd7dbaaa7c6aefe67054c
BLAKE2b-256 checksum
How to use checksums
83ef75afb69cc546ad67181bca81b6aa68582835180742ec59f35dd276b52239
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.10

Release files / packaging2-21.4-py3-none-any.whl

Download URL packaging2-21.4-py3-none-any.whl
Size 40.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0e3c7ae9214ccde4d9752efb71e967933a8b60b48f8ffbab95b27aecf594bbcd
BLAKE2b-256 checksum
How to use checksums
306c849f5ea5a816ed80d887a7c9764240e3884828d5245e134b27b5195bd778
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.10

Release history Release notifications | RSS feed

This release

21.4 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page