Release 1.0.0

[jcfr]

To help coordinate the work related to 1.0.0 version, we now have the corresponding milestone.

TODO:

• Update pyproject-metadata for PEP 808
• Change Development Status from 4 to 5
• wheel-free-setuptools is alternative to setuptools
• TYPE_CHECKING = False
• lazy_imports

[henryiii]

Version 1.0.0

We've worked through over 100 issues and did extensive automated sweeps, fixing
over 90 bugs and adding 40+ features! The setuptools and hatchling plugins are
no longer experimental. There's a new unified scikit-build CLI, including an
init command to scaffold new projects. Wheels can be reproducible. Editable
installs received a lot of attention: namespace packages now work, lots of fixes
for redirect mode, and inplace mode now supports rebuilds, and hatchling
supports editable installs. For rebuilds, which are still experimental, loaders
expose a manual rebuild() and rebuilds can optionally target a persistent
install tree (which removes several caveats). Finally dynamic metadata follows a
spec with entry-point discovery and use [[tool.dynamic-metadata]]. There are
new settings: an env table, install.targets, force-include for SDists and
wheels, sdist.inclusion-mode = "explicit", list-valued cmake.build-type, and
a ${SKBUILD_<TREE>_DIR} prefix for targeting wheel trees. Free-threaded
(PEP 803) and combined abi3.abi3t wheel tags are supported, along with
experimental PEP 817 (variant) support. Imports are lazy on Python 3.15+, making
CLI and backend startup faster.

Behavior changes to be aware of: SDists now resolve symlinks by default, with an
sdist.resolve-symlinks setting providing "all", "external", "none", and
"classic" modes. The old names of renamed configuration fields
(cmake.minimum-version, ninja.minimum-version, cmake.verbose, and
cmake.targets) now error unless minimum-version is set, and the deprecated
tool.scikit-build.metadata table warns if minimum-version is not set. The
empty pyproject extra was removed.

Features:

• Faster startup via lazy imports by @henryiii in perf: adopt lazy imports via flake8-lazy #1415
• CLI: unified scikit-build command with submodules as subcommands by
  @henryiii in feat: add unified scikit-build CLI with submodules as subcommands #1355
• CLI: add init command to scaffold starter projects by @henryiii in feat: add init command to scaffold starter projects #1357
• Settings: entry-point configuration providers by @henryiii in feat(settings): entry-point configuration providers #1406
• Settings: add env table for build environment variables by @henryiii in
  feat: add env table for build environment variables #1377
• Settings: support install.targets for install targets by @henryiii in feat: support install.targets for install targets #1371
• Settings: add force-include for SDist, wheel, and build targets by @henryiii
  in feat: add force-include for sdist, wheel, and build targets #1364
• Settings: allow a list for cmake.build-type by @henryiii in feat: allow a list for cmake.build-type #1386
• Settings: honor CMAKE_BUILD_TYPE from the environment by @henryiii in feat: honor CMAKE_BUILD_TYPE from the environment #1372
• Settings: add cmake.use-sysconfig-compiler to opt out of sysconfig CC/CXX by
  @henryiii in feat: add cmake.use-sysconfig-compiler to opt out of sysconfig CC/CXX #1370
• Settings: add ${SKBUILD_<TREE>_DIR} prefix for wheel-tree targeting by
  @henryiii in feat: add ${SKBUILD_<TREE>_DIR} prefix for wheel-tree targeting #1379
• Settings: add {name} placeholder for template-formatted settings by
  @henryiii in feat: add {name} placeholder for template-formatted settings #1445
• Settings: warn on deprecated tool.scikit-build.metadata table by @henryiii
  in feat: warn on deprecated tool.scikit-build.metadata table #1397
• Settings: error on renamed config fields without old minimum-version by
  @henryiii in feat: error on renamed config fields without old minimum-version #1399
• Metadata: support dynamic-metadata 0.3 spec by @henryiii in feat: support dynamic-metadata 0.3 spec #1390
• Metadata: entry-point discovery for [[tool.dynamic-metadata]] by @henryiii
  in feat(metadata): entry-point discovery for [[tool.dynamic-metadata]] #1416
• Metadata: honor the dynamic_wheel hook when building SDists by @henryiii in
  feat(metadata): honor the dynamic_wheel hook when building SDists #1433
