@zackees/soldr 0.8.18 → 0.8.20

package/README.md

@@ -18,7 +18,7 @@ Third-party comparison (soldr vs Swatinem/rust-cache vs ...): published from `za
 
 *[performance details](https://zackees.github.io/soldr/)*
 
-Cold builds are a wash; warm and cross-worktree share are where soldr's wrapper architecture pays off. Full historical trend + interactive view: [zackees.github.io/soldr](https://zackees.github.io/soldr/). For the swatinem/rust-cache comparison (GHA target-dir caching, a different layer) see [PERF.md](PERF.md#readme-comparison-bars-issue-785).
+Cold builds are a wash; clean-target reconstruction from a warm compiler cache and cross-worktree sharing are where soldr's wrapper architecture pays off. The README chart's clean-target row intentionally deletes `target/`; it does not claim Cargo's intact-target freshness fast path. Full historical trend + interactive view: [zackees.github.io/soldr](https://zackees.github.io/soldr/). For the swatinem/rust-cache comparison (GHA target-dir caching, a different layer) see [PERF.md](PERF.md#readme-comparison-bars-issue-785).
 
 **Instant tools. Instant builds. One command.**
 
@@ -240,6 +240,50 @@ files touched. What you get over `build-backend = "maturin"`:
 - **Compilation caching** — rustc invocations run under soldr's
   `RUSTC_WRAPPER`, so repeat builds hit the cache.
 
+Local PEP 517 builds use an explicit fast `dev` profile by default:
+`opt-level = 0`, 256 codegen units, line-table debug information, no LTO, and
+incremental compilation. Explicit Maturin/Cargo settings and
+`SOLDR_PEP517_PROFILE` remain authoritative per setting; release pipelines
+should select their release profile explicitly.
+
+Successful wheel and editable builds print a one-line cache and timing summary
+to stderr. Set `SOLDR_PEP517_STATS=off` to silence it; `SOLDR_PEP517_STATS=full`
+(and detected verbose `pip`/`uv` frontends) also prints the complete session
+statistics payload.
+
+Soldr also caches the last successful wheel for each project/build mode under
+`~/.soldr/pep517/wheels/`. Before packaging it scans source and staged-artifact
+metadata (relative path, size, and modification time); an unchanged tree
+hardlinks the cached wheel into pip's requested output directory and skips
+wheel rebuilding/compression. Set `SOLDR_PEP517_WHEEL_CACHE=off` to opt out.
+
+Projects whose packaging backend is not maturin can use soldr as a managed
+wrapper by selecting a delegate in `pyproject.toml`:
+
+```toml
+[build-system]
+requires = ["soldr", "setuptools>=64"]
+build-backend = "soldr"
+
+[tool.soldr.pep517]
+delegate-backend = "setuptools.build_meta"
+```
+
+The delegate receives the normal PEP 517/660 hooks and return values while
+soldr supplies its target, profile, linker, and cache environment. This is
+intended for projects with custom staging such as native CLI scripts plus a
+PyO3 extension. Maturin remains the default when no delegate is configured.
+The same explicit profile settings work for delegates as for maturin; for
+example, `pip install . --config-settings profile=release` selects the
+release profile, while an ordinary install uses the fast local `dev` profile.
+
+The backend also asks soldr to try its fastest supported linker locally. If
+that linker fails with a linker-availability error, soldr retries once with
+the platform linker and remembers the successful fallback in its cache. An
+equivalent later build uses the fallback immediately and prints a warning.
+Set `SOLDR_PEP517_LINKER=none` to disable this policy. An explicit
+`SOLDR_LINKER=fast` is treated as a deliberate choice: it reports the failure
+without silently downgrading to the system linker.
 Note: soldr's own wheel is built with plain `build-backend = "maturin"`,
 not with itself — using soldr as its own build backend created a
 bootstrap cycle where a broken installed soldr made the fix in this

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zackees/soldr",
-  "version": "0.8.18",
+  "version": "0.8.20",
   "description": "Instant Rust tools and builds from one command.",
   "license": "BSD-3-Clause",
   "homepage": "https://github.com/zackees/soldr",