CyberChef/Gruntfile.js

411 lines
14 KiB
JavaScript
Raw Normal View History

"use strict";
2017-04-13 18:00:55 +00:00
const webpack = require("webpack");
const HtmlWebpackPlugin = require("html-webpack-plugin");
const NodeExternals = require("webpack-node-externals");
2017-04-13 18:00:55 +00:00
const Inliner = require("web-resource-inliner");
2017-08-09 19:09:23 +00:00
const fs = require("fs");
2016-12-14 16:39:17 +00:00
2017-07-03 22:15:57 +00:00
/**
* Grunt configuration for building the app in various formats.
*
* @author n1474335 [n1474335@gmail.com]
* @copyright Crown Copyright 2017
* @license Apache-2.0
*/
module.exports = function (grunt) {
2016-11-28 10:42:58 +00:00
grunt.file.defaultEncoding = "utf8";
grunt.file.preserveBOM = false;
2016-12-14 16:39:17 +00:00
2016-11-28 10:42:58 +00:00
// Tasks
grunt.registerTask("dev",
"A persistent task which creates a development build whenever source files are modified.",
["clean:dev", "concurrent:dev"]);
grunt.registerTask("node",
"Compiles CyberChef into a single NodeJS module.",
["clean:node", "webpack:metaConf", "webpack:node", "chmod:build"]);
2016-12-14 16:39:17 +00:00
grunt.registerTask("test",
2017-02-24 23:50:17 +00:00
"A task which runs all the tests in test/tests.",
["clean:test", "webpack:metaConf", "webpack:tests", "execute:test"]);
2016-12-14 16:39:17 +00:00
2016-11-28 10:42:58 +00:00
grunt.registerTask("docs",
"Compiles documentation in the /docs directory.",
["clean:docs", "jsdoc", "chmod:docs"]);
2016-12-14 16:39:17 +00:00
2017-03-27 15:08:36 +00:00
grunt.registerTask("prod",
"Creates a production-ready build. Use the --msg flag to add a compile message.",
["eslint", "clean:prod", "webpack:metaConf", "webpack:web", "inline", "chmod"]);
2016-11-28 10:42:58 +00:00
grunt.registerTask("default",
"Lints the code base",
["eslint", "exec:repoSize"]);
2016-12-14 16:39:17 +00:00
2017-03-27 15:08:36 +00:00
grunt.registerTask("inline",
"Compiles a production build of CyberChef into a single, portable web page.",
["webpack:webInline", "runInliner", "clean:inlineScripts"]);
2017-03-27 15:08:36 +00:00
grunt.registerTask("runInliner", runInliner);
2016-11-28 10:42:58 +00:00
grunt.registerTask("doc", "docs");
grunt.registerTask("tests", "test");
2016-12-14 16:39:17 +00:00
grunt.registerTask("lint", "eslint");
2016-11-28 10:42:58 +00:00
// Load tasks provided by each plugin
2016-12-14 16:39:17 +00:00
grunt.loadNpmTasks("grunt-eslint");
2017-03-27 15:08:36 +00:00
grunt.loadNpmTasks("grunt-webpack");
2016-11-28 10:42:58 +00:00
grunt.loadNpmTasks("grunt-jsdoc");
grunt.loadNpmTasks("grunt-contrib-clean");
grunt.loadNpmTasks("grunt-contrib-copy");
grunt.loadNpmTasks("grunt-chmod");
grunt.loadNpmTasks("grunt-exec");
grunt.loadNpmTasks("grunt-execute");
grunt.loadNpmTasks("grunt-accessibility");
grunt.loadNpmTasks("grunt-concurrent");
2016-12-14 16:39:17 +00:00
2017-03-27 15:08:36 +00:00
// Project configuration
2017-05-02 22:03:28 +00:00
const compileTime = grunt.template.today("UTC:dd/mm/yyyy HH:MM:ss") + " UTC",
2017-07-03 22:15:57 +00:00
pkg = grunt.file.readJSON("package.json"),
webpackConfig = require("./webpack.config.js"),
BUILD_CONSTANTS = {
COMPILE_TIME: JSON.stringify(compileTime),
COMPILE_MSG: JSON.stringify(grunt.option("compile-msg") || grunt.option("msg") || ""),
PKG_VERSION: JSON.stringify(pkg.version),
ENVIRONMENT_IS_WORKER: function() {
return typeof importScripts === "function";
},
ENVIRONMENT_IS_NODE: function() {
return typeof process === "object" && typeof require === "function";
},
ENVIRONMENT_IS_WEB: function() {
return typeof window === "object";
}
2017-08-09 19:09:23 +00:00
},
moduleEntryPoints = listEntryModules();
2016-11-28 10:42:58 +00:00
2017-03-27 15:08:36 +00:00
/**
* Compiles a production build of CyberChef into a single, portable web page.
*/
function runInliner() {
2017-04-13 18:00:55 +00:00
const done = this.async();
2017-03-27 15:08:36 +00:00
Inliner.html({
relativeTo: "build/prod/",
fileContent: grunt.file.read("build/prod/cyberchef.htm"),
images: true,
svgs: true,
scripts: true,
links: true,
strict: true
}, function(error, result) {
if (error) {
2017-04-13 18:00:55 +00:00
if (error instanceof Error) {
2017-04-28 15:51:57 +00:00
done(error);
2017-04-13 18:00:55 +00:00
} else {
2017-04-28 15:51:57 +00:00
done(new Error(error));
2017-04-13 18:00:55 +00:00
}
} else {
2017-04-28 15:51:57 +00:00
grunt.file.write("build/prod/cyberchef.htm", result);
done(true);
2017-03-27 15:08:36 +00:00
}
});
}
2016-12-14 16:39:17 +00:00
2017-08-09 19:09:23 +00:00
/**
* Generates an entry list for all the modules.
*/
function listEntryModules() {
const path = "./src/core/config/modules/";
let entryModules = {};
fs.readdirSync(path).forEach(file => {
if (file !== "Default.js" && file !== "OpModules.js")
2017-08-09 19:09:23 +00:00
entryModules[file.split(".js")[0]] = path + file;
});
return entryModules;
}
2016-11-28 10:42:58 +00:00
grunt.initConfig({
2017-03-27 15:08:36 +00:00
clean: {
dev: ["build/dev/*"],
prod: ["build/prod/*", "src/core/config/MetaConfig.js"],
test: ["build/test/*", "src/core/config/MetaConfig.js"],
node: ["build/node/*", "src/core/config/MetaConfig.js"],
2017-09-13 15:21:31 +00:00
docs: ["docs/*", "!docs/*.conf.json", "!docs/*.ico", "!docs/*.png"],
inlineScripts: ["build/prod/scripts.js"],
2017-03-27 15:08:36 +00:00
},
2016-12-14 16:39:17 +00:00
eslint: {
2016-11-28 10:42:58 +00:00
options: {
2017-04-28 15:51:57 +00:00
configFile: "./.eslintrc.json"
2016-11-28 10:42:58 +00:00
},
2017-03-27 18:39:04 +00:00
configs: ["Gruntfile.js"],
core: ["src/core/**/*.js", "!src/core/lib/**/*", "!src/core/config/MetaConfig.js"],
web: ["src/web/**/*.js"],
node: ["src/node/**/*.js"],
tests: ["test/**/*.js"],
2016-11-28 10:42:58 +00:00
},
jsdoc: {
options: {
destination: "docs",
template: "node_modules/ink-docstrap/template",
recurse: true,
readme: "./README.md",
configure: "docs/jsdoc.conf.json"
},
all: {
src: [
"src/**/*.js",
"!src/core/lib/**/*",
2017-09-17 13:59:11 +00:00
"!src/core/config/MetaConfig.js"
2016-11-28 10:42:58 +00:00
],
}
},
concurrent: {
options: {
logConcurrentOutput: true
},
dev: ["webpack:metaConfDev", "webpack-dev-server:start"]
},
accessibility: {
options: {
accessibilityLevel: "WCAG2A",
verbose: false,
ignore: [
"WCAG2A.Principle1.Guideline1_3.1_3_1.H42.2"
]
},
test: {
src: ["build/**/*.html"]
}
},
webpack: {
2017-07-03 22:15:57 +00:00
options: webpackConfig,
metaConf: {
mode: "production",
target: "node",
2018-01-25 13:44:39 +00:00
entry: [
"babel-polyfill",
"./src/core/config/OperationConfig.js"
],
output: {
filename: "MetaConfig.js",
path: __dirname + "/src/core/config/",
library: "MetaConfig",
libraryTarget: "commonjs2",
libraryExport: "default"
},
2017-09-17 13:53:17 +00:00
externals: [NodeExternals()],
},
metaConfDev: {
mode: "development",
target: "node",
2018-01-25 13:44:39 +00:00
entry: [
"babel-polyfill",
"./src/core/config/OperationConfig.js"
],
output: {
filename: "MetaConfig.js",
path: __dirname + "/src/core/config/",
library: "MetaConfig",
libraryTarget: "commonjs2",
libraryExport: "default"
},
2017-09-17 13:53:17 +00:00
externals: [NodeExternals()],
watch: true
},
2017-07-03 22:15:57 +00:00
web: {
mode: "production",
target: "web",
2017-08-09 19:09:23 +00:00
entry: Object.assign({
main: "./src/web/index.js",
sitemap: "./src/web/static/sitemap.js"
2017-08-09 19:09:23 +00:00
}, moduleEntryPoints),
output: {
path: __dirname + "/build/prod"
},
resolve: {
alias: {
"./config/modules/OpModules.js": "./config/modules/Default.js"
}
},
plugins: [
2017-07-03 22:15:57 +00:00
new webpack.DefinePlugin(BUILD_CONSTANTS),
new HtmlWebpackPlugin({
2017-03-27 15:08:36 +00:00
filename: "index.html",
template: "./src/web/html/index.html",
2017-08-09 19:09:23 +00:00
chunks: ["main"],
2017-03-27 15:08:36 +00:00
compileTime: compileTime,
version: pkg.version,
2017-03-27 15:08:36 +00:00
minify: {
removeComments: true,
collapseWhitespace: true,
minifyJS: true,
minifyCSS: true
}
}),
]
},
webInline: {
mode: "production",
target: "web",
entry: "./src/web/index.js",
output: {
filename: "scripts.js",
path: __dirname + "/build/prod"
},
plugins: [
new webpack.DefinePlugin(Object.assign({}, BUILD_CONSTANTS, {
INLINE: "true"
})),
new HtmlWebpackPlugin({
2017-03-27 15:08:36 +00:00
filename: "cyberchef.htm",
template: "./src/web/html/index.html",
compileTime: compileTime,
version: pkg.version + "s",
2017-03-27 15:08:36 +00:00
inline: true,
minify: {
removeComments: true,
collapseWhitespace: true,
minifyJS: true,
minifyCSS: true
}
}),
]
},
tests: {
mode: "development",
target: "node",
entry: "./test/index.js",
externals: [NodeExternals()],
output: {
filename: "index.js",
path: __dirname + "/build/test"
},
plugins: [
new webpack.DefinePlugin(BUILD_CONSTANTS)
]
},
node: {
mode: "production",
target: "node",
entry: "./src/node/index.js",
externals: [NodeExternals()],
output: {
filename: "CyberChef.js",
path: __dirname + "/build/node",
library: "CyberChef",
libraryTarget: "commonjs2"
},
plugins: [
new webpack.DefinePlugin(BUILD_CONSTANTS)
]
}
},
2017-07-03 22:15:57 +00:00
"webpack-dev-server": {
options: {
webpack: webpackConfig,
host: "0.0.0.0",
disableHostCheck: true,
overlay: true,
inline: false,
clientLogLevel: "error",
2017-07-03 22:15:57 +00:00
stats: {
children: false,
chunks: false,
modules: false,
entrypoints: false,
warningsFilter: [/source-map/, /dependency is an expression/],
}
2017-07-03 22:15:57 +00:00
},
start: {
webpack: {
mode: "development",
2017-07-03 22:15:57 +00:00
target: "web",
2017-08-09 19:09:23 +00:00
entry: Object.assign({
main: "./src/web/index.js"
}, moduleEntryPoints),
resolve: {
alias: {
"./config/modules/OpModules.js": "./config/modules/Default.js"
}
},
2017-07-03 22:15:57 +00:00
plugins: [
new webpack.DefinePlugin(BUILD_CONSTANTS),
new HtmlWebpackPlugin({
filename: "index.html",
template: "./src/web/html/index.html",
2017-08-09 19:09:23 +00:00
chunks: ["main"],
2017-07-03 22:15:57 +00:00
compileTime: compileTime,
version: pkg.version,
})
]
}
}
},
2016-11-28 10:42:58 +00:00
copy: {
ghPages: {
options: {
2017-09-13 15:21:31 +00:00
process: function (content, srcpath) {
// Add Google Analytics code to index.html
2017-09-13 15:21:31 +00:00
if (srcpath.indexOf("index.html") >= 0) {
content = content.replace("</body></html>",
grunt.file.read("src/web/static/ga.html") + "</body></html>");
return grunt.template.process(content, srcpath);
} else {
return content;
}
},
noProcess: ["**", "!**/*.html"]
},
2017-09-13 15:21:31 +00:00
files: [
{
src: "build/prod/index.html",
dest: "build/prod/index.html"
},
{
expand: true,
src: "docs/**",
dest: "build/prod/"
},
2017-09-13 15:21:31 +00:00
]
2016-11-28 10:42:58 +00:00
}
},
chmod: {
build: {
options: {
mode: "755",
},
2017-03-27 15:08:36 +00:00
src: ["build/**/*", "build/"]
2016-11-28 10:42:58 +00:00
},
docs: {
options: {
mode: "755",
},
src: ["docs/**/*", "docs/"]
}
},
exec: {
repoSize: {
2016-11-28 10:42:58 +00:00
command: [
2016-12-14 16:39:17 +00:00
"git ls-files | wc -l | xargs printf '\n%b\ttracked files\n'",
"du -hs | egrep -o '^[^\t]*' | xargs printf '%b\trepository size\n'"
].join(";"),
2016-11-28 10:42:58 +00:00
stderr: false
},
cleanGit: {
2016-11-28 10:42:58 +00:00
command: "git gc --prune=now --aggressive"
},
sitemap: {
command: "node build/prod/sitemap.js > build/prod/sitemap.xml"
}
2016-11-28 10:42:58 +00:00
},
execute: {
test: "build/test/index.js"
},
2016-11-28 10:42:58 +00:00
});
};