Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alanshaw/david
:eyeglasses: Node.js module that tells you when your package npm dependencies are out of date.
https://github.com/alanshaw/david
Last synced: about 2 months ago
JSON representation
:eyeglasses: Node.js module that tells you when your package npm dependencies are out of date.
- Host: GitHub
- URL: https://github.com/alanshaw/david
- Owner: alanshaw
- License: mit
- Created: 2013-01-21T20:34:40.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T10:06:02.000Z (almost 2 years ago)
- Last Synced: 2024-05-16T18:13:08.988Z (4 months ago)
- Language: JavaScript
- Homepage: https://david-dm.org
- Size: 470 KB
- Stars: 964
- Watchers: 17
- Forks: 82
- Open Issues: 40
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome-npm - david - Check if your package dependencies are out of date. (Packages / Other)
- awesome-nodejs-cn - David - 当 npm 软件包中的依赖过时通知你 (包 / 命令行程序)
- awesome-nodejs-cn - David - **star:965** 告诉你包的 npm 依赖项何时过期 (包 / 命令行程序)
- awesome-starred-test - alanshaw/david - :eyeglasses: Node.js module that tells you when your package npm dependencies are out of date. (JavaScript)
- awesome-npm - david - Check if your package dependencies are out of date. (Packages / Other)
- awesome-nodejs - David - Tells you when your package npm dependencies are out of date. (Packages / Command-line apps)
- awesome-nodejs - david - Node.js module that tells you when your package npm dependencies are out of date. - ★ 846 (Command-line apps)
- awesome-node - David - Tells you when your package npm dependencies are out of date. (Packages / Command-line apps)
- awesome-nodejs-cn - David - 告诉您您的软件包npm依赖项何时过时. (目录 / 命令行应用)
- awesome-nodejs - david - 检测 npm 依赖是否过时 (Uncategorized / Uncategorized)
README
Node.js module that tells you when your package npm dependencies are out of date.
## Getting Started
Install [Node.js](http://nodejs.org/).
Install david:
```sh
cd /your/project/directory
npm install david
```
Use:
```javascript
var david = require('david');
// Your package.json
var manifest = {
name: 'xxx',
dependencies: {
'aaa': '~0.0.0',
'bbb': '~0.0.0'
},
devDependencies: {
'yyy': '~0.0.0',
'zzz': '~0.0.0'
}
};
david.getDependencies(manifest, function (er, deps) {
console.log('latest dependencies information for', manifest.name);
listDependencies(deps);
});
david.getDependencies(manifest, { dev: true }, function (er, deps) {
console.log('latest devDependencies information for', manifest.name);
listDependencies(deps);
});
david.getUpdatedDependencies(manifest, function (er, deps) {
console.log('dependencies with newer versions for', manifest.name);
listDependencies(deps);
});
david.getUpdatedDependencies(manifest, { dev: true }, function (er, deps) {
console.log('devDependencies with newer versions for', manifest.name);
listDependencies(deps);
});
david.getUpdatedDependencies(manifest, { stable: true }, function (er, deps) {
console.log('dependencies with newer STABLE versions for', manifest.name);
listDependencies(deps);
});
david.getUpdatedDependencies(manifest, { dev: true, stable: true }, function (er, deps) {
console.log('devDependencies with newer STABLE versions for', manifest.name);
listDependencies(deps);
});
function listDependencies(deps) {
Object.keys(deps).forEach(function(depName) {
var required = deps[depName].required || '*';
var stable = deps[depName].stable || 'None';
var latest = deps[depName].latest;
console.log('%s Required: %s Stable: %s Latest: %s', depName, required, stable, latest);
});
}
```
Both `getDependencies` and `getUpdatedDependencies` return an object result,
whose keys are package names. The values are objects which contain the following properties:
* `required` - The version required according to the manifest
* `stable` - The latest stable version available
* `latest` - The latest version available (including build and patch versions)
## CLI
If you install David globally with `npm install -g david`, you can run `david`
in your project directory to see which dependencies are out of date.
You can also run `david --global` to see your outdated global dependencies.
### Update to latest
To update all your project dependencies to the latest **stable** versions,
and save to your `package.json`, run:
```sh
david update
```
To update a particular project dependency to the latest **stable** version,
and save to your `package.json`, run:
```sh
david update package-name
```
You can also update global dependencies to latest versions:
```sh
david update --global
```
To update all your project dependencies to the latest versions
(including unstable versions), pass the `--unstable` flag:
```sh
david update --unstable
```
### Alternate registry
```sh
david update --registry http://registry.nodejitsu.com/
```
### Non-npm and SCM (Git) dependencies
If you have dependencies that are not published to npm, david will print a warning message by default. To throw an error and exit, pass the `error404` option:
```sh
david --error404
```
If using david programmatically, pass `error: {E404: true}` in the options object.
If you have dependencies whose versions are SCM URLs, david will print a warning message by default. To throw an error and exit, pass the `errorSCM` option:
```sh
david --errorSCM
```
If using david programmatically, pass `error: {ESCM: true}` in the options object.
### Specify package.json path
Use `-p, --package` to specify the path to your package.json.
### Ignore dependencies
To tell david to ignore dependencies, add a `david.ignore` property to your `package.json` which lists the dependencies david should ignore. If using david programmatically you can also pass this as an option. Globs are also supported. e.g.
**package.json**
```json
{
"david": {
"ignore": ["async", "underscore", "@types/*"]
}
}
```
---
