Metadata-Version: 2.4
Name: gira-cli
Version: 1.7.0
Summary: Jira-style project flow on GitHub, distributed as the official Go-built gira binary.
Author-email: StatPan <statpan@outlook.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/StatPan/gira#readme
Project-URL: Repository, https://github.com/StatPan/gira
Project-URL: Issues, https://github.com/StatPan/gira/issues
Project-URL: Changelog, https://github.com/StatPan/gira/blob/main/CHANGELOG.md
Keywords: github,jira,cli,project-management,issues,pull-requests,workflow
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# gira-cli

PyPI distribution wrapper for the official Go-built `gira` binary.

This package does not reimplement Gira in Python and does not require Go. The `gira` console command downloads the matching GitHub Release archive on first run, verifies `checksums.txt`, caches the native binary, and then executes it.

```bash
uv tool install gira-cli
gira version
```

or:

```bash
pip install gira-cli
gira version
```

The PyPI package name is `gira-cli` because the `gira` package name is already occupied on PyPI. The installed command is still `gira`.

## Native Binary Cache

The wrapper stores downloaded native binaries under `GIRA_PYPI_CACHE_DIR` when set, otherwise under `~/.cache/gira-cli/<version>`.

Preview and remove stale cached versions after an upgrade:

```bash
gira cache prune --dry-run
gira cache prune --apply
```

The prune command removes only older stable semver release directories. It skips the active version, newer versions, malformed entries, files, symlinks, and any directory containing the current executable. Use `--root PATH` for a custom cache root and `--json` for machine-readable output.

- Repository: https://github.com/StatPan/gira
- Issues: https://github.com/StatPan/gira/issues
- Contact: statpan@outlook.com
