myplanetdigital/gulp-requirejs

Name: gulp-requirejs

Owner: Myplanet

Description: null

Created: 2014-11-12 05:16:53.0

Updated: 2016-10-25 12:35:24.0

Pushed: 2014-11-19 19:02:58.0

Homepage: null

Size: 106

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

gulp-requirejs

Information

A small, simply, very easy wrapper around the require.js optimizer to work with gulp.js

Package	gulp-requirejs
Description	uses require.js's r.js optimizer to combine require.js AMD modules into one file
Node Version	>= 0.4

Installation

Simply add gulp-requirejs as a dev-dependency in your package.json or run

m install --save-dev gulp-requirejs

Usage

Because the require.js optimizer (r.js) is a kind of build system in itself we can't use the gulp.src([...]) syntax at the moment (I might add this in future), instead this wrapper itself emits a pipable stream, holding a 'virtual' file, in which the result of the r.js build process are saved.

The resulting stream can be treated like a regular gulp.src(...) stream.

NOTE: The built in minification/obfuscation is deactivated by default and can not be switched on. Please use a gulp plugin like gulp-uglify for this.

gulp = require('gulp'),
rjs = require('gulp-requirejs');

.task('requirejsBuild', function() {
rjs({
    baseUrl: 'path/to/your/base/file.js',
    out: 'FILENAME\_TO\_BE\_OUTPUTTED',
    shim: {
        // standard require.js shim options
    },
    // ... more require.js options
})
    .pipe(gulp.dest('./delpoy/')); // pipe it to the output DIR

Error handling

gulp-requirejs will emit errors when you don't pass an options object and if the baseUrl or out properties are undefined.

The requiere.js optimizer itself might also emit errors; unfortunately there's no way of catching them elegantly at the moment.

Options

The options object supports the same parameters as the require.js optimizer.