pygitx 0.1.2

Cross-platform Git history access via Rust with a Python API

Cross-platform Git history access implemented in Rust with a Python API via PyO3 and libgit2.

Highlights

• Fast Git history access via libgit2 with a lightweight Python wrapper.
• Repo helpers for HEAD info, revision parsing, commit listing, and branch/tag lookup.
• History rewriting tools: amend messages, rewrite author/committer, reword arbitrary commits, squash, rebase (pick-only), drop commits, and purge paths.
• All rewrites return a RewriteResult with mappings and ref updates.

Install

pip install pygitx

Python usage

import pygitx
from pathlib import Path

repo = pygitx.open_repo(Path("."))
head = repo.head()
print("HEAD:", head.id if head else "None")

# Resolve a revision (branch/tag/oid) to a hex id
print("main ->", repo.rev_parse("main"))

for c in repo.list_commits(max=5):
    print(f"{c.id[:7]} {c.author} <{c.email}> {c.summary}")

Example script: examples/demo.py (run with --help to see options).

Documentation

Full API and usage docs live in docs/ (Sphinx). Build locally with:

make docs

Or browse the published docs if available in your environment.

Development

• Tests without Python runtime: cargo test
• Python-facing tests: cargo test --features python-tests
• Make targets: make venv, make install, make develop, make release, make docs, make test