CHANGELOG.rst

Changelog

unreleased

No unreleased changes.

24.0 - 2024-03-10

• Do specifier matching correctly when the specifier contains an epoch number and has more components than the version (683)
• Support the experimental --disable-gil builds in packaging.tags (727)
• BREAKING: Make optional metadata.Metadata attributes default to None (733)
• Fix errors when trying to access the description_content_type, keywords, and requires_python attributes on metadata.Metadata when those values have not been provided (733)
• Fix a bug preventing the use of the built in ExceptionGroup on versions of Python that support it (725)

23.2 - 2023-10-01

• Document calendar-based versioning scheme (716)
• Enforce that the entire marker string is parsed (687)
• Requirement parsing no longer automatically validates the URL (120)
• Canonicalize names for requirements comparison (644)
• Introduce metadata.Metadata (along with metadata.ExceptionGroup and metadata.InvalidMetadata; 570)
• Introduce the validate keyword parameter to utils.normalize_name() (570)
• Introduce utils.is_normalized_name() (570)
• Make utils.parse_sdist_filename() and utils.parse_wheel_filename() raise InvalidSdistFilename and InvalidWheelFilename, respectively, when the version component of the name is invalid

23.1 - 2023-04-12

• Parse raw metadata (671)
• Import underlying parser functions as an underscored variable (663)
• Improve error for local version label with unsupported operators (675)
• Add dedicated error for specifiers with incorrect .* suffix
• Replace spaces in platform names with underscores (620)
• Relax typing of _key on _BaseVersion (669)
• Handle prefix match with zeros at end of prefix correctly (674)

23.0 - 2023-01-08

• Allow "extra" to be None in the marker environment (650)
• Refactor tags._generic_api to use EXT_SUFFIX (607)
• Correctly handle trailing whitespace on URL requirements (642)
• Fix typing for specifiers.BaseSpecifier.filter() (643)
• Use stable Python 3.11 in tests (641)
• Correctly handle non-normalised specifiers in requirements (634)
• Move to src/ layout (626)
• Remove __about__ file, in favour of keeping constants in __init__ (626)

22.0 - 2022-12-07

• Explicitly declare support for Python 3.11 (587)
• Remove support for Python 3.6 (500)
• Remove LegacySpecifier and LegacyVersion (407)
• Add __hash__ and __eq__ to Requirement (499)
• Add a cpNNN-none-any tag (541)
• Adhere to 685 when evaluating markers with extras (545)
• Allow accepting locally installed prereleases with SpecifierSet (515)
• Allow pre-release versions in marker evaluation (523)
• Correctly parse ELF for musllinux on Big Endian (538)
• Document packaging.utils.NormalizedName (565)
• Document exceptions raised by functions in packaging.utils (544)
• Fix compatible version specifier incorrectly strip trailing 0 (493)
• Fix macOS platform tags with old macOS SDK (513)
• Forbid prefix version matching on pre-release/post-release segments (563)
• Normalize specifier version for prefix matching (561)
• Improve documentation for packaging.specifiers and packaging.version. (572)
• Marker.evaluate will now assume evaluation environment with empty extra. Evaluating markers like "extra == 'xyz'" without passing any extra in the environment will no longer raise an exception (550)
• Remove dependency on pyparsing, by replacing it with a hand-written parser. This package now has no runtime dependencies (468)
• Update return type hint for Specifier.filter and SpecifierSet.filter to use Iterator instead of Iterable (584)

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

Note

This release was subsequently yanked, and these changes were included in 20.7.

• 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 (225)
• 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.