repogap 0.1.0

Zero-dependency CLI to check a repository for missing files and manifest fields — README, LICENSE, .gitignore, CHANGELOG, and package metadata.

repogap

Zero-dependency CLI to check a repository for missing files and manifest fields — before you open-source it, add CI, or hand it off.

$ repogap

  ✓ README.md
  ✓ LICENSE
  ✓ .gitignore
  ! CHANGELOG  missing (recommended)

  pyproject.toml
    ✓ name         my-tool
    ✓ version      1.0.0
    ✗ description  missing or empty
    ✓ license      MIT

repogap: drift detected — 1 error, 1 warning

Install

pip install repogap

No dependencies. Python ≥ 3.8 required.

Usage

repogap [options] [dir]

Option	Description
--strict	Treat warnings as errors (exit 1)
--no-changelog	Skip CHANGELOG check
--no-fields	Skip manifest field checks
--json	Machine-readable output
--version	Print version
--help	Show help

Exit codes: 0 clean · 1 issues found · 2 error

CI

- name: Check repo hygiene
  run: pip install repogap && repogap

For the Node.js counterpart, see repogap.

License

MIT