You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit e1b32ee
Browse filesBrowse the repository at this point in the historyBrowse files
feat: report local Gitoxide build provenance and document release migration
Read the selected checkout HEAD for each Python development build and
pass it through build.rs with Cargo environment rerun tracking. Restore
the public pinned revision in packaged mode, including when the local
selection environment is still set. Document that uncommitted edits are
compiled without assigning them a new revision.
Record persistent local-development rules and the later crates.io
migration prerequisites while retaining macOS binary wheels and an
independent source distribution. Add changelog and validation records.
Validation: five build-helper checks pass. Local ordinary and GIL-disabled
CPython 3.14.7 each pass 105 integration tests (two and one expected skips).
Restored packaged mode passes 105 tests and reports the public pin. An
independently extracted sdist builds offline with C/C++ compilers disabled;
its installed ABI3 wheel passes 105 tests, artifact/provenance checks, and
has no developer dependency paths or cached development lockfiles. Rust
formatting, clippy with warnings denied, and all seven unit tests pass.
Copy file name to clipboardExpand all lines: agents.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,6 +19,8 @@
19
19
- Declare free-threading support only when the implementation satisfies it. Test a shared repository across threads with the GIL disabled.
20
20
- All supported configurations must build without compiling C or C++ dependencies. Use pure-Rust hashing/compression and reqwest/rustls with Graviola; do not accidentally enable a C-backed TLS provider through default dependency features.
21
21
- Default builds include both SHA-1 and SHA-256 and broad native capability groups. Keep important build choices explicit and test the supported reduced configurations.
22
+
- Python development may opt into a local Gitoxide checkout with `GIXPYTHON_GITOXIDE_PATH` or `etc/build.py --gitoxide-path`; `--packaged` forces release dependencies. Local mode requires Cargo 1.97+, uses an ignored separate lockfile and command-local patches, and must never edit the packaged manifest/lockfile or silently fall back. Direct Cargo and maturin builds keep release dependencies.
23
+
- Continue local development against the prepared checkout after the first release. Migrate package dependencies to crates.io once compatible published releases include all prerequisites; keep distributing macOS binary wheels and an sdist. Never commit machine-specific dependency paths. Local build provenance reports checkout HEAD, including uncommitted edits in the build without claiming they have a new revision.
22
24
- Follow current PyO3 APIs and ownership rules. Avoid `unsafe` and production `unwrap()`; justify any unavoidable exception locally.
23
25
- Progress uses a pollable `Progress.snapshot()` API and interruption uses `CancellationToken` plus normal Python exceptions. Do not add callbacks or install process-wide signal handlers. Do not call Python while holding native state locks.
Copy file name to clipboardExpand all lines: docs/implementation-plan.md
+9Lines changed: 9 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,6 +41,15 @@ Small necessary upstream changes may be prepared in the existing local `gitoxide
41
41
42
42
Do not commit machine-specific dependency paths. Record local overrides and upstream prerequisites explicitly. Publicly reproducible wheels and source distributions require all dependencies to be available independently of that local worktree.
43
43
44
+
Local Python build selection is implemented through `GIXPYTHON_GITOXIDE_PATH`,
45
+
`--gitoxide-path`, and `--packaged` in `etc/build.py`. Cargo 1.97+ provides an ignored
46
+
development lockfile; command-local patches build directly from checkout edits
47
+
without changing packaged inputs. Local provenance reports checkout HEAD.
48
+
Direct Cargo checks and maturin artifacts continue using release dependencies.
49
+
After upstream integration, package builds will use compatible crates.io releases
50
+
and retain macOS wheels plus an sdist. See [development instructions](../DEVELOPMENT.md)
51
+
for the switch and migration requirements.
52
+
44
53
## Acceptance
45
54
46
55
Every completed capability has a Python integration check and accurate type/documentation coverage. Checks use disposable repositories and isolated Git configuration; both hash kinds and relevant feature selections are exercised. Shared-handle concurrency, GIL-disabled execution, partial iterator consumption, interruption, stale-reference rejection, and artifact installation are project requirements.
0 commit comments