viv

viv outdated

Lists installed packages that have a newer version available (show --latest --outdated).

Usage

List installed packages with a newer version available (`show --latest --outdated`)

Usage: viv outdated [OPTIONS] [PACKAGE]

Arguments:
  [PACKAGE]  Package to inspect (an exact name, no wildcard support)

Options:
  -D, --direct                     Only packages required directly by the root package
  -v, --verbose                    Raise logging to debug
      --cache-dir <CACHE_DIR>      Store location (default `$XDG_CACHE_HOME/vivace`, or `~/.cache/vivace`)
      --no-dev                     Skip `require-dev` packages
      --locked                     Read `composer.lock` instead of `vendor/composer/installed.json`
      --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)
  -M, --major-only                 Only major SemVer-compatible updates
  -m, --minor-only                 Only minor SemVer-compatible updates
  -p, --patch-only                 Only patch SemVer-compatible updates
      --strict                     Exit `1` when an outdated package is found
      --ignore <IGNORE>            Package name globs (`*` wildcard) to leave out of the report
      --format <FORMAT>            Output format [default: text] [possible values: text, json]
  -d, --project-dir <PROJECT_DIR>  Project directory holding `composer.json` [default: .]
  -h, --help                       Print help

Reads and writes

  • Reads: vendor/composer/installed.json, composer.json, and fetches each repository's metadata over the network (unless --offline); reads the store under $XDG_CACHE_HOME/vivace for cached metadata.
  • Writes: nothing; prints its report.

Exit codes

  • 0 — no installed package is outdated.
  • 1 — at least one installed package has a newer version available, or a filesystem/network error occurred.

See also

viv show, viv audit

Edit this page on GitHub