viv cache

Manages viv's shared store: prune stale entries, check its size, or remove it outright.

Usage

Cache maintenance: prune stale entries, or remove the cache outright

Usage: viv cache [OPTIONS] <COMMAND>

Commands:
  prune  Remove stale buckets, orphan temp dirs, orphan `.ok` markers, and any archive no dist pointer references any more
  clean  Remove the whole cache after confirming it looks like a vivace cache (only our own bucket names, or empty); refuses otherwise
  size   Print archive and dist-pointer counts and total size
  help   Print this message or the help of the given subcommand(s)

Options:
  -v, --verbose                Raise logging to debug
      --cache-dir <CACHE_DIR>  Store location (default `$XDG_CACHE_HOME/vivace`, or `~/.cache/vivace`)
      --offline                Fail fast on any request instead of connecting: install errors, naming every package not already in the store; update solves from cached repository metadata only, erroring on an uncached package. Also set by `COMPOSER_DISABLE_NETWORK` (any value but unset, empty or `0`; Composer's own git-priming `prime` value is not special-cased here, since neither `install` nor `update` touch a git source)
  -h, --help                   Print help

viv cache prune

Removes stale buckets, orphan temp directories, orphan .ok markers, and any archive no dist pointer references any more. --older-than DAYS also removes dist pointers not installed from in that many days, before sweeping the archives that leaves unreferenced.

Remove stale buckets, orphan temp dirs, orphan `.ok` markers, and any archive no dist pointer references any more

Usage: viv cache prune [OPTIONS]

Options:
      --older-than <DAYS>      Also remove dist pointers not installed from in this many days (touched on every `viv install` hit), before sweeping archives that leaves unreferenced
  -v, --verbose                Raise logging to debug
      --cache-dir <CACHE_DIR>  Store location (default `$XDG_CACHE_HOME/vivace`, or `~/.cache/vivace`)
      --offline                Fail fast on any request instead of connecting: install errors, naming every package not already in the store; update solves from cached repository metadata only, erroring on an uncached package. Also set by `COMPOSER_DISABLE_NETWORK` (any value but unset, empty or `0`; Composer's own git-priming `prime` value is not special-cased here, since neither `install` nor `update` touch a git source)
  -h, --help                   Print help

viv cache clean

Removes the whole cache, after confirming it looks like a viv cache (only known bucket names, or empty); refuses otherwise.

Remove the whole cache after confirming it looks like a vivace cache (only our own bucket names, or empty); refuses otherwise

Usage: viv cache clean [OPTIONS]

Options:
  -v, --verbose                Raise logging to debug
      --cache-dir <CACHE_DIR>  Store location (default `$XDG_CACHE_HOME/vivace`, or `~/.cache/vivace`)
      --offline                Fail fast on any request instead of connecting: install errors, naming every package not already in the store; update solves from cached repository metadata only, erroring on an uncached package. Also set by `COMPOSER_DISABLE_NETWORK` (any value but unset, empty or `0`; Composer's own git-priming `prime` value is not special-cased here, since neither `install` nor `update` touch a git source)
  -h, --help                   Print help

viv cache size

Prints archive and dist-pointer counts and total size; writes nothing.

Print archive and dist-pointer counts and total size

Usage: viv cache size [OPTIONS]

Options:
  -v, --verbose                Raise logging to debug
      --cache-dir <CACHE_DIR>  Store location (default `$XDG_CACHE_HOME/vivace`, or `~/.cache/vivace`)
      --offline                Fail fast on any request instead of connecting: install errors, naming every package not already in the store; update solves from cached repository metadata only, erroring on an uncached package. Also set by `COMPOSER_DISABLE_NETWORK` (any value but unset, empty or `0`; Composer's own git-priming `prime` value is not special-cased here, since neither `install` nor `update` touch a git source)
  -h, --help                   Print help

Reads and writes

Reads and writes: the store under $XDG_CACHE_HOME/vivace (or --cache-dir).

Exit codes

0 — completed (including clean on an empty or already-clean cache).
1 — a filesystem error, or clean refusing a directory that holds something other than a viv cache.