#################### 1.5.1 (2026-07-09) #################### ********** Features ********** - Add ``--report=PATH`` to write a machine-readable JSON report of built artifacts; ``--metadata`` now also accepts ``.whl`` files - by :user:`gaborbernat` (:issue:`198`) - The ``srcdir`` argument now accepts ``.tar.gz`` source distributions, extracting and building from them - by :user:`gaborbernat` (:issue:`311`) - The "Unmet dependencies" error from ``--no-isolation`` builds now shows the wanted version, found version, and interpreter - by :user:`gaborbernat` (:issue:`504`) - Add ``--sdist-extract-dir`` to extract the intermediate sdist into a persistent directory, enabling compiler cache reuse across rebuilds - by :user:`gaborbernat` (:issue:`614`) - Add ``--env-dir`` to place the isolated build environment at a fixed path, enabling compiler cache reuse across builds - by :user:`gaborbernat` (:issue:`655`) - Print a summary of resolved dependency versions (``name==version``) after installing them in isolated builds - by :user:`gaborbernat` (:issue:`959`) - On build failure, print a tip pointing to ``--env-dir`` and ``--sdist-extract-dir`` for debugging and link to the "Debug a failed build" how-to - reported by :user:`dimpase`, implemented by :user:`gaborbernat` (:issue:`966`) ********** Bugfixes ********** - Drain verbose subprocess output inline instead of using a ``ThreadPoolExecutor``, which silently swallowed logging errors - by :user:`henryiii` (:issue:`1098`) - Reject a file passed as ``--env-dir`` with a clear error instead of a raw ``FileExistsError`` - by :user:`henryiii` (:issue:`1100`) - Emit CLI warnings to stderr instead of stdout, so they no longer corrupt ``--metadata`` JSON output on stdout - by :user:`ymyzk` (:issue:`1111`) - Fix the Windows symlink support probe always returning ``False`` due to a stale object interpolated into the destination path - by :user:`henryiii` (:issue:`1118`) - Fix ``metadata_path``'s build-backend fallback returning a nonexistent dist-info path for wheels with a build tag - by :user:`henryiii` (:issue:`1119`) - Write pip/uv requirements and constraints files with ``\n`` instead of ``os.linesep``, avoiding doubled ``\r\r\n`` line endings on Windows - by :user:`henryiii` (:issue:`1120`) - Batch of small robustness fixes: correct macOS release parsing for the minimum pip version, avoid sharing the mutable default build-system table between builders, keep the original error when isolated-environment setup fails early, and raise ``BuildException`` for an invalid wheel - by :user:`henryiii` (:issue:`1121`) - Decide color support independently for stdout and stderr instead of only checking ``stdout.isatty()``, so redirecting one stream no longer disables or leaks ANSI colors on the other - by :user:`henryiii` (:issue:`1123`) *************************** Deprecations and Removals *************************** - Deprecate :func:`build.util.project_wheel_metadata`; use ``python -m build --metadata`` instead - by :user:`gaborbernat` (:issue:`557`) - Warn on config settings without a value (e.g. ``-C--my-flag``); use ``-C--my-flag=`` instead for compatibility with pip - by :user:`gaborbernat` (:issue:`640`) *************** Miscellaneous *************** - :issue:`1058`, :issue:`1060`, :issue:`1062`, :issue:`1093`, :issue:`1099`, :issue:`1107`, :issue:`1113`, :issue:`1117`, :issue:`1122`, :issue:`1124`, :issue:`1128` #################### 1.5.0 (2026-04-30) #################### ********** Features ********** - Drop Python 3.9 support - by :user:`henryiii` (:issue:`1036`) ********** Bugfixes ********** - Make ``--ignore-installed`` opt-in from the API via ``fresh=True`` - by :user:`henryiii` (:issue:`1056`) *************** Miscellaneous *************** - :issue:`1033` #################### 1.4.4 (2026-04-22) #################### ********** Bugfixes ********** - Fix release pipeline generating ``CHANGELOG.rst`` entries with inconsistent heading levels, which broke ``sphinx -W`` and pinned Read the Docs ``stable`` at 1.4.0 - by :user:`gaborbernat`. (:issue:`1031`) - Revert :pr:`1039` from build 1.4.3, no longer check direct_url (for now) - by :user:`henryiii` (:issue:`1039`) - Add ``--ignore-installed`` to pip install command to prevent issues with packages already present in the isolated build environment - by :user:`henryiii` (:issue:`1037`) (:issue:`1040`) - Partial revert of :pr:`973`, keeping log messages in one entry, multiple lines. (:issue:`1044`) *************** Miscellaneous *************** - :issue:`1048`, :issue:`1049` #################### 1.4.3 (2026-04-10) #################### ********** Features ********** - Add ``kind`` parameter to log messages to separate semantic and representation - by :user:`abitrolly` (:issue:`973`) ********** Bugfixes ********** - Strip ``PYTHONPATH`` from the environment during isolated builds to prevent host packages from leaking into the build - by :user:`gaborbernat` (:issue:`405`) - Pass ``--no-input`` to pip to prevent hidden credential prompts that cause hangs, and automatically set ``PIP_KEYRING_PROVIDER=subprocess`` (or ``UV_KEYRING_PROVIDER=subprocess`` for the uv installer) when the ``keyring`` CLI is on ``PATH`` -- by :user:`gaborbernat` (:issue:`409`) - ``check_dependency`` now reports URL requirements as unmet instead of silently accepting them when a package with the same name is installed - by :user:`gaborbernat` (:issue:`860`) - Fix misleading missing dependency error display where transitive dependency chains showed the top-level package on a separate line, making it appear as if the top-level package itself was missing - by :user:`gaborbernat` (:issue:`875`) - Fix towncrier template to generate changelog categories in definition order - by :user:`gaborbernat` (:issue:`1007`) - Resolve thread-safety races in the build API - by :user:`gaborbernat` (:issue:`1015`) - Validate ``backend-path`` entries exist on disk with a clear error - by :user:`gaborbernat` (:issue:`1016`) *************** Miscellaneous *************** - :issue:`1020`, :issue:`1021` #################### 1.4.2 (2026-03-25) #################### ********** Bugfixes ********** - Ensure the ``uv`` installer uses the current version of Python, avoiding an issue if ``UV_PYTHON`` is set, for example. (:issue:`977`) - Fix ``_has_valid_outer_pip`` returning ``True`` when pip is missing, causing build to try using a non-existent pip instead of falling back to virtualenv. (:issue:`1003`) #################### 1.4.1 (2026-03-24) #################### ********** Features ********** - Allow setting build constraints - by :user:`gaborbernat` (:issue:`963`) - Automate releases with pre-release workflow and trusted publishing - by :user:`gaborbernat` (:issue:`991`) ********** Bugfixes ********** - Fix pip hack workaround - by :user:`gaborbernat` (:issue:`980`) *************** Documentation *************** - Fix documentation grammar and typos (:issue:`979`) - Reorganize documentation using Diataxis framework - by :user:`gaborbernat` (:issue:`988`) - Document release process and workflow security practices in contributing guide (:issue:`991`) *************** Miscellaneous *************** - :issue:`991` #################### 1.4.0 (2026-01-08) #################### - Add ``--quiet`` flag (:pr:`947`) - Add option to dump PEP 517 metadata with ``--metadata`` (:pr:`940`, :pr:`943`) - Support ``UV`` environment variable (:pr:`971`) - Remove a workaround for 3.14b1 (:pr:`960`) - In 3.14 final release, ``color`` defaults to ``True`` already (:pr:`962`) - Pass sp-repo-review (:pr:`942`) - In pytest configuration, ``log_level`` is better than ``log_cli_level`` (:pr:`950`) - Split up typing and mypy (:pr:`944`) - Use ``types-colorama`` (:pr:`945`) - In docs, first argument for ``_has_dependency`` is a name (PR :pr:`970`) - Fix test failure when ``flit-core`` is installed (PR :pr:`921`) #################### 1.3.0 (2025-08-01) #################### - Add ``--config-json`` (PR :pr:`916`, fixes issue :issue:`900`) - Drop Python 3.8 (PR :pr:`891`) - Test on Python 3.14, colorful help on 3.14+ (PR :pr:`895`) - Fix ``ModuleNotFoundError`` when ``pip`` is not installed (PR :pr:`898`) - Disable use of ``pip install --python`` for debundled pip (PR :pr:`861`) - Don't pass no-wheel to virtualenv if it would warn (PR :pr:`892`) - Optimize our tests to run faster (PR :pr:`871`, :pr:`872`, :pr:`738`) - Allow running our tests without virtualenv (PR :pr:`911`) - Fix issues in our tests (PR :pr:`824`, :pr:`918`, :pr:`870`, :pr:`915`, :pr:`862`, :pr:`863`, :pr:`899`, :pr:`896`, :pr:`854`) - Use SPDX identifiers for our license metadata (PR :pr:`914`) - Use dependency-groups for our development (PR :pr:`880`) - Mention conda and update uv mention in README/docs (PR :pr:`842`, :pr:`816`, :pr:`917`) #################### 1.2.2 (2024-09-06) #################### - Add editable to ``builder.get_requires_for_build``'s static types (PR :pr:`764`, fixes issue :issue:`763`) - Include artifact attestations in our release (PR :pr:`782`) - Fix typing compatibility with typed ``pyproject-hooks`` (PR :pr:`788`) - Mark more tests with ``network`` (PR :pr:`808`) - Add more intersphinx links to docs (PR :pr:`804`) - Make ``uv`` optional for tests (PR :pr:`807` and :pr:`813`) #################### 1.2.1 (2024-03-28) #################### - Avoid error when terminal width is undetectable on Python < 3.11 (PR :pr:`761`) #################### 1.2.0 (2024-03-27) #################### - Add ``--installer`` option, supporting ``pip`` and ``uv``. Added ``uv`` extra. (PR :pr:`751`) - Improve console output and provide ``-v`` for dependency installation (PR :pr:`749`) - Avoid compiling unused bytecode when using ``pip`` (PR :pr:`752`) - Dropped support for Python 3.7 (PR :pr:`743`) #################### 1.1.1 (2024-02-29) #################### - Fixed invoking outer pip from user site packages (PR :pr:`746`, fixes issue :issue:`745`) - Corrected the minimum pip version required to use an outer pip (PR :pr:`746`, fixes issue :issue:`745`) #################### 1.1.0 (2024-02-29) #################### - Use external pip if available instead of installing, speeds up environment setup with virtualenv slightly and venv significantly. (PR :pr:`736`) - Stopped injecting ``wheel`` as a build dependency automatically, in the case of missing ``pyproject.toml`` -- by :user:`webknjaz`. (PR :pr:`716`) - Use ``importlib_metadata`` on Python <3.10.2 for bugfixes not present in those CPython standard libraries (not required when bootstrapping) -- by :user:`GianlucaFicarelli`. (PR :pr:`693`, fixes issue :issue:`692`) #################### 1.0.3 (2023-09-06) #################### - Avoid CPython 3.8.17, 3.9.17, 3.10.12, and 3.11.4 tarfile symlink bug triggered by adding ``data_filter`` in 1.0.0. (PR :pr:`675`, fixes issue :issue:`674`) #################### 1.0.0 (2023-09-01) #################### - Removed the ``toml`` library fallback; ``toml`` can no longer be used as a substitute for ``tomli`` (PR :pr:`567`) - Added ``runner`` parameter to ``util.project_wheel_metadata`` (PR :pr:`566`, fixes issue :issue:`553`) - Modified ``ProjectBuilder`` constructor signature, added alternative ``ProjectBuilder.from_env`` constructor, redefined ``env.IsolatedEnv`` interface, and exposed ``env.DefaultIsolatedEnv``, replacing ``env.IsolatedEnvBuilder``. The aim has been to shift responsibility for modifying the environment from the project builder to the ``IsolatedEnv`` entirely and to ensure that the builder will be initialised from an ``IsolatedEnv`` in a consistent manner. Mutating the project builder is no longer supported. (PR :pr:`537`) - ``virtualenv`` is no longer imported when using ``-n``, for faster builds (PR :pr:`636`, fixes issue :issue:`510`) - The SDist now contains the repository contents, including tests. Flit-core 3.8+ required. (PR :pr:`657`, :pr:`661`, fixes issue :issue:`656`) - The minimum version of ``importlib-metadata`` has been increased to 4.6 and Python 3.10 due to a bug in the standard library version with URL requirements in extras. This is still not required for 3.8 when bootstrapping (as long as you don't have URL requirements in extras). (PR :pr:`631`, fixes issue :issue:`630`) - Docs now built with Sphinx 7 (PR :pr:`660`) - Tests now contain a ``network`` marker (PR :pr:`649`, fixes issue :issue:`648`) - Config-settings are now passed to ``get_requires*`` hooks, fixing a long standing bug. If this affects your setuptools build, you can use ``-C--build-option= -C--build-option=