Changelog¶
1.2.2 (2024-09-06)¶
1.2.1 (2024-03-28)¶
Avoid error when terminal width is undetectable on Python < 3.11 (PR #761)
1.2.0 (2024-03-27)¶
1.1.1 (2024-02-29)¶
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 #736)
Stopped injecting
wheel
as a build dependency automatically, in the case of missingpyproject.toml
– by @webknjaz. (PR #716)Use
importlib_metadata
on Python <3.10.2 for bugfixes not present in those CPython standard libraries (not required when bootstrapping) – by @GianlucaFicarelli. (PR #693, fixes issue #692)
1.0.3 (2023-09-06)¶
1.0.0 (2023-09-01)¶
Removed the
toml
library fallback;toml
can no longer be used as a substitute fortomli
(PR #567)Added
runner
parameter toutil.project_wheel_metadata
(PR #566, fixes issue #553)Modified
ProjectBuilder
constructor signature, added alternativeProjectBuilder.from_env
constructor, redefinedenv.IsolatedEnv
interface, and exposedenv.DefaultIsolatedEnv
, replacingenv.IsolatedEnvBuilder
. The aim has been to shift responsibility for modifying the environment from the project builder to theIsolatedEnv
entirely and to ensure that the builder will be initialised from anIsolatedEnv
in a consistent manner. Mutating the project builder is no longer supported. (PR #537)virtualenv
is no longer imported when using-n
, for faster builds (PR #636, fixes issue #510)The SDist now contains the repository contents, including tests. Flit-core 3.8+ required. (PR #657, #661, fixes 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 #631, fixes issue #630)Docs now built with Sphinx 7 (PR #660)
Tests now contain a
network
marker (PR #649, fixes 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=<cmd> -C--build-option=<option>
to workaround an issue with Setuptools not allowing unrecognised build options when running this hook. (PR #627, fixes issue #264)Test on Python 3.12 betas/RCs (PR #624)
Filter out malicious files when extracting tar archives when Python supports it (PR #609)
Specify encoding, fixing issues when
PYTHONWARNDEFAULTENCODING
is set. (PR #587, fixes issue #577)Ruff is now used for linting.
0.10.0 (2023-01-11)¶
0.9.0 (2022-10-27)¶
Hide a Python 3.11.0 unavoidable warning with venv (PR #527)
Fix infinite recursion error in
check_dependency
with circular dependencies (PR #512, Fixes #511)Flush output more often to reduce interleaved output (PR #494)
Small API cleanup, like better
_all__
and srcdir being read only. (PR #477)Only use
importlib_metadata
when needed (PR #401)Clarify in printout when build dependencies are being installed (PR #514)
0.8.0 (2022-05-22)¶
Accept
os.PathLike[str]
in addition tostr
for paths in public API (PR #392, Fixes #372)Add schema validation for
build-system
table to check conformity with PEP 517 and PEP 518 (PR #365, Fixes #364)Better support for Python 3.11 (sysconfig schemes PR #434, PR #463, tomllib PR #443, warnings PR #420)
Improved error printouts (PR #442)
Avoid importing packaging unless needed (PR #395, Fixes #393)
Breaking Changes¶
Failure to create a virtual environment in the
build.env
module now raisesbuild.FailedProcessError
(PR #442)
0.7.0 (2021-09-16)¶
Add
build.util
module with an high-level utility API (PR #340)
0.6.0.post1 (2021-08-05)¶
0.6.0 (2021-08-02)¶
The CLI now honors
NO_COLOR
(PR #333)The CLI can now be forced to colorize the output by setting the
FORCE_COLOR
environment variable (PR #335)Added logging to
build
andbuild.env
(PR #333)
Breaking Changes¶
Dropped support for Python 2 and 3.5.
0.5.1 (2021-06-22)¶
0.5.0 (2021-06-19)¶
Add
ProjectBuilder.metadata_path
helper (PR #303, Fixes #301)Added a
build.__main__.build_package_via_sdist
method (PR #304)Use appropriate installation scheme for Apple Python venvs (PR #314, Fixes #310)
Breaking Changes¶
Binary distributions are now built via the sdist by default in the CLI (PR #304, Fixes #257) -
python -m build
will now build a sdist, extract it, and build a wheel from the sourceAs a side-effect of PR #304,
build.__main__.build_package
no longer does CLI error handling (print nice message and exit the program)Importing
build.__main__
no longer has any side-effects, it no longer overrideswarnings.showwarning
or runscolorama.init
on import (PR #312)
0.4.0 (2021-05-23)¶
Validate that the supplied source directory is valid (PR #260, Fixes #259)
Set and test minimum versions of build’s runtime dependencies (PR #267, Fixes #263)
Use symlinks on creating venv’s when available (PR #274, Fixes #271)
Error sooner if pip upgrade is required and fails (PR #288, Fixes #256)
Add a
runner
argument toProjectBuilder
(PR #290, Fixes #289)Hide irrelevant
pep517
error traceback and improve error messages (PR #296)Try to use
colorama
to fix colors on Windows (PR #300)
Breaking Changes¶
As a side-effect of PR #260, projects not containing either a
pyproject.toml
orsetup.py
will be reported as invalid. This affects projects specifying only asetup.cfg
, such projects are recommended to add apyproject.toml
. The new behavior is on par with what pip currently does, so if you are affected by this, your project should not be pip installable.The
--skip-dependencies
option has been renamed to--skip-dependency-check
(PR #297)The
skip_dependencies
argument ofbuild.__main__.build_package
has been renamed toskip_dependency_check
(PR #297)build.ConfigSettings
has been renamed tobuild.ConfigSettingsType
(PR #298)build.ProjectBuilder.build_dependencies
tobuild.ProjectBuilder.build_system_requires
(PR #284, Fixes #182)build.ProjectBuilder.get_dependencies
tobuild.ProjectBuilder.get_requires_for_build
(PR #284, Fixes #182)
0.3.1 (2021-03-09)¶
0.3.0 (2021-02-19)¶
0.2.1 (2021-02-09)¶
0.2.0 (2021-02-07)¶
Build wheel and sdist distributions in separate environments, as they may have different dependencies (PR #195, Fixes #194)
Add support for pre-releases in
check_dependency
(PR #204, Fixes #191)Fixes console scripts not being available during build (PR #221, Fixes #214)
Do not add the default backend requirements to
requires
when no backend is specified (PR #177, Fixes #107)Return the sdist name in
ProjectBuild.build
(PR #197)
Breaking changes¶
0.1.0 (2020-10-29)¶
Moved the upstream to PyPA
Fixed building with isolation in a virtual environment
Added env.IsolatedEnv abstract class
Added env.IsolatedEnvBuilder (replaces env.IsolatedEnvironment usages)
Added python_executable argument to the ProjectBuilder constructor
Added –version/-V option to the CLI
Added support for Python 3.9
Added py.typed marker
Various miscellaneous fixes in the virtual environment creation
Many general improvements in the documentation
Documentation moved to the furo theme
Updated the CoC to the PSF CoC, which PyPA has adopted
Breaking changes¶
Renamed the entrypoint script to pyproject-build
Removed default arguments from all paths in ProjectBuilder
Removed ProjectBuilder.hook
Renamed __main__.build to __main__.build_package
Changed the default outdir value to {srcdir}/dest
Removed env.IsolatedEnvironment
0.0.4 (2020-09-08)¶
Packages are now built in isolation by default
Added –no-isolation/-n flag to build in the current environment
Add –config-setting/-C option to pass options to the backend
Add IsolatedEnvironment class
Fix creating the output directory if it doesn’t exit
Fix building with in-tree backends
Fix broken entrypoint script (python-build)
Add warning about incomplete verification when verifying extras
Automatically detect typos in the build system table
Minor documentation improvements
0.0.3.1 (2020-06-10)¶
Fix bug preventing the CLI from being invoked
Improved documentation
0.0.3 (2020-06-09)¶
Misc improvements
Added documentation
0.0.2 (2020-05-29)¶
Add setuptools as a default fallback backend
Fix extras handling in requirement strings
0.0.1 (2020-05-17)¶
Initial release