updtr

Update outdated npm modules with zero pain™

Based on npm outdated, updtr installs the latest version and runs npm test for each dependency. In case the test succeeds, updtr saves the new version number to your package.json. Otherwise, updtr rolls back the conflicting update.

Additionally, it will use yarn instead of npm when a yarn.lock file is present in your project.

Made by Peerigon.

Installation

npm install -g updtr

Options

--use -u

Specify the package manager to use:

• npm
• yarn

Updtr tries to guess the package manager by looking for a yarn.lock file. If there is one in process.cwd(), it will use yarn. Setting this option overrides that default.

--exclude --ex

Space separated list of module names that should not be updated.

--update-to --to

• latest (default): update all packages to the latest version number
• non-breaking: update all packages to the latest version number that does not conflict with the installed version number
• wanted: update all packages to the latest version number that does not conflict with the version number as specified in the package.json

--save -s

Specify how updated versions should be saved to the package.json:

• smart (default): tries to preserve the current style. Falls back to caret if the style cannot be preserved.
• caret: saves ^x.y.z
• exact: saves x.y.z

--reporter -r

Choose a reporter for the console output:

• dense (default): See screenshot
• basic: Uses console.log for output, no need for a TTY (e.g when running on CI)
• none: No console output

--test -t

Specify a custom test command. Surround with quotes:

updtr -t "mocha -R spec"

--test-stdout --out

Show test stdout if the update fails.

--registry --reg

Specify a custom registry to use.

Please note: yarn does not support to set a custom registry via command line. Use a .npmrc file to achieve this. See also yarnpkg/yarn#606.

--version

Show the current updtr version.

--help

Show all commands.

License

Unlicense

Sponsors

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

4.1.0 (2024-07-03)

Features

• Introduce interactive update (d3975e2)

4.0.0 (2021-08-20)

⚠ BREAKING CHANGES

• No longer supporting node versions 6-11

Features

• update dependencies and remove vulnerabilities (#86) (eb7a1ef)

• upgrade node version to v12 (2e29ef0)

3.1.0 (2018-10-04)

Features

• Add basic reporter (#78) (59885d3)

3.0.0 (2018-10-03)

Bug Fixes

• Respect package.json indentation (#77) (e766fb0), closes #68

Fix

• Stdout output parsing from yarn (ff56fbb)

BREAKING CHANGES

• Removed official Node 4 support. It may still work, but now you're on your own.

2.0.0 (2017-06-20)

Features

• Rewrite (7ffc10a), closes #14 #47 #46 #13 #51 #58

BREAKING CHANGES

• New and changed CLI options

  --use, -u             Specify the package manager to use  [choices: "npm", "yarn"] [default: "npm"]
  --exclude, --ex       Space separated list of module names that should not be updated  [array]
  --update-to, --to     Specify which updates you want to install  [choices: "latest", "non-breaking", "wanted"] [default: "latest"]
  --save, -s            Specify how updated versions should be saved to the package.json  [choices: "smart", "caret", "exact"] [default: "smart"]
  --reporter, -r        Choose a reporter for the console output  [choices: "dense", "none"] [default: "dense"]
  --test, -t            Specify a custom test command. Surround with quotes.
  --test-stdout, --out  Show test stdout if the update fails  [boolean]
  --registry, --reg     Specify a custom registry to use
  --version             Show version number  [boolean]
  --help                Show help  [boolean]

1.0.0 (2017-04-01)

Bug Fixes

• npm: ignore error status 1 on npm outdated (ec4057c)

Features

• Use yarn package manager when available (bcca7ce)