Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/joefiorini/grunt-es6-module-transpiler
https://github.com/joefiorini/grunt-es6-module-transpiler
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/joefiorini/grunt-es6-module-transpiler
- Owner: joefiorini
- License: mit
- Created: 2013-04-18T02:18:38.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2016-02-20T22:10:43.000Z (over 8 years ago)
- Last Synced: 2024-07-13T06:04:39.334Z (4 months ago)
- Language: JavaScript
- Size: 277 KB
- Stars: 85
- Watchers: 5
- Forks: 22
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE-MIT
Awesome Lists containing this project
- es6-tools - grunt-es6-module-transpiler
README
# grunt-es6-module-transpiler
> A Grunt task for processing ES6 module import/export syntax into one of AMD, CommonJS, YUI or globals using the es6-module-transpiler. Also allows you to temporarily enable ES6 modules for other tasks.
## Getting Started
This plugin requires Grunt `~0.4.1`
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-es6-module-transpiler --save-dev
```
To use add the `transpile` task to your Grunt configuration.
### Using with RequireJS/CommonJS:
```js
grunt.loadNpmTasks('grunt-es6-module-transpiler');
grunt.initConfig({
transpile: {
main: {
type: "cjs", // or "amd" or "yui"
files: [{
expand: true,
cwd: 'lib/',
src: ['**/*.js'],
dest: 'tmp/'
}]
}
}
});
```
### Using with Globals
```js
grunt.loadNpmTasks('grunt-es6-module-transpiler');
grunt.initConfig({
transpile: {
main: {
type: "globals",
imports: { bar: "Bar" },
files: {
'tmp/globals.js': ['test/fixtures/input.js'],
'tmp/globals-bar.js': ['test/fixtures/bar.js']
}
}
}
});
```
### Transpiling your files
Manually run the task with `grunt transpile` or include it as part of your build task:
```js
grunt.registerTask('build', ['clean', 'transpile', '...']);
```
### Resources
- [Using Grunt & the ES6 Module Transpiler](http://www.thomasboyt.com/2013/06/21/es6-module-transpiler) by Thomas Boyt
### Caveat
The module transpiler forces strict mode; there is no option to turn this off. If, like me, you typically use Mocha with [Chai](http://chaijs.com), this can cause a problem because Chai attempts to access `arguments.callee`, which violates strict mode. I switched to using [expect.js](https://github.com/LearnBoost/expect.js/) and it works great.
## 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](http://gruntjs.com/).
## Release History
10/07/2013 v0.5.0 - Support for v0.3.0 of es6-module-transpiler; removes transpile:enable task as the feature no longer exists
07/09/2013 v0.4.1 - Improved windows support when using amd
07/09/2013 v0.4.0 - Update to v0.2.0 of es6-module-transpiler for new syntax support
05/28/2013 v0.3.0 - Add callback for dynamically specifying AMD modulename
05/02/2013 v0.2.0 - Fixes for globals, CoffeeScript, transpile:enable task for node scripts
04/17/2013 v0.1.0 - Initial release, supports basic transpile task