# updates
[![](https://img.shields.io/npm/v/updates.svg?style=flat)](https://www.npmjs.org/package/updates) [![](https://img.shields.io/npm/dm/updates.svg)](https://www.npmjs.org/package/updates) [![](https://api.travis-ci.org/silverwind/updates.svg?style=flat)](https://travis-ci.org/silverwind/updates)
> Fast npm dependency updating tool
`updates` is a CLI tool which checks for npm dependency updates of the current project and optionally updates `package.json`. It is typically able to complete in less than a second.
## Install
```console
$ npm i -g updates
```
# Usage
```
usage: updates [options]
Options:
-u, --update Update package.json
-p, --prerelease [] Consider prerelease versions
-j, --json Output a JSON object
-g, --greatest [] Prefer greatest over latest version
-i, --include Only include given packages
-e, --exclude Exclude given packages
-r, --registry Use a custom registry
-f, --file Use specified package.json file
-c, --color Force-enable color output
-n, --no-color Disable color output
-v, --version Print the version
-h, --help Print this help
Examples:
$ updates
$ updates -u
$ updates -u -e semver
```
## Examples
### Check for updates
```console
$ updates
NAME OLD NEW
chalk 1.3.0 2.3.0
got ^7.0.1 ^8.0.1
minimist ^1.0.0 ^1.2.0
```
### Update package.json
```console
$ updates -u
NAME OLD NEW
chalk 1.3.0 2.3.0
got ^7.0.1 ^8.0.1
minimist ^1.0.0 ^1.2.0
╭────────────────────────╮
│ package.json updated │
╰────────────────────────╯
```
### JSON Output
`updates` can output JSON. The result is always an object with the key `results` and depending on operation, `message` and `error` properties can also be present.
```console
$ updates -j
{
"results": {
"chalk": {
"old": "1.3.0",
"new": "2.3.0"
},
"got": {
"old": "^7.0.1",
"new": "^8.0.1"
},
"minimist": {
"old": "^1.0.0",
"new": "^1.2.0"
}
}
}
```
© [silverwind](https://github.com/silverwind), distributed under BSD licence