grunt-contrib/docs/helpers.md

A collection of common grunt tasks.

# Helpers

Several helpers are included as part of grunt-contrib, often to help improve consistency between tasks.

## Included Helpers

### Options
> Contributed By: [Tyler Kellen](/tkellen) (@tkellen)

#### Overview

This helper will retrieve an options object from the global options.task key. If a subtask has been defined, data in options.task.subtask can override keys in options.task. Finally, an options object defined directly in the task key will override all.

#### Parameters

##### data

This parameter is used to find out the current task, commonly passed ```this``` from within tasks.

##### defaults

This parameter allows developers to define sensible default options that are set if user neglected to set them.

#### Usage

```javascript
var options = grunt.helper("options", this, {fallback: true}); // loads options for current task
```

#### Config


```javascript
options: {
  task: {
    param: 'default',
    subtask: {
      param: 'override default'
    }
  }
},

task: {
  subtask: {
    options: {
      param: 'override all'
    }
  }
}
```