NAME

repomatic prune-caches - Delete the superseded GitHub Actions caches of a key prefix

SYNOPSIS

repomatic prune-caches [OPTIONS]

DESCRIPTION

Delete the GitHub Actions caches a newer save superseded.

A cache step keyed on the run or the commit, with a prefix in its restore-keys, saves a fresh entry on every run and restores the newest previous one. Every older entry is dead weight against the 10 GB quota of the repository until GitHub evicts it, and past the quota GitHub evicts live caches too. This deletes all but the newest --keep entries of each --prefix. Run it after the restore step of the job that saves: the job's own save then adds one more entry.

Needs `actions: write` on the token. A refused deletion and an unreadable listing are reported as warnings: housekeeping never fails the job it runs in.

OPTIONS

--prefix TEXT

Key prefix whose caches to prune, as the step's restore-keys names it. Repeatable.
[required]

--keep INTEGER RANGE

Newest caches of each prefix to leave in place.

--repo TEXT

Repository in owner/repo format. Defaults to $GITHUB_REPOSITORY, then to the GitHub remote of the current clone.

--dry-run / --live

Report what would be done without making changes.

--help / -h

Show this message and exit.

ENVIRONMENT

PRUNE_CACHES_PREFIXES

Key prefix whose caches to prune, as the step's restore-keys names it. Repeatable.

PRUNE_CACHES_KEEP

Newest caches of each prefix to leave in place.

GITHUB_REPOSITORY

Repository in owner/repo format. Defaults to $GITHUB_REPOSITORY, then to the GitHub remote of the current clone.

PRUNE_CACHES_REPO

Repository in owner/repo format. Defaults to $GITHUB_REPOSITORY, then to the GitHub remote of the current clone.

PRUNE_CACHES_DRY_RUN

Report what would be done without making changes.

PRUNE_CACHES__CLICK_DEFAULT_HELP

Show this message and exit.

EXIT STATUS

0

Success.

1

A runtime error, an aborted prompt (Ctrl-D), or a declined confirmation.

2

A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

130

Interrupted with Ctrl-C: the process ends by SIGINT, reported as 130.

EXAMPLES

Preview what a prune of the Linux compile caches would delete

repomatic prune\-caches \-\-dry\-run \-\-prefix nuitka\-linux\-x64\-

Keep the two newest HTTP caches of each runner, as the sync jobs do

repomatic prune\-caches \-\-keep 2 \-\-prefix repomatic\-http\-Linux\-

AUTHORS

Kevin Deldycke