Metadata-Version: 2.4
Name: repogap
Version: 0.1.0
Summary: Zero-dependency CLI to check a repository for missing files and manifest fields — README, LICENSE, .gitignore, CHANGELOG, and package metadata.
Author: yyfjj
License: MIT
Project-URL: Homepage, https://github.com/jjdoor/repogap-py
Project-URL: Repository, https://github.com/jjdoor/repogap-py
Project-URL: Issues, https://github.com/jjdoor/repogap-py/issues
Keywords: repo,lint,hygiene,readme,license,gitignore,changelog,package,cli,devops,ci
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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

```bash
pip install repogap
```

No dependencies. Python ≥ 3.8 required.

## Usage

```bash
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

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

For the Node.js counterpart, see [repogap](https://github.com/jjdoor/repogap).

## License

MIT
