bramble

Bramble

Is a tool which helps you safely upgrade your NPM dependencies.

Running Bramble will look at each dependency in your package.json, and one by one will ask if you want to update that dependency (with the --prompt flag). If you let it, Bramble will then download the latest version of that dependency, optionally (with the --test flag) running your test suite to check for any breaking changes in the new version. Finally, Bramble will (with the --save flag) write the new version to your package.json.

He's also Ben's cat.

Global Install

npm install -g bramble

Local Install

npm install bramble --save

Usage

Usage: bramble [--save] [--prompt] [--test] [--dev]

  Options:

    -h, --help     output usage information
    -V, --version  output the version number
    -s, --save     save the package.json on a successful install (and optional --test from your package.json
    -t, --test     bramble will run "npm test" (defined in your package.json) for you after successful install of any dependencies.
    -p, --prompt   prompt the user to install/skip and optionally test each dependency that needs updating
    -d, --dev      include flag to also update your devDependencies

Changelog

9 Dec 2015, 1.1.0

• Respect semver options on packages. Previously bramble would just remove "~" or "^" bramble now respects this and applies it to the package. If you need to lock down your dependencies use npm shrinkwrap.