Version 1.1.0

[henryiii]

Packages can now declare their own config-settings in a tool.scikit-build.config-setting table. This gives packages the opportunity to add a documented interface in place of raw CMake defines. The new scikit-build settings list command shows all the config-settings that a project accepts. New settings include cmake.fresh, if.not overrides, and sdist.resolve-symlinks = "error". import-names and import-namespaces (PEP 794) are filled from Python if set as dynamic. project.version is now kept exactly as written in the metadata (1.1+). Editable loaders expose their search paths, redirect mode gives a deterministic __path__ order, and you can set up a persistent install tree even without rebuild-on-import. Other bugs and performance issues are addressed.

Features:

• New settings:
  • tool.scikit-build.config-setting for package-declared config-settings by @henryiii in feat: package-declared config-settings #1489
  • cmake.fresh to configure from scratch by @henryiii in feat: add cmake.fresh to configure from scratch #1516
  • if.not overrides by @henryiii in feat: add if.not overrides #1539
• CLI:
  • scikit-build settings list lists supported config-settings by @henryiii in feat(cli): list supported config-settings #1522
  • scikit-build build requires accepts -C/--config-setting to pass config-settings to the backend hook, and --type {static,dynamic,both} to select the static build-system.requires, the dynamic hook output, or both by @henryiii in feat(cli): add -C and --type to build requires #1584
