esys-gitlog

Python implementation of git elog. The distribution name is esys-gitlog. The import package is esys_gitlog. The installed command is git-elog, so Git can run git elog.

The shared contract lives in esys-gitlog-spec. This repository carries that contract in Python. It does not define a second one.

Smoke

pip install .
git elog --help
git elog --json

--json writes one QA report document to stdout. The first skeleton returns an empty commits array.

Release / publish

Tag-driven CI publishes to GitLab Package Registry, TestPyPI, then PyPI (Deckicorn-style ADR-0009 flow). See docs/release-pipeline.md.

python scripts/publish_release.py --dry-run --bump patch
python scripts/build_package.py
python scripts/smoke_install_package.py --dist dist --expected-version 0.1.0

Preferences and profiles

Layered tool preferences (user → .tools/esys/esys-gitlog/ → .tools_local/…) and named profiles follow root SADR-0009 / SADR-0010 and contract CADR-0012.

git-elog --preferences path.json   # preference overlay
git-elog --profile acme            # built-in or profiles/acme.json
git-elog --config path/profile.json  # one-off profile file
git-elog preferences detect        # probe jira/gh/glab/git remote; write missing user keys

Standalone binary (optional)

The primary install remains the wheel + git-elog console script. For a frozen one-file binary (for example Cursor esysGitlog.executablePath without a Python env on PATH):

python scripts/build_standalone.py

Output: dist/git-elog.exe (Windows) or dist/git-elog (Linux/macOS). Build on the OS you need — this does not cross-compile.

• Architecture
• ADRs
• ASRs
• Implementation plan