grunt-requirejs-dir v0.1.0
grunt-requirejs-dir
Create define blocks for Require JS from a directory containing files.
Getting Started
This plugin requires Grunt ~0.4.5
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. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-requirejs-dir --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-requirejs-dir');
The "requirejs_dir" task
Overview
In your project's Gruntfile, add a section named requirejs_dir
to the data object passed into grunt.initConfig()
.
grunt.initConfig({
requirejs_dir: {
build: {
options: {},
src: 'controllers/examplePage/**/*.js', // Source Files/File
dest: 'controllers/all.js' // This file also has to exist
},
}
});
How it works?
The destination file has to exist. The Default format of a file is like:
define([
'SampleModule1',
//- REQUIRE_DIR_START
// <-- These two markers tell where to include the files.
//- REQUIRE_DIR_END
], function(SampleModule1) {
...
// My Random Code
...
...
...
});
End Result:
define([
'SampleModule1',
//- REQUIRE_DIR_START
'src/defines/sample1.js',
'src/defines/sample2.js',
'src/defines/sample3.js'
//- REQUIRE_DIR_END
], function(SampleModule1) {
...
// My Random Code
...
...
...
});
Usage Examples
Default Options
There are no default options. All you need is Source and Destination. Both Source and Destination have to exist.
grunt.initConfig({
requirejs_dir: {
build: {
src: 'playground/defines/**/*.js',
dest: 'tmp/default.js'
}
}
});
Options
options.quot
Type: String
Default value: '
Quote mark to be used when requiring the files.
options.endComma
Type: Boolean
Default value: false
To indicate if a terminating comma is needed. Use it in the case when the Required Files are inserted in the middle.
options.startDelimiter
Type: String
Default value: //- REQUIRE_DIR_START
Custom Start Flag
options.endDelimiter
Type: String
Default value: //- REQUIRE_DIR_END
Custom End Flag
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
Release History
(Nothing yet)