Repository navigation
Commit 89c609c
docs(gix): document release setup and native conversion gaps
The optional backend needs reproducible installation instructions and an
explicit record of supported operations and upstream limitations.
Add `doc/gix-backend.md` and link it from the README. Explain automatic extra
selection, installation of the official `GixPython==0.1.0` PyPI release with an
existing interpreter, offline installation tests using cached wheels, separate
CLI/native environments, operation reporting, and remaining CLI cases.
Record 19 GixPython/Gitoxide follow-ups with reproduction details, distinguishing
confirmed mismatches from conservative capability guards.
Preserve the original local-artifact results as historical evidence and identify
the published wheel separately. Its SHA-256 matches PyPI's digest, and the
backend-selection smoke and fresh installation checks passed (3 tests).
The full native suite results recorded for the earlier local artifact do not
claim validation of the published wheel.
Clarify the backend docstring: unsupported capabilities fall back before
mutation; native mutation failures must never trigger a second CLI mutation.
Validation: the dependency change and all 31 descendants passed fast QA on
existing CPython 3.12.14/macOS: Ruff lint/format, pre-commit, mypy, basedpyright,
universal dependency resolution, and fatal lint checks for bundled dependencies.
The user deferred builds, documentation builds, full suites, and downstream
integration jobs after the initial thorough run proved slow. No additional
Python interpreters were installed.1 parent b23a74e commit 89c609c
3 files changed
Lines changed: 237 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -17,7 +17,10 @@ probably the skills to scratch that itch of mine: implement `git` in a way that | |||
| 17 | 17 | If you like the idea and want to learn more, please head over to [gitoxide](https://github.com/Byron/gitoxide), an | |
| 18 | 18 | implementation of 'git' in [Rust](https://www.rust-lang.org). | |
| 19 | 19 | ||
| 20 | - *(Please note that `gitoxide` is not currently available for use in Python, and that Rust is required.)* | ||
| 20 | + The experimental `GitPython[gix]` extra uses the local GixPython bindings for | ||
| 21 | + supported operations, with automatic Git CLI fallback. See the | ||
| 22 | + [local installation, test commands, and conversion ledger](doc/gix-backend.md). | ||
| 23 | + GixPython is not yet available on PyPI. | ||
| 21 | 24 | ||
| 22 | 25 | ## GitPython | |
| 23 | 26 | ||
0 commit comments