putitoutthere 0.1.41 → 0.1.43

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.
Files changed (2) hide show
  1. package/README.md +34 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -55,7 +55,10 @@ Valid bumps: `patch`, `minor`, `major`, `skip`. On push to `main`, the
55
55
  changed paths, then `putitoutthere publish` per matching package. Tags are
56
56
  `{name}-v{version}`.
57
57
 
58
- No trailer → no release, even if code changed. That's the point.
58
+ The trailer is optional. By default, any package whose `paths` matched
59
+ changed files cascades at `patch`. Use `release: minor` / `release: major`
60
+ to override the bump, or `release: skip` to suppress the release for that
61
+ commit.
59
62
 
60
63
  ## Worked example: polyglot
61
64
 
@@ -92,6 +95,36 @@ A change to `packages/rust/` cascades: the crate ships, and the Python + npm
92
95
  wrappers ship on top (bumped to match). A change to only the TS shim ships
93
96
  just the npm package.
94
97
 
98
+ ## Library shapes
99
+
100
+ End-to-end walkthroughs — config + `release.yml` + prerequisites + gotchas —
101
+ for the common shapes. Pick the one that matches your repo:
102
+
103
+ **Single-package**
104
+
105
+ - [Python library](./docs/guide/shapes/python-library.md) — one `pyproject.toml` to PyPI
106
+ - [npm library](./docs/guide/shapes/npm-library.md) — one `package.json` to npm
107
+ - [Rust crate](./docs/guide/shapes/rust-crate.md) — one `Cargo.toml` to crates.io
108
+
109
+ **Multi-package workspaces**
110
+
111
+ - [Rust workspace](./docs/guide/shapes/rust-workspace.md) — multiple crates with `depends_on` cascade
112
+ - [npm workspace](./docs/guide/shapes/npm-workspace.md) — multiple npm packages, shared dependency graph
113
+
114
+ **Rust core, multi-registry**
115
+
116
+ - [Rust + PyO3 wheels](./docs/guide/shapes/rust-pyo3.md) — crate + PyPI (no napi)
117
+ - [Rust + napi npm](./docs/guide/shapes/rust-napi.md) — crate + npm family (no PyPI)
118
+ - [Polyglot Rust library](./docs/guide/shapes/polyglot-rust.md) — all three registries from one core
119
+ - [Python wheels with C extensions](./docs/guide/shapes/python-cibuildwheel.md) — `cibuildwheel` for the `pillow`/`lxml`/`numpy` shape
120
+
121
+ **Distribution patterns**
122
+
123
+ - [Bundled-CLI npm family](./docs/guide/shapes/bundled-cli.md) — compiled CLI shipped as an npm per-platform family
124
+ - [Dual-family npm (CLI + napi)](./docs/guide/shapes/dual-family-npm.md) — one library with both an addon and a binary
125
+
126
+ Full index at [`docs/guide/shapes/`](./docs/guide/shapes/).
127
+
95
128
  ## Trusted publishers
96
129
 
97
130
  Preferred over long-lived tokens. One-time setup per registry:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "putitoutthere",
3
- "version": "0.1.41",
3
+ "version": "0.1.43",
4
4
  "description": "Polyglot release orchestrator for crates.io, PyPI, and npm",
5
5
  "license": "MIT",
6
6
  "repository": {