• Wheel: reproducible wheels by @henryiii in feat(wheel): reproducible wheels (closes #62) #1389
• Wheel: allow wheel.packages to point at a single module file by @henryiii in
  feat: allow wheel.packages to point at a single module file #1395
• Wheel: support PEP 803, free-threaded tag by @henryiii in feat: support PEP 803, free-threaded tag #1269
• Wheel: support combined abi3.abi3t wheel tag by @henryiii in feat: support combined abi3.abi3t wheel tag #1382
• Wheel: add experimental PEP 817 variant support by @henryiii in feat: add experimental PEP 817 variant support #1284
• SDist: resolve symlinks by default by @Doekin in feat(sdist): resolve symlinks by default #1265
• SDist: "external" and "classic" resolve-symlinks modes; "none" stores
  directory symlinks by @henryiii in feat(sdist): "external" and "classic" resolve-symlinks modes; "none" stores directory symlinks #1434
• SDist: add "explicit" inclusion-mode (opt-in include) by @henryiii in feat: add "explicit" inclusion-mode (opt-in include) #1249
• Editable: PEP 829 support by @henryiii in feat: add PEP 829 support for editable installs #1297
• Editable: point rebuilds at a persistent install tree (opt-in) by @henryiii in
  feat: point editable rebuilds at a persistent install tree - opt-in (#1135) #1375
• Editable: expose rebuild() on redirected module loaders by @henryiii in
  feat(editable): expose rebuild() on redirected module loaders #1403
• Editable: expose rebuild() on inplace loaders by @henryiii in feat(editable): expose rebuild() on inplace editable loaders #1411
• Editable: serve force-include entries live via the redirect by @henryiii in
  feat(editable): serve force-include entries live via the redirect #1441
• Plugins: de-experimentalize setuptools/hatchling plugins by @henryiii in feat:de-experimentalize setuptools/hatchling plugins, document experimental features #1358
• Plugins: warn if plugin extra missing from build-system.requires by
  @henryiii in feat: warn if plugin extra missing from build-system.requires #1344
• Plugins: include plugin extras for setuptools/hatchling by @henryiii in feat: include plugin extras for setuptools/hatchling #1290
• Hatchling plugin: editable install support by @henryiii in feat: hatchling edit #1282
• Hatchling plugin: reject wheel.exclude as unsupported by @henryiii in feat(hatch): reject wheel.exclude as unsupported #1431
• Setuptools plugin: inplace editable support by @henryiii in feat: support inplace editable for setuptools plugin #1278
• Setuptools plugin: add cmake_install_dir by @henryiii in feat(setuptools): add cmake_install_dir #1286
• Setuptools plugin: support cmake_install_target by @henryiii in feat: support cmake_install_target in setuptools plugin #1374
• Setuptools plugin: add cmake_process_manifest_hook by @henryiii in feat(setuptools): add cmake_process_manifest_hook #1285
• Setuptools plugin: allow cmake_with_sdist=False by @henryiii in feat(setuptools): Allow cmake_with_sdist=False #1287
• Setuptools plugin: honor SKBUILD_CONFIGURE_OPTIONS and
  SKBUILD_BUILD_OPTIONS in wrapper by @henryiii in feat(setuptools): honor SKBUILD_CONFIGURE_OPTIONS and SKBUILD_BUILD_OPTIONS in wrapper #1394

Fixes:

• Settings: accept override-only settings via config-settings by @henryiii in
  fix: accept override-only settings via config-settings (#1261) #1307
• Settings: flag scalar config-settings assignment to dict fields by @henryiii
  in fix(settings): flag scalar config-settings assignment to dict fields #1435
• Settings: treat entry-point config as dynamic for validation gates by
  @henryiii in fix(settings): treat entry-point config as dynamic for validation gates #1425
• Settings: robust signature dispatch and duplicate-name handling for
  entry-point providers by @henryiii in fix(settings): robust signature dispatch and duplicate-name handling for entry-point providers #1424
• Settings: allow = inside dict-style env var values like
  SKBUILD_CMAKE_DEFINE by @henryiii in fix: correct several latent bugs found in a repo sweep #1311
• Settings: accept plain strings for list/table fields in config-settings (e.g.
  -Cwheel.packages=src/pkg) by @henryiii in fix(settings): sources, overrides, and generated-docs bug fixes #1323
• Settings: don't crash on overrides mixing inherit with top-level fields by
  @henryiii in fix(settings): sources, overrides, and generated-docs bug fixes #1323
• Settings: apply if.state overrides when computing get_requires_for_build_*
  by @henryiii in fix(build): entry-point, wheel, and requires-state bugs #1322
• Settings: render {root} correctly in templated settings such as build-dir
  by @henryiii in fix: format/logging/editable-redirect bugs and cleanups #1318
• Settings: JSON schema no longer rejects valid cmake.define lists by
  @henryiii in fix: test isolation and schema/warning robustness (#1298) #1306
• Metadata: load provider-path providers via a meta-path finder by @henryiii in
  fix: load provider-path providers via a meta-path finder #1366
• Metadata: correct DynamicMetadataProtocol.dynamic_metadata signature by
  @henryiii in fix: correct DynamicMetadataProtocol.dynamic_metadata signature #1365
• Metadata: combine same-field dynamic_wheel reports with OR by @henryiii in
  fix(metadata): combine same-field dynamic_wheel reports with OR #1437
• Metadata: error on unknown keys in regex/template plugin settings instead
  of silently ignoring them by @henryiii in fix: file_api/ast/metadata bug fixes and simplifications #1319
• Wheel: auto-discover namespace packages in wheel builds by @henryiii in fix: auto-discover namespace packages in wheel builds (#682) #1385
• Wheel: don't error when a wheel.packages source is CMake-generated by
  @henryiii in fix(wheel): don't error when a wheel.packages source is CMake-generated #1440
• Wheel: use Path.as_posix() for including generated files in SDist/wheel by
  @shiftinv in fix: use Path.as_posix() for including generated files in sdist/wheel #1381
• Wheel: clamp SOURCE_DATE_EPOCH to the ZIP timestamp range by @henryiii in
  fix(wheel): clamp SOURCE_DATE_EPOCH to the ZIP timestamp range #1423
• Wheel: emit installer-compatible abi3t wheel tag by @henryiii in fix: emit installer-compatible abi3t wheel tag #1380
• Wheel: honor CMAKE_OSX_DEPLOYMENT_TARGET in wheel platform tag by @henryiii
  in fix: honor CMAKE_OSX_DEPLOYMENT_TARGET in wheel platform tag (#977) #1338
• Wheel: honor an explicit empty license-files to disable license collection
  by @henryiii in fix: correct several latent bugs found in a repo sweep #1311 and fix(build): entry-point, wheel, and requires-state bugs #1322
• Wheel: write location = "source" generated files as UTF-8 by @henryiii in
  fix(build): entry-point, wheel, and requires-state bugs #1322
• Wheel: don't crash on subdirectories inside the scripts install dir by
  @henryiii in fix(build): entry-point, wheel, and requires-state bugs #1322
• Wheel: fully prune consecutive excluded directories by @henryiii in fix(build): entry-point, wheel, and requires-state bugs #1322
• SDist: don't crash on dangling symlinks with resolve-symlinks = "all" by
  @henryiii in fix(sdist): don't crash on dangling symlinks with resolve-symlinks="all" #1421
• SDist: detect symlink loops when walking the source tree by @henryiii in fix: detect symlink loops when walking the source tree for sdist (#1101) #1341
• SDist: don't prune directories matched only by glob includes in default
  inclusion mode by @henryiii in fix: don't prune directories matched only by glob includes in default inclusion mode (#1248) #1339
• Editable: make namespace package installs importable by @henryiii in fix(editable): make namespace package editable installs importable #1427
• Editable: import remapped namespace packages by @henryiii in fix: import remapped namespace packages in editable installs (#1040) #1346
• Editable: don't treat versioned sonames as importable modules by @henryiii in
  fix: don't treat versioned sonames as importable modules in editable installs (#1144) #1337
• Editable: add symlinked module's real dir to __path__ by @henryiii in fix: editable install adds symlinked module's real dir to __path__ (#647) #1335
• Editable: importlib.resources.files() in redirect mode by @henryiii in Fix importlib.resources.files() in redirect-mode editable installs (#807) #1279
• Editable: recognize Cython __init__.pxd/.pyx as package indicators by
  @vyasr in fix(editable): recognize Cython __init__.pxd/.pyx as package indicators #1292
• Editable: import subpackage propagation by @henryiii in fix: import subpkg propagation #1304
• Editable: debounce rebuild to once per process by @henryiii in fix: debounce editable rebuild to once per process #1368
• Editable: rebuild() no longer hides the build output on failed rebuilds by
  @henryiii in fix: format/logging/editable-redirect bugs and cleanups #1318
• Editable: refuse to wipe a populated rebuild-dir by @henryiii in fix(editable): refuse to wipe a populated rebuild-dir #1400
• Editable: safe install/build paths for manual rebuild() by @henryiii in
  fix(editable): safe install/build paths for manual rebuild() #1429
• Editable: only block absolute wheel.install-dir for rebuilds by @henryiii in
  fix: only block absolute wheel.install-dir for editable rebuilds (#909) #1334
• CMake: cap SKBUILD_PROJECT_VERSION to four components by @henryiii in fix: cap SKBUILD_PROJECT_VERSION to four components #1369
• CMake: strip flags from sysconfig CC/CXX to just the executable by @henryiii
  in fix: strip flags from sysconfig CC/CXX to just the executable #1331
• CMake: keep compiler wrappers when stripping sysconfig CC/CXX flags by
  @henryiii in fix(builder): keep compiler wrappers when stripping sysconfig CC/CXX flags #1418
• CMake: detect two-token -G Ninja and -G in CMAKE_ARGS for generator
  handling by @henryiii in fix: detect two-token -G Ninja and -G in CMAKE_ARGS for generator handling #1352
• CMake: free-threaded Windows import library and two-token -D parsing by
  @henryiii in fix(builder): free-threaded Windows import library and two-token -D parsing #1422
• CMake: don't skip ninja requirement when generator is forced to Ninja by
  @henryiii in fix(requires): don't skip ninja when generator is forced to Ninja #1442
• CMake: more reliably find the Python library on Windows by @henryiii in fix: more reliably find the Python library on Windows #1310
• CMake: warn when CMake will build a mismatched x86_64 extension on macOS by
  @henryiii in fix(macos): warn when CMake will build a mismatched x86_64 extension #1404
• CMake: properly handle Union in the File API by @LecrisUT in bug: Properly handle Union in file-api #1272
• CMake: detect multi-config generators set via cmake.define.CMAKE_GENERATOR
  so the right --config is used by @henryiii in fix(builder): cmake generator detection, archs cross-compile, and program search robustness #1320
• CMake: apply full Ninja handling to Ninja Multi-Config by @henryiii in fix(builder): cmake generator detection, archs cross-compile, and program search robustness #1320
• CMake: -DCMAKE_SYSTEM_PROCESSOR in the CMake args suppresses ARCHFLAGS
  handling on macOS, as documented, by @henryiii in fix(builder): cmake generator detection, archs cross-compile, and program search robustness #1320
• CMake: comments inside cmake_minimum_required(...) no longer break
  cmake.version = "CMakeLists.txt", and unparsable files fall back gracefully
  by @henryiii in fix: file_api/ast/metadata bug fixes and simplifications #1319
• CMake: File API fixes: the toolchains reply is now read, optional link fields
  are tolerated, and missing Target.sources/InstallRule.type fields were
  restored by @henryiii in fix: correct several latent bugs found in a repo sweep #1311 and fix: file_api/ast/metadata bug fixes and simplifications #1319
• CLI: argument parsing and clear errors for common mistakes by @henryiii in
  fix(cli): argument parsing and clear errors for common mistakes #1426
• Handle typed vcs_versioning.overrides in mypy by @henryiii in fix(types): handle typed vcs_versioning.overrides in mypy #1388
• Hatchling plugin: ignore hatchling's reserved enable-by-default hook option by
  @henryiii in fix(hatch): ignore hatchling's reserved enable-by-default hook option #1419
• Hatchling plugin: don't double the wheel.install-dir prefix, which made
  wheels unimportable by @henryiii in fix(hatch,setuptools): correctness fixes in hatch and setuptools layers #1321
• Setuptools plugin: wrapper path compatibility with scikit-build (classic) by
  @henryiii in fix(setuptools): wrapper path compatibility with scikit-build (classic) #1295
• Setuptools plugin: classic scikit-build wrapper compatibility fixes by
  @henryiii in fix(setuptools): classic scikit-build wrapper compatibility fixes #1316
• Setuptools plugin: protect SetupError by @henryiii in fix(setuptools): protect SetupError #1293
• Setuptools plugin: accept wheel-free-setuptools extra in plugin warning by
  @henryiii in fix(setuptools): accept wheel-free-setuptools extra in plugin warning #1413
• Setuptools plugin: don't require editable.mode for build_ext --inplace by
  @henryiii in fix(setuptools): don't require editable.mode for build_ext --inplace #1432
• Setuptools plugin: build-type list rejection, package_dir editable root,
  free-threaded limited-API gate by @henryiii in fix(setuptools): build-type list rejection, package_dir editable root, FT limited-api gate #1428
• Setuptools plugin: resolve overrides with the correct wheel/editable state
  by @henryiii in fix(hatch,setuptools): correctness fixes in hatch and setuptools layers #1321
• Sweep: further small fixes from a repo sweep by @henryiii in fix: correct several latent bugs found in a repo sweep #1311
• Sweep: further small format, logging, and editable-redirect fixes by @henryiii
  in fix: format/logging/editable-redirect bugs and cleanups #1318
• Sweep: further small File API, AST, and metadata fixes by @henryiii in fix: file_api/ast/metadata bug fixes and simplifications #1319
• Sweep: further generator detection and program search robustness fixes by
  @henryiii in fix(builder): cmake generator detection, archs cross-compile, and program search robustness #1320
• Sweep: further correctness fixes in hatch and setuptools layers by @henryiii
  in fix(hatch,setuptools): correctness fixes in hatch and setuptools layers #1321
• Sweep: further entry-point, wheel, and requires-state fixes by @henryiii in
  fix(build): entry-point, wheel, and requires-state bugs #1322
• Sweep: further settings sources, overrides, and generated-docs fixes by
  @henryiii in fix(settings): sources, overrides, and generated-docs bug fixes #1323
• Sweep: minor fixes based on review by @henryiii in fix: minor fixes based on review #1305
• Sweep: test isolation and warning robustness by @henryiii in fix: test isolation and schema/warning robustness (#1298) #1306

Documentation:

• Dedupe, simplify, and restructure the documentation by @henryiii in docs: dedupe, simplify, and restructure the documentation #1448
• Review and refresh documentation for the 1.0 release by @henryiii in docs: review and refresh documentation for the 1.0 release #1402
• Add missing versionadded/versionchanged directives for 1.0 by @henryiii in
  docs: add missing versionadded/versionchanged directives for 1.0 #1405
• Add workspaces and monorepos guide by @henryiii in docs: add workspaces and monorepos guide #1444
• Add a Windows debug builds note by @henryiii in docs: add a Windows debug builds note #1450
• FAQ for IDE IntelliSense / compile_commands.json by @henryiii in docs: FAQ for IDE IntelliSense / compile_commands.json #1447
• Explain target output paths on MSVC / multi-config generators by @henryiii in
  docs: explain target output paths on MSVC / multi-config generators #1446
• FAQ on coverage and debugging (gcov/gcovr/GDB) by @henryiii in docs: add FAQ on coverage and debugging (gcov/gcovr/GDB) #1409
• Tips for shipping a ctypes-loaded shared library by @henryiii in docs: tips for shipping a ctypes-loaded shared library (#374) #1408
• FAQ for dependency library in site-packages/bin or lib by @henryiii in
  docs: add FAQ for dependency library in site-packages/bin or lib #1393
• Clarify wheel.packages semantics (top-level, not a find/where) by @henryiii
  in docs: clarify wheel.packages semantics (top-level, not a find/where) #1407
• Address post-merge review notes on entry-point config by @henryiii in docs(settings): address post-merge review notes on entry-point config #1438
• Fix sdist.inclusion-mode name and dynamic-metadata field requirement by
  @henryiii in docs: fix sdist.inclusion-mode name and dynamic-metadata field requirement #1420
• Fix RTD version and render GitHub-style admonitions by @henryiii in docs: fix RTD version and render GitHub-style admonitions #1410
• Use cython-cmake and f2py-cmake in getting started examples by @henryiii in
  docs: use cython-cmake and f2py-cmake in getting started examples #1353
• Clarify README example and unify cmake_minimum_required ranges by @henryiii
  in docs: clarify README example and unify cmake_minimum_required ranges #1392
• Fix incorrect config keys and stale claims in docs by @henryiii in docs: fix incorrect config keys and stale claims in docs #1359
• Document cmake.module entry point and metadata states by @henryiii in docs: document cmake.module entry point and metadata states #1360
• Refresh stale guidance and version pins by @henryiii in docs: refresh stale guidance and version pins #1361
• Fix typos and grammar by @henryiii in docs: fix typos and grammar #1362
• Show config-settings and env var forms in config reference by @henryiii in
  docs: show config-settings and env var forms in config reference #1347
• Remove documented unimplemented search settings by @henryiii in docs: remove documented unimplemented search settings #1354
• Make sphinx-tippy tooltips follow the active theme by @henryiii in fix(docs): make sphinx-tippy tooltips follow the active theme #1349
• Link Python::Module in Fortran example for CMake 4.x by @henryiii in fix: link Python::Module in fortran example for CMake 4.x #1373
• Improve docs on source by @henryiii in docs: improve docs on source #1276
• Add GitHub icon to header icon row by @henryiii in docs: add GitHub icon to header icon row #1387
• Add more projects using scikit-build-core by @henryiii in docs: add more projects using scikit-build-core #1309
• Add pyarrow to list of projects by @raulcd in docs: add pyarrow to list of projects #1266
• Avoid a common timeout by @henryiii in docs: avoid a common timeout #1308

CI and testing:

• Cover uv as an install frontend via a workspace by @henryiii in test: cover uv as an install frontend via a workspace #1443
• Add Python 3.15 and 3.15t to CI by @henryiii in ci: add Python 3.15 and 3.15t to CI #1383
• Skip heavy test matrix on docs-only changes by @henryiii in ci: skip heavy test matrix on docs-only changes #1356
• Adapt to setuptools-scm 10 / vcs-versioning 2 warnings by @henryiii in test: adapt to setuptools-scm 10 / vcs-versioning 2 warnings #1350
• Exclude pytest 9.1.0 (params-fixture override regression) by @henryiii in
  ci: exclude pytest 9.1.0 (params-fixture override regression) #1329
• Pin old-CMake Windows rows to windows-2022, add a VS 2026 row by @henryiii in
  ci: pin old-CMake Windows rows to windows-2022, add a VS 2026 row #1326
• Reduce test-suite wall-clock time by @henryiii in chore(tests): reduce test-suite wall-clock time #1325
• Fix Windows PermissionError from concurrent wheelhouse lock races by
  @henryiii in tests: fix Windows PermissionError from concurrent wheelhouse lock races #1288
• Clean up incomplete or old editable in wheelhouse by @henryiii in tests: clean up incomplete or old editable in wheelhouse #1283
• Secure GitHub Actions workflows by @henryiii in ci: secure GitHub Actions workflows #1302
• Use native uv integration in RTD by @henryiii in ci: use native uv integration in rtd #1274
• Stub macOS lipo arch probe for fake-subprocess tests by @henryiii in test: stub macOS lipo arch probe for fake-subprocess tests #1313 and
  test: remove now-unused lipo registrations #1314
• Migrate beakerlib test to python script by @LecrisUT in chore: Migrate beakerlib test to python script #1376

Internal:

• Unify wheel build orchestration across backend and hatch plugin by @henryiii
  in refactor: unify wheel build orchestration across backend and hatch plugin #1345
• Rename editable files to _editable_skbc_<name> by @henryiii in refactor: rename editable files to _editable_skbc_<name> #1332
• Drop the empty pyproject extra by @henryiii in chore: drop the empty pyproject extra #1398
• Remove orjson from dependencies by @henryiii in chore: remove 'orjson' from dependencies #1333
• Support uvx scikit-build-core too by @henryiii in chore: support uvx too #1396
• Add a utils package by @LecrisUT in chore: Add an utils package #1268
• Simplification cleanups from a repo sweep by @henryiii in refactor: simplification cleanups from a repo sweep #1312
• Use local TYPE_CHECKING = False instead of importing from typing by
  @henryiii in refactor: use local TYPE_CHECKING = False instead of importing from typing #1412
• Adapt to better pathspec types by @henryiii in chore: adapt to better pathspec types #1277