• SDist:
  • sdist.resolve-symlinks = "error" fails the SDist build if an included path is a symlink, and lists each link with its target. This includes sdist.force-include sources and the files under them. Directory links are not followed. Requires minimum-version 1.1 or unset (sdist: a resolve-symlinks mode that fails the build when a symlink is included #1581) by @henryiii in feat(sdist): add resolve-symlinks = "error" mode #1583
• Metadata:
  • import-names and import-namespaces (PEP 794) listed in project.dynamic are computed from the Python packages (PEP794 support with dynamic field #1536) by @henryiii in feat: compute dynamic import-names from packages #1578
  • project.version is kept as written in the Version metadata field and in SKBUILD_PROJECT_VERSION_FULL, so a calendar version such as 2024.01.05 keeps its leading zeros. Filenames stay normalized. Requires minimum-version 1.1 or unset by @henryiii in feat: keep project.version as written (leading zeros) #1572
• Editable:
  • Loaders expose their search paths as a paths attribute by @henryiii in feat(editable): expose search paths on redirect loaders #1567
  • An explicit editable.rebuild = false is honored with editable.rebuild-dir, so a persistent install tree can be used without rebuild-on-import (Editable redirect: allow the persistent install tree without rebuild-on-import #1576) by @henryiii in feat(editable): honor explicit editable.rebuild = false with rebuild-dir #1577
• File API:
  • Complete the file-api models and keep reference data by @henryiii in feat(fileapi): complete the file-api models and keep reference data #1521
• Drop Python 3.8 by @henryiii in feat: drop Python 3.8 #1281

Fixes:

• Builder:
  • Compute the wheel tag from the build environment (tool.scikit-build.env) by @henryiii in fix(builder): compute the wheel tag from the build environment #1575
  • Honor a CMAKE_GENERATOR define when computing build requirements by @henryiii in fix(builder): honor CMAKE_GENERATOR define in requires #1557
  • Read Py_GIL_DISABLED="0" as not free-threaded by @henryiii in fix(builder): use one free-threaded check #1574
  • Set Python_FIND_ABI for free-threaded builds on CMake 3.30+ by @henryiii in fix: set Python_FIND_ABI for free-threaded builds on CMake 3.30+ #1532
  • Don't pass the Python_LIBRARY hint in SABI mode on Windows by @henryiii in fix: don't pass Python_LIBRARY hint in SABI mode on Windows #1533
  • Warn once for unsupported CMAKE_ARGS defines by @henryiii in fix(builder): warn once for unsupported CMAKE_ARGS defines #1573
  • Drop two-token -D CMAKE_BUILD_TYPE from CMAKE_ARGS by @r3wretrhy in fix: drop two-token CMAKE_BUILD_TYPE from CMAKE_ARGS #1543
  • Keep building when the CMake file-api reply is broken by @henryiii in fix: keep building when the CMake file-api reply is broken #1562
• CMake discovery:
  • Prefer cmake over cmake3 when searching (Search for cmake binary first before cmake3 #1514) by @henryiii in fix: prefer cmake over cmake3 when searching #1515
  • Double the CMake discovery timeout on native Apple Silicon (Native arm64 CMake can exceed discovery timeout in fresh rattler-build prefixes on macOS #1530) by @DSeaStar in fix: double CMake discovery timeout on native Apple Silicon #1535
  • Correct the riscv64 manylinux tag for cmake wheels by @henryiii in fix: correct riscv64 manylinux tag for cmake wheels #1563
  • Program search, build-dir info, and module detection robustness by @henryiii in fix: program search, build-dir info, and module detection robustness #1554
• Settings:
  • if.cmake-wheel never matched a platform by @henryiii in fix: if.cmake-wheel never matched a platform #1538
• Editable:
  • Redirect installs give a package a deterministic __path__ order: the CMake install tree first, then the source tree, so importlib.resources no longer depends on PYTHONHASHSEED (Editable redirect: make the package search-location order deterministic, and expose the install tree at runtime #1565) by @henryiii in fix(editable): deterministic install-first __path__ order in redirect mode #1566
• SDist:
  • Ignore rules no longer cross repository boundaries: a superproject's .gitignore does not apply inside a git submodule, matching git (sdist: ignore rules cross repository boundaries; a fix, and a git inclusion mode #1582) by @henryiii in fix(sdist): stop ignore rules at repository boundaries #1585
  • Scope the nested .gitignore scan to the walked subtree by @zklaus in fix: scope the nested .gitignore scan to the walked subtree #1542
• File API:
  • Match CMake's install-rule paths and namelink spelling by @henryiii in fix(fileapi): match CMake's install-rule paths and namelink spelling #1520
• Setuptools:
  • Pass the hook state to GetRequires by @henryiii in fix(setuptools): pass the hook state to GetRequires #1555
  • Parse --cmake-args with shlex by @henryiii in fix(setuptools): parse --cmake-args with shlex #1560
• Init:
  • The abi3t template sets SOSABI as well as SOABI by @ngoldbaum in fix: use SOSABI instead of SOABI in abi3t template #1587
• Variants:
  • Cap the variantlib build requirement to <0.1 by @CavRiley in fix(variants): cap variantlib build requirement to <0.1 #1571
• Limit fastjsonschema on Python 3.9 by @henryiii in fix: limit fastjsonschmema on 3.9 #1524

Performance:

• Scan entry points once for all groups by @henryiii in perf: scan entry points once for all groups #1559
• Cache entry-point scans and known-wheel lookups by @henryiii in perf: cache entry-point scans and known-wheel lookups #1545
• Build and builder hot paths by @henryiii in perf: build and builder hot paths #1547
• Read settings once per build in the setuptools plugin by @henryiii in perf(setuptools): read settings once per build #1548
• Cut editable shim import time by @henryiii in perf: cut editable shim import time #1546
• Compile the CMake tokenizer regex once by @henryiii in perf: compile CMake tokenizer regex once #1544
• Look up nested .gitignore specs by ancestor by @henryiii in perf: look up nested .gitignore specs by ancestor instead of scanning all #1550

Documentation:

• Add an advanced topic on wrapping the build backend by @henryiii in docs: add advanced topic on wrapping the build backend #1518
• Add llms.txt and markdown copies of pages by @henryiii in docs: add llms.txt and markdown copies of pages #1523
• Recommend rebuilding editables via find_spec before import by @henryiii in docs: recommend rebuilding editables via find_spec before import #1510
• Name the external dynamic-metadata plugins by @henryiii in docs: name the external dynamic-metadata plugins #1511
• Update moved intersphinx inventory URLs by @henryiii in docs: update moved intersphinx inventory urls #1569

CI and testing:

• Test the matrix CMake version, fix pass job needs, coverage and test fixes by @henryiii in ci/test: test the matrix CMake version, fix pass job needs, coverage and test fixes #1553
• Install dynamic build requires in the downstream session by @henryiii in ci: install dynamic build requires in downstream session #1580
• Stop rebuilding the wheelhouse wheel every session by @henryiii in test/ci: stop rebuilding the wheelhouse wheel every session; drop duplicate API docs check #1549
• Allow the setuptools-scm file_finders deprecation by @henryiii in test: allow setuptools-scm file_finders deprecation #1568
• Accept the new CPython 3.15rc1 abi3 suffix by @henryiii in test: accept new CPython 3.15rc1 abi3 suffix in abi3 tests #1529
• Pin the wrapper's CMake install staging layout by @henryiii in test: pin the wrapper's CMake install staging layout #1512

Internal:

• Bump the CMake policy upper bound to 4.4 by @henryiii in chore: bump CMake policy upper bound to 4.4 #1509
• Avoid CMake 4.4.0's broken Windows SABI detection by @henryiii in chore: avoid CMake 4.4.0's broken Windows SABI detection #1513
• Backport Fedora downstream changes by @LecrisUT in chore(fedora): Backport downstream changes #1491
• Source cleanups from the review by @henryiii in chore: source cleanups from the review #1552
• Clean up leaked and stale config by @henryiii in chore: clean up leaked and stale config #1551
• Use unlink(missing_ok=True) for stale CMakeCache.txt removal by @henryiii in chore: use unlink(missing_ok=True) for stale CMakeCache removal #1517

Full Changelog: v1.0.3...v1.1.0

---

This discussion was created from the release Version 1.1.0.