Go to file
2022-09-26 00:17:29 +02:00
.github/workflows ci update 2022-07-21 05:25:54 +02:00
fixtures support updating yarn 'resolutions' field, fixes #51 2020-10-21 20:22:26 +02:00
.editorconfig misc tweaks 2022-08-25 01:13:46 +02:00
.eslintrc compile to esm, remove babel, update deps 2021-09-11 13:04:10 +02:00
.gitattributes enable multi-os travis 2019-08-20 21:49:57 +02:00
.gitignore compile to esm, remove babel, update deps 2021-09-11 13:04:10 +02:00
.ignore bundle version into script 2022-09-26 00:17:29 +02:00
.npmrc switch to npm 2021-08-23 09:44:25 +02:00
jest.config.js update deps 2021-10-14 14:03:35 +02:00
LICENSE tweaks 2017-12-03 12:21:06 +01:00
Makefile bundle version into script 2022-09-26 00:17:29 +02:00
package-lock.json bundle version into script 2022-09-26 00:17:29 +02:00
package.json bundle version into script 2022-09-26 00:17:29 +02:00
README.md add size badge 2022-09-25 18:58:26 +02:00
screenshot.png tweak screenshot 2020-07-14 23:05:32 +02:00
test.js bundle version into script 2022-09-26 00:17:29 +02:00
updates.js bundle version into script 2022-09-26 00:17:29 +02:00

updates

updates is a CLI tool which checks for npm dependency updates of the current project and optionally updates package.json. It is highly configurable and is typically able to complete in less than a second.

Usage

# install globally
npm i -g updates

# or install locally as a devDependency and run via `npx updates`
npm i -D updates

Then, check for new updates:

updates

When changes are satisfactory, update package.json and reinstall modules:

updates -u && npm i

To only reinstall modules when updates are available:

updates -uU && npm i

On a CI, it might be desireable to fail a build when updates are available:

updates -E

Options

See --help or below for the available options. Option that take multiple arguments can take them either via comma-separated value or by specifying the option multiple times. If an option has a optional pkg argument but none is given, the option will be applied to all packages instead.

usage: updates [options]

  Options:
    -u, --update                       Update versions and write package.json
    -p, --prerelease [<pkg,...>]       Consider prerelease versions
    -R, --release [<pkg,...>]          Only use release versions, may downgrade
    -g, --greatest [<pkg,...>]         Prefer greatest over latest version
    -i, --include <pkg,...>            Include only given packages
    -e, --exclude <pkg,...>            Exclude given packages
    -t, --types <type,...>             Check only given dependency types
    -P, --patch [<pkg,...>]            Consider only up to semver-patch
    -m, --minor [<pkg,...>]            Consider only up to semver-minor
    -d, --allow-downgrade [<pkg,...>]  Allow version downgrades when using latest version
    -E, --error-on-outdated            Exit with code 2 when updates are available and 0 when not
    -U, --error-on-unchanged           Exit with code 0 when updates are available and 2 when not
    -r, --registry <url>               Override npm registry URL
    -G, --githubapi <url>              Override Github API URL
    -f, --file <path>                  Use given package.json file or module directory
    -S, --sockets <num>                Maximum number of parallel HTTP sockets opened. Default: 96
    -j, --json                         Output a JSON object
    -c, --color                        Force-enable color output
    -n, --no-color                     Disable color output
    -v, --version                      Print the version
    -V, --verbose                      Print verbose output to stderr
    -h, --help                         Print this help

  Examples:
    $ updates
    $ updates -u
    $ updates -u -m -e eslint
    $ updates -u -U && rm -rf node_modules && npm i

JSON Output

The JSON output is an object with possible properties results, message and error:

updates -j | jq
{
  "results": {
    "dependencies": {
      "p-map": {
        "old": "3.0.0",
        "new": "4.0.0",
        "info": "https://github.com/sindresorhus/p-map",
        "age": "3 days"
      }
    },
    "devDependencies": {
      "eslint": {
        "old": "6.7.2",
        "new": "6.8.0",
        "info": "https://github.com/eslint/eslint",
        "age": "3 months"
      }
    }
  }
}

© silverwind, distributed under BSD licence