0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-12 00:08:59 +01:00
Bootstrap/Gruntfile.js

469 lines
12 KiB
JavaScript
Raw Normal View History

2014-01-21 01:00:52 +01:00
/*!
* Bootstrap's Gruntfile
* http://getbootstrap.com
* Copyright 2013-2014 Twitter, Inc.
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
*/
2013-12-07 01:51:59 +01:00
module.exports = function (grunt) {
2013-09-18 18:50:02 +02:00
'use strict';
// Force use of Unix newlines
grunt.util.linefeed = '\n';
2013-12-08 11:24:47 +01:00
RegExp.quote = function (string) {
2014-01-17 20:51:53 +01:00
return string.replace(/[-\\^$*+?.()|[\]{}]/g, '\\$&');
};
2014-01-17 20:51:53 +01:00
var fs = require('fs');
2014-01-19 15:04:29 +01:00
var path = require('path');
var generateGlyphiconsData = require('./grunt/bs-glyphicons-data-generator.js');
var BsLessdocParser = require('./grunt/bs-lessdoc-parser.js');
var generateRawFiles = require('./grunt/bs-raw-files-generator.js');
2014-05-13 07:01:29 +02:00
var updateShrinkwrap = require('./grunt/shrinkwrap.js');
// Project configuration.
grunt.initConfig({
// Metadata.
pkg: grunt.file.readJSON('package.json'),
banner: '/*!\n' +
2014-01-28 12:16:13 +01:00
' * Bootstrap v<%= pkg.version %> (<%= pkg.homepage %>)\n' +
' * Copyright 2011-<%= grunt.template.today("yyyy") %> <%= pkg.author %>\n' +
' * Licensed under <%= pkg.license.type %> (<%= pkg.license.url %>)\n' +
2014-01-28 12:16:13 +01:00
' */\n',
jqueryCheck: 'if (typeof jQuery === \'undefined\') { throw new Error(\'Bootstrap\\\'s JavaScript requires jQuery\') }\n\n',
// Task configuration.
clean: {
2014-02-03 06:38:25 +01:00
dist: ['dist', 'docs/dist']
},
jshint: {
options: {
jshintrc: 'js/.jshintrc'
},
2014-01-20 22:06:13 +01:00
grunt: {
options: {
jshintrc: 'grunt/.jshintrc'
},
2014-02-06 19:39:45 +01:00
src: ['Gruntfile.js', 'grunt/*.js']
},
src: {
2014-01-19 15:04:29 +01:00
src: 'js/*.js'
},
test: {
2014-01-19 15:04:29 +01:00
src: 'js/tests/unit/*.js'
},
assets: {
src: ['docs/assets/js/_src/*.js', 'docs/assets/js/*.js', '!docs/assets/js/*.min.js']
}
},
2013-08-08 08:06:29 +02:00
2013-12-07 01:51:38 +01:00
jscs: {
options: {
2014-02-28 16:29:36 +01:00
config: 'js/.jscsrc'
2013-12-07 01:51:38 +01:00
},
2014-01-20 22:06:13 +01:00
grunt: {
2014-02-28 13:21:21 +01:00
options: {
2014-03-09 10:10:15 +01:00
requireCamelCaseOrUpperCaseIdentifiers: null,
requireParenthesesAroundIIFE: true
2014-02-28 13:21:21 +01:00
},
src: '<%= jshint.grunt.src %>'
2013-12-07 01:51:38 +01:00
},
src: {
src: '<%= jshint.src.src %>'
2013-12-07 01:51:38 +01:00
},
test: {
src: '<%= jshint.test.src %>'
},
assets: {
options: {
requireCamelCaseOrUpperCaseIdentifiers: null
},
src: '<%= jshint.assets.src %>'
2013-12-07 01:51:38 +01:00
}
},
concat: {
options: {
2013-12-23 18:02:42 +01:00
banner: '<%= banner %>\n<%= jqueryCheck %>',
stripBanners: false
},
bootstrap: {
src: [
'js/transition.js',
'js/alert.js',
'js/button.js',
'js/carousel.js',
'js/collapse.js',
'js/dropdown.js',
'js/modal.js',
'js/tooltip.js',
'js/popover.js',
'js/scrollspy.js',
'js/tab.js',
'js/affix.js'
],
dest: 'dist/js/<%= pkg.name %>.js'
}
},
2013-08-08 08:06:29 +02:00
uglify: {
bootstrap: {
options: {
banner: '<%= banner %>'
},
2014-01-19 15:04:29 +01:00
src: '<%= concat.bootstrap.dest %>',
dest: 'dist/js/<%= pkg.name %>.min.js'
2013-09-19 16:41:14 +02:00
},
customize: {
options: {
preserveComments: 'some'
},
2013-09-19 16:41:14 +02:00
src: [
'docs/assets/js/_vendor/less.min.js',
'docs/assets/js/_vendor/jszip.min.js',
'docs/assets/js/_vendor/uglify.min.js',
'docs/assets/js/_vendor/blob.js',
'docs/assets/js/_vendor/filesaver.js',
'docs/assets/js/raw-files.min.js',
'docs/assets/js/_src/customizer.js'
2013-09-19 16:41:14 +02:00
],
dest: 'docs/assets/js/customize.min.js'
},
docsJs: {
options: {
preserveComments: 'some'
},
src: [
'docs/assets/js/_vendor/holder.js',
'docs/assets/js/_src/application.js'
],
dest: 'docs/assets/js/docs.min.js'
}
},
2014-03-10 00:09:36 +01:00
qunit: {
options: {
inject: 'js/tests/unit/phantom.js'
},
files: 'js/tests/index.html'
},
less: {
compileCore: {
options: {
strictMath: true,
sourceMap: true,
outputSourceFiles: true,
sourceMapURL: '<%= pkg.name %>.css.map',
sourceMapFilename: 'dist/css/<%= pkg.name %>.css.map'
},
files: {
'dist/css/<%= pkg.name %>.css': 'less/bootstrap.less'
}
},
compileTheme: {
options: {
strictMath: true,
sourceMap: true,
outputSourceFiles: true,
sourceMapURL: '<%= pkg.name %>-theme.css.map',
sourceMapFilename: 'dist/css/<%= pkg.name %>-theme.css.map'
},
files: {
'dist/css/<%= pkg.name %>-theme.css': 'less/theme.less'
}
},
minify: {
options: {
cleancss: true
},
files: {
'dist/css/<%= pkg.name %>.min.css': 'dist/css/<%= pkg.name %>.css',
2014-03-04 06:54:07 +01:00
'dist/css/<%= pkg.name %>-theme.min.css': 'dist/css/<%= pkg.name %>-theme.css'
}
}
},
2014-02-22 11:17:58 +01:00
autoprefixer: {
options: {
browsers: ['last 2 versions', 'ie 8', 'ie 9', 'android 2.3', 'android 4', 'opera 12']
},
core: {
options: {
map: true
},
src: 'dist/css/<%= pkg.name %>.css'
},
theme: {
options: {
map: true
},
src: 'dist/css/<%= pkg.name %>-theme.css'
},
docs: {
src: 'docs/assets/css/_src/docs.css'
2014-02-22 11:17:58 +01:00
},
examples: {
expand: true,
cwd: 'docs/examples/',
src: ['**/*.css'],
dest: 'docs/examples/'
}
},
2014-03-10 00:09:36 +01:00
csslint: {
options: {
csslintrc: 'less/.csslintrc'
},
src: [
'dist/css/bootstrap.css',
'dist/css/bootstrap-theme.css'
],
examples: [
'docs/examples/**/*.css'
],
docs: {
options: {
2014-03-10 00:15:53 +01:00
ids: false,
2014-03-10 00:09:36 +01:00
'overqualified-elements': false
},
src: 'docs/assets/css/_src/docs.css'
2014-03-10 00:09:36 +01:00
}
},
2013-12-22 08:25:18 +01:00
cssmin: {
2014-03-11 18:48:14 +01:00
options: {
compatibility: 'ie8',
2014-05-13 07:01:29 +02:00
keepSpecialComments: '*'
2014-03-11 18:48:14 +01:00
},
docs: {
2013-12-22 08:25:18 +01:00
src: [
'docs/assets/css/_src/docs.css',
'docs/assets/css/_src/pygments-manni.css'
2013-12-22 08:25:18 +01:00
],
dest: 'docs/assets/css/docs.min.css'
2013-12-22 08:25:18 +01:00
}
},
usebanner: {
2014-03-11 18:48:14 +01:00
options: {
position: 'top',
banner: '<%= banner %>'
},
files: {
src: 'dist/css/*.css'
}
},
csscomb: {
2014-01-31 13:20:33 +01:00
options: {
config: 'less/.csscomb.json'
},
dist: {
2014-03-11 18:48:14 +01:00
expand: true,
cwd: 'dist/css/',
src: ['*.css', '!*.min.css'],
dest: 'dist/css/'
2014-01-31 13:20:33 +01:00
},
examples: {
2014-02-10 20:09:59 +01:00
expand: true,
cwd: 'docs/examples/',
2014-03-07 17:37:23 +01:00
src: '**/*.css',
2014-02-10 20:09:59 +01:00
dest: 'docs/examples/'
2014-02-27 09:12:52 +01:00
},
docs: {
files: {
'docs/assets/css/_src/docs.css': 'docs/assets/css/_src/docs.css'
2014-02-27 09:12:52 +01:00
}
}
},
2013-08-18 09:36:51 +02:00
copy: {
fonts: {
expand: true,
2014-01-19 15:04:29 +01:00
src: 'fonts/*',
2013-08-18 09:36:51 +02:00
dest: 'dist/'
},
2013-12-31 20:38:32 +01:00
docs: {
expand: true,
2013-12-31 20:38:32 +01:00
cwd: './dist',
src: [
'{css,js}/*.min.*',
2014-01-08 02:08:40 +01:00
'css/*.map',
2013-12-31 20:38:32 +01:00
'fonts/*'
],
dest: 'docs/dist'
2013-08-18 09:36:51 +02:00
}
},
connect: {
server: {
options: {
port: 3000,
base: '.'
}
}
},
jekyll: {
docs: {}
},
jade: {
compile: {
options: {
pretty: true,
data: function () {
var filePath = path.join(__dirname, 'less/variables.less');
var fileContent = fs.readFileSync(filePath, {encoding: 'utf8'});
var parser = new BsLessdocParser(fileContent);
return {sections: parser.parseFile()};
}
},
files: {
'docs/_includes/customizer-variables.html': 'docs/_jade/customizer-variables.jade',
'docs/_includes/nav/customize.html': 'docs/_jade/customizer-nav.jade'
}
}
},
validation: {
options: {
charset: 'utf-8',
doctype: 'HTML5',
failHard: true,
reset: true,
relaxerror: [
2013-09-18 18:50:02 +02:00
'Bad value X-UA-Compatible for attribute http-equiv on element meta.',
'Element img is missing required attribute src.'
]
},
files: {
2014-01-19 15:04:29 +01:00
src: '_gh_pages/**/*.html'
}
},
watch: {
src: {
files: '<%= jshint.src.src %>',
tasks: ['jshint:src', 'qunit']
},
test: {
files: '<%= jshint.test.src %>',
tasks: ['jshint:test', 'qunit']
},
less: {
files: 'less/*.less',
2014-01-19 15:04:29 +01:00
tasks: 'less'
}
},
sed: {
versionNumber: {
pattern: (function () {
2014-01-17 20:51:53 +01:00
var old = grunt.option('oldver');
return old ? RegExp.quote(old) : old;
})(),
replacement: grunt.option('newver'),
recursive: true
}
},
'saucelabs-qunit': {
all: {
options: {
build: process.env.TRAVIS_JOB_ID,
concurrency: 10,
urls: ['http://127.0.0.1:3000/js/tests/index.html'],
browsers: grunt.file.readYAML('grunt/sauce_browsers.yml')
}
}
2014-01-20 22:06:13 +01:00
},
exec: {
npmUpdate: {
command: 'npm update'
},
2014-05-13 07:01:29 +02:00
npmShrinkWrap: {
command: 'npm shrinkwrap --dev'
}
}
});
// These plugins provide necessary tasks.
2013-12-10 14:47:50 +01:00
require('load-grunt-tasks')(grunt, {scope: 'devDependencies'});
2014-03-07 07:46:15 +01:00
require('time-grunt')(grunt);
// Docs HTML validation task
grunt.registerTask('validate-html', ['jekyll', 'validation']);
2014-05-19 00:52:42 +02:00
var runSubset = function (subset) {
return !process.env.TWBS_TEST || process.env.TWBS_TEST === subset;
};
var isUndefOrNonZero = function (val) {
return val === undefined || val !== '0';
};
2014-05-19 00:52:42 +02:00
// Test task.
var testSubtasks = [];
// Skip core tests if running a different subset of the test suite
2014-05-19 00:52:42 +02:00
if (runSubset('core')) {
testSubtasks = testSubtasks.concat(['dist-css', 'csslint', 'jshint', 'jscs', 'qunit', 'build-customizer-html']);
}
// Skip HTML validation if running a different subset of the test suite
if (runSubset('validate-html') &&
// Skip HTML5 validator on Travis when [skip validator] is in the commit message
isUndefOrNonZero(process.env.TWBS_DO_VALIDATOR)) {
testSubtasks.push('validate-html');
}
// Only run Sauce Labs tests if there's a Sauce access key
2014-01-17 20:51:53 +01:00
if (typeof process.env.SAUCE_ACCESS_KEY !== 'undefined' &&
// Skip Sauce if running a different subset of the test suite
runSubset('sauce-js-unit') &&
// Skip Sauce on Travis when [skip sauce] is in the commit message
isUndefOrNonZero(process.env.TWBS_DO_SAUCE)) {
testSubtasks.push('connect');
testSubtasks.push('saucelabs-qunit');
2013-08-06 09:39:35 +02:00
}
grunt.registerTask('test', testSubtasks);
// JS distribution task.
grunt.registerTask('dist-js', ['concat', 'uglify']);
// CSS distribution task.
grunt.registerTask('less-compile', ['less:compileCore', 'less:compileTheme']);
2014-05-13 04:47:53 +02:00
grunt.registerTask('dist-css', ['less-compile', 'autoprefixer', 'usebanner', 'csscomb', 'less:minify', 'cssmin']);
2013-12-31 22:57:35 +01:00
// Docs distribution task.
2014-01-19 15:04:29 +01:00
grunt.registerTask('dist-docs', 'copy:docs');
2013-08-18 09:36:51 +02:00
// Full distribution task.
grunt.registerTask('dist', ['clean', 'dist-css', 'copy:fonts', 'dist-js', 'dist-docs']);
// Default task.
grunt.registerTask('default', ['test', 'dist', 'build-glyphicons-data', 'build-customizer']);
2013-08-08 08:06:29 +02:00
// Version numbering task.
// grunt change-version-number --oldver=A.B.C --newver=X.Y.Z
// This can be overzealous, so its changes should always be manually reviewed!
2014-01-19 15:04:29 +01:00
grunt.registerTask('change-version-number', 'sed');
grunt.registerTask('build-glyphicons-data', function () { generateGlyphiconsData.call(this, grunt); });
2013-08-08 08:06:29 +02:00
// task for building customizer
grunt.registerTask('build-customizer', ['build-customizer-html', 'build-raw-files']);
grunt.registerTask('build-customizer-html', 'jade');
2014-01-14 22:25:27 +01:00
grunt.registerTask('build-raw-files', 'Add scripts/less files to customizer.', function () {
var banner = grunt.template.process('<%= banner %>');
generateRawFiles(grunt, banner);
2014-01-14 22:25:27 +01:00
});
2014-01-20 22:06:13 +01:00
// Task for updating the npm packages used by the Travis build.
2014-05-13 07:01:29 +02:00
grunt.registerTask('update-shrinkwrap', ['exec:npmUpdate', 'exec:npmShrinkWrap', '_update-shrinkwrap']);
grunt.registerTask('_update-shrinkwrap', function () { updateShrinkwrap.call(this, grunt); });
};