[![Dependency Status](https://david-dm.org/herrmannplatz/grunt-david.svg)](https://david-dm.org/herrmannplatz/grunt-david)

# grunt-david

> Watching your node.js dependencies.



## Getting Started
This plugin requires Grunt `~0.4.0`

If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

```shell
npm install grunt-david --save-dev
```

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

```js
grunt.loadNpmTasks('grunt-david');
```




## David task
_Run this task with the `grunt david` command._

Keep your node.js dependencies up to date.
### Options

#### package
Type: `String`
Default: `undefined`

Optionally specify the `package.json` path, `david` uses `./package.json` by default.

#### update
Type: `Boolean`
Default: `false`

Turn on if you want to update all your project dependencies to the latest stable versions.

#### unstable
Type: `Boolean`
Default: `false`

Turn on if you want to update all your project dependencies to the latest versions (including unstable versions)

#### registry
Type: `String`
Default: `undefined`

Use an alternate registry

#### error404
Type: `Boolean`
Default: `false`

Turn on to abort if David finds any dependencies that are not published to npm. Error messages are then included in the report.

#### errorSCM
Type: `Boolean`
Default: `false`

Turn on to abort if David finds any dependencies that are SCM URLs. Error messages are then included in the report.

#### ignore
Type: `Array|String`
Default: `undefined`

Tell david to ignore dependencies.

### Usage examples

#### Update dependencies

```js
// Project configuration.
grunt.initConfig({
  david: {
    all: {
      options: {
        update: true,
        ignore: ['grunt']
      }
    }
  }
});
```