Skip to content

CHANGES.rst

Latest commit

 

History

History
524 lines (301 loc) · 12.1 KB

CHANGES.rst

File metadata and controls

524 lines (301 loc) · 12.1 KB

Changelog

v1.8.0

(2025-10-05)

Contributor-facing changes

v1.7.0

(2025-06-09)

Features

Packaging updates and notes for downstreams

  • Fixed an issue where frozenlist binary wheels would be built with debugging symbols and line tracing enabled, which significantly impacted performance. Line tracing is now disabled by default and can only be enabled explicitly -- by :user:`bdraco`.

    This change ensures that production builds are optimized for performance. Developers who need line tracing for debugging purposes can still enable it by:

    1. Setting the FROZENLIST_CYTHON_TRACING environment variable
    2. Using the --config-setting=with-cython-tracing=true option with pip

    Related issues and pull requests on GitHub: :issue:`660`.

  • Enabled PIP_CONSTRAINT environment variable in the build configuration to ensure the pinned Cython version from requirements/cython.txt is used during wheel builds.

    Related issues and pull requests on GitHub: :issue:`661`.

v1.6.2

(2025-06-03)

No significant changes.

v1.6.1

(2025-06-02)

Bug fixes

Packaging updates and notes for downstreams

v1.6.0

(2025-04-17)

Bug fixes

Features

Packaging updates and notes for downstreams

Contributor-facing changes

  • GitHub Actions CI/CD is now configured to manage caching pip-ecosystem dependencies using re-actors/cache-python-deps -- an action by :user:`webknjaz` that takes into account ABI stability and the exact version of Python runtime.

    Related issues and pull requests on GitHub: :issue:`633`.

  • Organized dependencies into test and lint dependencies so that no unnecessary ones are installed during CI runs -- by :user:`lysnikolaou`.

    Related issues and pull requests on GitHub: :issue:`636`.

1.5.0 (2024-10-22)

Bug fixes

  • An incorrect signature of the __class_getitem__ class method has been fixed, adding a missing class_item argument under Python 3.8 and older.

    This change also improves the code coverage of this method that was previously missing -- by :user:`webknjaz`.

    Related issues and pull requests on GitHub: :issue:`567`, :issue:`571`.

Improved documentation

Packaging updates and notes for downstreams

  • A name of a temporary building directory now reflects that it's related to frozenlist, not yarl.

    Related issues and pull requests on GitHub: :issue:`573`.

  • Declared Python 3.13 supported officially in the distribution package metadata.

    Related issues and pull requests on GitHub: :issue:`595`.

1.4.1 (2023-12-15)

Packaging updates and notes for downstreams

  • Declared Python 3.12 and PyPy 3.8-3.10 supported officially in the distribution package metadata.

    Related issues and pull requests on GitHub: :issue:`553`.

  • Replaced the packaging is replaced from an old-fashioned :file:`setup.py` to an in-tree PEP 517 build backend -- by :user:`webknjaz`.

    Whenever the end-users or downstream packagers need to build frozenlist from source (a Git checkout or an sdist), they may pass a config_settings flag pure-python. If this flag is not set, a C-extension will be built and included into the distribution.

    Here is how this can be done with pip:

    $ python3 -m pip install . --config-settings=pure-python=

    This will also work with -e | --editable.

    The same can be achieved via pypa/build:

    $ python3 -m build --config-setting=pure-python=

    Adding -w | --wheel can force pypa/build produce a wheel from source directly, as opposed to building an sdist and then building from it.

    Related issues and pull requests on GitHub: :issue:`560`.

Contributor-facing changes

  • It is now possible to request line tracing in Cython builds using the with-cython-tracing PEP 517 config setting -- :user:`webknjaz`.

    This can be used in CI and development environment to measure coverage on Cython modules, but is not normally useful to the end-users or downstream packagers.

    Here's a usage example:

    $ python3 -Im pip install . --config-settings=with-cython-tracing=true

    For editable installs, this setting is on by default. Otherwise, it's off unless requested explicitly.

    The following produces C-files required for the Cython coverage plugin to map the measurements back to the PYX-files:

    $ python -Im pip install -e .

    Alternatively, the FROZENLIST_CYTHON_TRACING=1 environment variable can be set to do the same as the PEP 517 config setting.

    Related issues and pull requests on GitHub: :issue:`560`.

  • Coverage collection has been implemented for the Cython modules -- by :user:`webknjaz`.

    It will also be reported to Codecov from any non-release CI jobs.

    Related issues and pull requests on GitHub: :issue:`561`.

  • A step-by-step :doc:`Release Guide <contributing/release_guide>` guide has been added, describing how to release frozenlist -- by :user:`webknjaz`.

    This is primarily targeting the maintainers.

    Related issues and pull requests on GitHub: :issue:`563`.

  • Detailed :doc:`Contributing Guidelines <contributing/guidelines>` on authoring the changelog fragments have been published in the documentation -- by :user:`webknjaz`.

    Related issues and pull requests on GitHub: :issue:`564`.

1.4.0 (2023-07-12)

The published source distribution package became buildable under Python 3.12.

Bugfixes

Deprecations and Removals

  • Dropped Python 3.7 support. #413

Misc

1.3.3 (2022-11-08)

  • Fixed CI runs when creating a new release, where new towncrier versions fail when the current version section is already present.

1.3.2 (2022-11-08)

Misc

  • Updated the CI runs to better check for test results and to avoid deprecated syntax. #327

1.3.1 (2022-08-02)

The published source distribution package became buildable under Python 3.11.

1.3.0 (2022-01-18)

Bugfixes

  • Do not install C sources with binary distributions. #250

Deprecations and Removals

  • Dropped Python 3.6 support #274

1.2.0 (2021-10-16)

Features

  • FrozenList now supports being used as a generic type as per PEP 585, e.g. frozen_int_list: FrozenList[int] (requires Python 3.9 or newer). #172
  • Added support for Python 3.10. #227
  • Started shipping platform-specific wheels with the musl tag targeting typical Alpine Linux runtimes. #227
  • Started shipping platform-specific arm64 wheels for Apple Silicon. #227

1.1.1 (2020-11-14)

Bugfixes

  • Provide x86 Windows wheels. #169

1.1.0 (2020-10-13)

Features

  • Add support for hashing of a frozen list. #136
  • Support Python 3.8 and 3.9.
  • Provide wheels for aarch64, i686, ppc64le, s390x architectures on Linux as well as x86_64.

1.0.0 (2019-11-09)

Deprecations and Removals

  • Dropped support for Python 3.5; only 3.6, 3.7 and 3.8 are supported going forward. #24