docs: prepare for 0.10.0 (#845)

Preparing for 0.10.

Signed-off-by: Henry Schreiner <[email protected]>

Author: henryiii

docs/changelog.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## Version 0.10.0
+
+This version adds auto CMake version discovery, opt-in auto minimum-version,
+rebuild on failure support, quite a few new override options greatly expanding
+the static config options for builds, more powerful regexs, and more.
+
+New features:
+
+* Auto CMake version by @henryiii in #804
+* Auto minimum-version by @henryiii in #798
+* Add `fail` setting to instant-fail build by @henryiii in #824
+* Add messages config for failure/success by @henryiii in #825
+* New color system for message config by @henryiii in #842
+* Add `if.abi-flags` (for free-threaded) by @henryiii in #819
+* Adding `if.system-cmake` and `if.cmake-wheel` by @henryiii in #826
+* Add `if.from-sdist` for overrides by @henryiii in #812
+* Add `if.failed` (retry) by @henryiii in #820
+* Packages can also be specified via a table by @henryiii in #841
+* Move `cmake.targets` and `cmake.verbose` to `build.targets` and `build.verbose` by @henryiii in #793
+* Support multipart regex by @henryiii in #818
+* Add `remove=` postprocess to regex by @henryiii in #828
+
+Fixes:
+
+* Warn if cmake/ninja in build system requirements by @henryiii in #803
+* Detect manual generator setting for `get_requires_*` by @henryiii in #840
+* Support nested and local gitignores by @henryiii in #827
+* Expand variables in some paths (mostly helps tests) by @henryiii in #842
+
+Internal:
+
+* Pull out overrides to separate file by @henryiii in #821
+* Nicer error/warning printer by @henryiii in #813
+* Speed up CI for format job by @henryiii in #814
+
+Documentation:
+
+* Fix typo in projects list by @jcfr in #797
+* Add disclaimer by @henryiii in #805
+* Add pointer to itk by @thewtex in #817
+* Add projects list by @henryiii in #788
+* Examples nox job should use local copy of scikit-build-core by @henryiii in #810
+* Expand defs and move schema by @henryiii in #795
+* Hide deprecated options in README by @henryiii in #792
+* Move overrides to page, expand by @henryiii in #815
+* Use modern cmake/ninja version setting in Fortran example by @henryiii in #809
 
 ## Version 0.9.10
 

docs/configuration.md

@@ -11,8 +11,8 @@ options can optionally be prefixed with `skbuild.`, for example
 
 ## Verbosity
 
-You can increase the verbosity of the build with two settings - `cmake.verbose`
-is a shortcut for verbose build output, and logging.level controls
+You can increase the verbosity of the build with two settings - `build.verbose`
+is a shortcut for verbose build output, and `logging.level` controls
 scikit-build-core's internal logging. An example (with all configuration styles)
 of setting both is:
 
@@ -82,6 +82,12 @@ workaround for legacy tooling.
 
 :::
 
+:::{versionchanged} 0.10
+
+`cmake.verbose` was renamed to `build.verbose`.
+
+:::
+
 ## Minimum version & defaults
 
 Scikit-build-core, like CMake, has a special minimum required version setting.
@@ -114,6 +120,13 @@ requires = ["scikit-build-core>=0.10"]
 minimum-version = "build-system.requires"
 ```
 
+:::{versionchanged} 0.10
+
+The `"build-system.requires"` option was added.
+
+:::
+
+
 :::{warning}
 
 The following behaviors are affected by `minimum-version`:
@@ -124,7 +137,8 @@ The following behaviors are affected by `minimum-version`:
 - `minimum-version` 0.8+ (or unset) `cmake.minimum-version` and
   `ninja.minimum-version` are replaced with `cmake.version` and `ninja.version`.
 - `minimum-version` 0.10+ (or unset) `cmake.targets` and
-  `cmake.verbose` are replaced with `build.targets` and `build.verbose`.
+  `cmake.verbose` are replaced with `build.targets` and `build.verbose`. The
+  CMake minimum version will be detected if not given.
 
 :::
 
@@ -265,6 +279,12 @@ But you can also do more complex moves:
 "mypackage/subpackage" = "python/src/subpackage"
 ```
 
+:::{versionadded} 0.10
+
+Support for the table form.
+
+:::
+
 You can disable Python file inclusion entirely, and rely only on CMake's
 install mechanism:
 
@@ -310,8 +330,8 @@ wheel.exclude = ["**.pyx"]
 
 :::{versionchanged} 0.9
 
-Before scikit-build-core 0.9, these were matched on the source path, rather than
-the wheel path, and didn't apply to CMake output.
+Previously these were matched on the source path, rather than the wheel path,
+and didn't apply to CMake output.
 
 :::
 
@@ -475,10 +495,16 @@ CMAKE_ARGS: -DSOME_DEFINE=ON -DOTHER=OFF
 You can also specify only specific targets to build (leaving this off builds the
 default targets):
 
-```{conftabs} cmake.targets ["python"]
+```{conftabs} build.targets ["python"]
 
 ```
 
+:::{versionchanged} 0.10
+
+`cmake.targets` was renamed to `build.targets`.
+
+:::
+
 You can pass raw arguments directly to the build tool, as well:
 
 ```{conftabs} build.tool-args ["-j12", "-l13"]
@@ -600,13 +626,10 @@ remove = "dev0"
 
 This will remove the "dev" tag when it is equal to 0.
 
-```{versionadded} 0.5
-
-```
-
-```{versionchanged} 0.10
+:::{versionchanged} 0.10
 
 Support for `result` and `remove` added.
+
 ```
 
 :::
@@ -724,6 +747,10 @@ styles is possible with `reset`. These all can be chained, as well, so
 Remember that you need to set the environment variable `FORCE_COLOR` to see
 colors with pip.
 
+```{versionadded} 0.10
+
+```
+
 ## Other options
 
 You can select a custom build dir; by default scikit-build-core will use a
@@ -764,6 +791,10 @@ You can also fail the build with `fail = true`. This is useful with overrides if
 you want to make a specific configuration fail. If this is set, extra
 dependencies like `"cmake"` will not be requested.
 
+```{versionadded} 0.10
+
+```
+
 ## Overrides
 
 The overrides system allows you to customize for a wide variety of situations.

docs/overrides.md

@@ -123,6 +123,10 @@ cmake.version = ">=3.30"
 
 This is often combined with `if.any`.
 
+:::{versionadded} 0.7
+
+:::
+
 ### `state` (string)
 
 The state of the build, one of `sdist`, `wheel`, `editable`, `metadata_wheel`,
@@ -131,11 +135,19 @@ and `metadata_editable`. Takes a regex.
 Note that you can build directly to wheel; you don't have to go through an
 SDist.
 
+:::{versionadded} 0.8
+
+:::
+
 ### `from-sdist` (bool)
 
 This will be true if the `PKG-INFO` file exists, that is, if this is coming
 from an SDist. Takes a bool.
 
+:::{versionadded} 0.10
+
+:::
+
 ### `system-cmake` (version)
 
 This will match if there's a system CMake matching this version specification.
@@ -146,6 +158,9 @@ if.system-cmake = ">=3.15"
 cmake.version = ""
 message.after-success = "Built using a system CMake, not a wheel"
 ```
+:::{versionadded} 0.10
+
+:::
 
 ### `cmake-wheel` (bool)
 
@@ -167,6 +182,9 @@ if.any.system-cmake = ">=3.15"
 if.any.cmake-wheel = true
 wheel.cmake = true
 ```
+:::{versionadded} 0.10
+
+:::
 
 ### `failed` (bool)
 
@@ -180,6 +198,9 @@ if a build fails, for example:
 if.failed = true
 wheel.cmake = false
 ```
+:::{versionadded} 0.10
+
+:::
 
 ## Any matching condition
 
@@ -205,6 +226,10 @@ wheel.cmake = true
 Above, either `CIBUILDWHEEL` or `BUILD_MY_LIB` being truthy will trigger a
 binary build.
 
+:::{versionadded} 0.7
+
+:::
+
 ## Inheriting for tables and arrays
 
 If you specify `inherit.<thing> = "append"` or `"prepend"`, then an override
@@ -237,4 +262,8 @@ the other, as the table would be replaced. And `"prepend"` wouldn't be useful
 at all, since FOO and BAR are already defined, so the original definition would
 win.
 
+:::{versionadded} 0.9
+
+:::
+
 [pep 508]: https://peps.python.org/pep-0508/#environment-markers

docs/plugins/hatchling.md

@@ -11,6 +11,10 @@ moves.
 
 :::
 
+:::{versionadded} 0.9
+
+:::
+
 ## Basic usage
 
 To use the plugin, make sure hatchling and scikit-build-core are in your

noxfile.py

@@ -245,6 +245,7 @@ def downstream(session: nox.Session) -> None:
         "--editable", action="store_true", help="Install as editable wheel"
     )
     parser.add_argument("-c", dest="code", help="Run some Python code")
+    parser.add_argument("-C", help="config-settings", action="append", default=[])
     args, remaining = parser.parse_known_args(session.posargs)
 
     tmp_dir = Path(session.create_tmp())
@@ -298,6 +299,7 @@ def downstream(session: nox.Session) -> None:
             "--skip-dependency-check",
             "--wheel",
             ".",
+            *(f"-C{x}" for x in args.C),
         )
         if args.code:
             session.error("Must use editable install for code at the moment")

src/scikit_build_core/build/wheel.py

@@ -505,7 +505,7 @@ def _build_wheel_impl_impl(
                 raise AssertionError(msg)
 
     wheel_filename: str = wheel.wheelpath.name
-    rich_print("{green}***", f"{{bold}}Created{{normal}} {wheel_filename}...")
+    rich_print("{green}***", f"{{bold}}Created{{normal}} {wheel_filename}")
     if settings.messages.after_success:
         rich_print(settings.messages.after_success)
     return WheelImplReturn(