Skip to main content

Core utilities for Python packages

Project description

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 packaging 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 packaging

Discussion

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

You can also join #pypa on Freenode to ask questions or get involved.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

packaging-21.2.tar.gz (84.4 kB view hashes)

Uploaded Source

Built Distribution

packaging-21.2-py3-none-any.whl (40.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page