Metadata-Version: 2.4
Name: gh-actions-updater
Version: 0.1.2
Summary: Fast GitHub Actions reference scanner and updater
Author-email: Na'aman Hirschfeld <nhirschfeld@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/Goldziher/gh-actions-updater
Project-URL: Repository, https://github.com/Goldziher/gh-actions-updater.git
Project-URL: Issues, https://github.com/Goldziher/gh-actions-updater/issues
Keywords: github-actions,workflow,ci,cli,updater
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: certifi>=2024.7.4

# gh-actions-updater

PyPI package for the `gau` Rust CLI.

```bash
pip install gh-actions-updater
gau --help
```

Run without installing into the current environment:

```bash
uvx --from gh-actions-updater gau --check .
uvx --from gh-actions-updater gau --init
```

Common usage:

```bash
gau --init
gau --check .
gau --update --diff .
gau --latest-hash --update .
gau -r ~/workspace --check
```

The package name is `gh-actions-updater`; the installed command is `gau`.
The Python wrapper downloads the matching `gau` binary from GitHub Releases on
first use, verifies the release checksum, and caches it under the user's cache
directory. Set `GH_ACTIONS_UPDATER_BINARY` to use a local binary instead.

Configuration lives in `.gh-actions-updater.toml`. Generate one with:

```bash
gau --init
gau --init --recursive --force
```

Useful flags:

- `--cache-ttl <DURATION>`: `15m`, `6h`, `7d`, `0`, or `never`
- `--no-cache`: disable cache reads and writes
- `--refresh-cache`: force fresh metadata
- `-r, --recursive`: scan nested repositories/workspaces
- `--threads <N>`: override Rayon available-core default
- `--format json`: machine-readable output

Skip specific updates with config:

```toml
[update]
exclude = ["actions/checkout", "owner/repo/.github/workflows/deploy.yml@v*"]
```

Or inline:

```yaml
- uses: actions/checkout@v4 # gau: ignore
```

See the repository README for the complete CLI and configuration reference.
