@zackees/soldr 0.9.15 → 0.9.17
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -433,6 +433,26 @@ The same explicit profile settings work for delegates as for maturin; for
|
|
|
433
433
|
example, `pip install . --config-settings profile=release` selects the
|
|
434
434
|
release profile, while an ordinary install uses the fast local `dev` profile.
|
|
435
435
|
|
|
436
|
+
A maturin project that ships a PyO3 extension **and** a Cargo `[[bin]]` in
|
|
437
|
+
one wheel does not need a delegate. maturin packages only one artifact kind
|
|
438
|
+
per wheel, so list the extra bins and soldr builds and stages them after the
|
|
439
|
+
extension:
|
|
440
|
+
|
|
441
|
+
```toml
|
|
442
|
+
[tool.soldr.pep517]
|
|
443
|
+
bundle-bins = [
|
|
444
|
+
{ bin = "mytool", package = "mytool" }, # -> scripts, on PATH
|
|
445
|
+
{ bin = "helper", dest = "platlib/mypkg/_bin" }, # -> site-packages/mypkg/_bin/
|
|
446
|
+
]
|
|
447
|
+
```
|
|
448
|
+
|
|
449
|
+
Each bin is built with `soldr build` under the same target, profile, and cache
|
|
450
|
+
environment as the extension, then added to the wheel with a regenerated
|
|
451
|
+
`RECORD`. `dest` is `<scheme>[/<subdir>]` with scheme `scripts` (default),
|
|
452
|
+
`platlib`, `purelib`, `data`, or `headers`. soldr does not repair a bundled
|
|
453
|
+
bin's shared-library dependencies, so link it statically or give it an rpath.
|
|
454
|
+
`bundle-bins` cannot be combined with `delegate-backend`.
|
|
455
|
+
|
|
436
456
|
The backend also asks soldr to try its fastest supported linker locally. If
|
|
437
457
|
that linker fails with a linker-availability error, soldr retries once with
|
|
438
458
|
the platform linker and remembers the successful fallback in its cache. An
|