Grunt-Preceptor

Grunt plugin for Preceptor

Table of Contents

• Installation
• Getting Started
• The "preceptor" Task
  • Overview
  • Options
  • Usage Examples
• Third-party libraries
• License

##Installation

Install this module with the following command:

npm install grunt-preceptor

Add the module to your package.json dependencies:

npm install --save grunt-preceptor

Add the module to your package.json dev-dependencies:

npm install --save-dev grunt-preceptor

This plugin requires Grunt.

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins.

Getting Started

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

grunt.loadNpmTasks('grunt-preceptor');

The "preceptor" task

Overview

In your project's Gruntfile, add a section named preceptor to the data object passed into grunt.initConfig().

grunt.initConfig({
  preceptor: {
    your_target: {
      // Target-specific Preceptor options go here.
    },
  },
})

Options

options.ruleBook

Type: Object required

Options that would be otherwise in a rule-book.js or rule-book.json. You can also require the js or json file instead of adding here all the options.

options.profile

Type: String --optional--

Selects a profile in the root of the ruleBook option.

options.subProfile

Type: String --optional--

Selects a sub-profile in the root of the tasks object of the ruleBook option.

Usage Examples

Default Options

You can supply the rule-book file in the options object of a task:

grunt.initConfig({
  preceptor: {
  	ci: {
		options: {
			ruleBook: require('./rule-book.js')
		}
	}
  }
})

Inline Options

You can supply the rule-book file in the options object of a task - in the following case for the preceptor:ci task:

grunt.initConfig({
  preceptor: {
  	ci: {
		options: {
			ruleBook: {
				"configuration": {
					"reportManager": {
						"reporter": [
							{"type": "Spec"},
							{"type": "List", "progress": false}
						]
					}
				},

				"tasks": [
					...
				]
			}
		}
	}
  }
})

Profile and Sub-Profile Options

For multiple configurations, you can supply the profile or sub-profile options:

grunt.initConfig({

  preceptor: {
  
  	ciSmoke: {
		options: {
		
			ruleBook: {
			
				"ci": { // "ci" profile (see example)
				
					"configuration": {
						"reportManager": {
							"reporter": [
								{"type": "Spec"},
								{"type": "List", "progress": false}
							]
						}
					},
	
					"tasks": {
					
						"smoke": [ // "smoke"-test sub-profile (see example)
							...
						]
					}
				}
			}
		}
	}
  }
})

##Third-party libraries

The following third-party libraries are used by this module:

###Dependencies

• preceptor: https://github.com/yahoo/preceptor

###Dev-Dependencies

• grunt: http://gruntjs.com
• chai: http://chaijs.com
• codeclimate-test-reporter: https://github.com/codeclimate/javascript-test-reporter
• coveralls: https://github.com/cainus/node-coveralls
• istanbul: https://github.com/gotwarlost/istanbul
• mocha: https://github.com/visionmedia/mocha
• sinon: http://sinonjs.org
• sinon-chai: https://github.com/domenic/sinon-chai
• yuidocjs: https://github.com/yui/yuidoc

##License

The MIT License

Copyright 2015 Marcel Erz