function build() {
return _build(generate, generateBanner, pkg).apply(undefined, arguments);
}...
#### Building
A `build` method is exposed for generating custom Modernizr builds. Example:
```javascript
var modernizr = require("modernizr");
modernizr.build({}, function (result) {
console.log(result); // the build
});
```
The first parameter takes a JSON object of options and feature-detects to include. See [`lib/config-all.json`](lib/config-all.json
) for all available options.
The second parameter is a function invoked on task completion.
...function metadata(cb) {
var tests = [];
var md = new Remarkable();
file.walkSync(viewRoot, function(start, dirs, files) {
files.forEach(function(file) {
if (file === '.DS_Store') {
return;
}
var test = fs.readFileSync(start + '/' + file, 'utf8');
// TODO :: make this regex not suck
var metaRE = /\/\*\!([\s\S]*)\!\*\//m;
var matches = test.match(metaRE);
var docRE = /\/\*\sDOC([\s\S]*?)\*\//m;
var docmatches = test.match(docRE);
var depRE = /define\((\[[^\]]*\]),/;
var depMatches = test.match(depRE);
var metadata;
if (matches && matches[1]) {
try {
metadata = JSON.parse(matches[1]);
} catch (e) {
throw new Error('Error Parsing Metadata: ' + file + '\nInput: `' + matches[1] + '`');
}
}
else {
metadata = {};
}
var docs = null;
if (docmatches && docmatches[1]) {
docs = md.render(docmatches[1].trim());
}
metadata.doc = docs;
var deps = [];
var matchedDeps;
if (depMatches && depMatches[1]) {
try {
matchedDeps = JSON.parse(depMatches[1].replace(/'/g, '"'));
} catch (e) {
throw new Error('Couldn\'t parse dependencies for `' + file + '`:\n`' + depMatches[1] + '\n`');
}
matchedDeps.forEach(function(dep) {
if (dep === 'Modernizr') {
return;
}
deps.push(dep);
});
} else {
throw new Error('Couldn\'t find the define for `' + file + '`');
}
metadata.deps = deps;
var baseDir = __dirname.replace(/lib$/, '');
metadata.path = './' + (start + '/' + file).replace(baseDir, '').replace(/\\/g, '/');
metadata.amdPath = metadata.path.replace(/^\.\/feature\-detects/, 'test').replace(/\.js$/i, '');
if (!metadata.name) {
metadata.name = metadata.amdPath;
}
var pfs = [];
if (metadata.polyfills && metadata.polyfills.length) {
metadata.polyfills.forEach(function(polyname) {
if (polyfills[polyname]) {
pfs.push(polyfills[polyname]);
}
else {
throw new Error(metadata.name + ': Polyfill not found in `' + file + '`: ' + polyname);
}
});
}
metadata.polyfills = pfs;
if (!metadata.async) {
metadata.async = false;
}
if (!metadata.notes) {
metadata.notes = [];
}
if (!metadata.warnings) {
metadata.warnings = [];
}
if (!metadata.caniuse) {
metadata.caniuse = null;
}
if (!metadata.cssclass && metadata.property) {
metadata.cssclass = metadata.property;
} else {
metadata.cssclass = null;
}
// Maybe catch a bug
if (!metadata.doc && metadata.docs) {
metadata.doc = metadata.docs;
delete metadata.docs;
}
// If you want markdown parsed code minus the docs and metadata, this'll do it.
// Off by default for now.
// metadata.code = md.render('```javascript\n' + test.replace(metaRE, '').replace(docRE, '') + '\n```');
if (!metadata.tags) {
metadata.tags = [];
}
if (!metadata.authors) {
metadata.authors = [];
}
if (!metadata.knownBugs) {
metadata.knownBugs = [];
}
tests.push(metadata);
});
});
if (cb && typeof cb == 'function') {
return cb(tests);
}
return tests;
}n/a
function options(cb, allMetadata) {
var opts;
file.walkSync(srcRoot, function(start, dirs, files) {
opts = _.chain(files)
.map(function(file) {
var srcFile = fs.readFileSync(start + '/' + file, 'utf8');
var docs = srcFile.match(jsdocRE);
if (docs) {
docs = docs
.map(stripComments)
.map(function(str) {
return jsdoc.parse(str, {
sloppy: true,
tags: [
'access',
'author',
'class',
'example',
'function',
'memberOf',
'memberof',
'name',
'optionName',
'optionProp',
'param',
'params',
'preserve',
'private',
'returns',
'type'
]
});
});
var option = _.chain(docs)
.flatten()
.filter(function(doc) {
if (allMetadata) {
return true;
} else {
return doc && _.some(doc.tags, {title: 'optionName'});
}
})
.map(function(opt) {
if (allMetadata) {
return opt;
} else {
var tags = opt.tags.filter(function(tag) {
return tag.title.indexOf('option') === 0;
});
return {
name: _.filter(tags, {title: 'optionName'})[0].description,
property: _.filter(tags, {title: 'optionProp'})[0].description
};
}
})
.value();
return option;
}
})
.filter(function(doc) {
return doc && doc.length;
})
.flatten()
.value();
});
if (cb) {
cb(opts);
}
return opts;
}n/a
function build() {
return _build(generate, generateBanner, pkg).apply(undefined, arguments);
}...
#### Building
A `build` method is exposed for generating custom Modernizr builds. Example:
```javascript
var modernizr = require("modernizr");
modernizr.build({}, function (result) {
console.log(result); // the build
});
```
The first parameter takes a JSON object of options and feature-detects to include. See [`lib/config-all.json`](lib/config-all.json
) for all available options.
The second parameter is a function invoked on task completion.
...function metadata(cb) {
var tests = [];
var md = new Remarkable();
file.walkSync(viewRoot, function(start, dirs, files) {
files.forEach(function(file) {
if (file === '.DS_Store') {
return;
}
var test = fs.readFileSync(start + '/' + file, 'utf8');
// TODO :: make this regex not suck
var metaRE = /\/\*\!([\s\S]*)\!\*\//m;
var matches = test.match(metaRE);
var docRE = /\/\*\sDOC([\s\S]*?)\*\//m;
var docmatches = test.match(docRE);
var depRE = /define\((\[[^\]]*\]),/;
var depMatches = test.match(depRE);
var metadata;
if (matches && matches[1]) {
try {
metadata = JSON.parse(matches[1]);
} catch (e) {
throw new Error('Error Parsing Metadata: ' + file + '\nInput: `' + matches[1] + '`');
}
}
else {
metadata = {};
}
var docs = null;
if (docmatches && docmatches[1]) {
docs = md.render(docmatches[1].trim());
}
metadata.doc = docs;
var deps = [];
var matchedDeps;
if (depMatches && depMatches[1]) {
try {
matchedDeps = JSON.parse(depMatches[1].replace(/'/g, '"'));
} catch (e) {
throw new Error('Couldn\'t parse dependencies for `' + file + '`:\n`' + depMatches[1] + '\n`');
}
matchedDeps.forEach(function(dep) {
if (dep === 'Modernizr') {
return;
}
deps.push(dep);
});
} else {
throw new Error('Couldn\'t find the define for `' + file + '`');
}
metadata.deps = deps;
var baseDir = __dirname.replace(/lib$/, '');
metadata.path = './' + (start + '/' + file).replace(baseDir, '').replace(/\\/g, '/');
metadata.amdPath = metadata.path.replace(/^\.\/feature\-detects/, 'test').replace(/\.js$/i, '');
if (!metadata.name) {
metadata.name = metadata.amdPath;
}
var pfs = [];
if (metadata.polyfills && metadata.polyfills.length) {
metadata.polyfills.forEach(function(polyname) {
if (polyfills[polyname]) {
pfs.push(polyfills[polyname]);
}
else {
throw new Error(metadata.name + ': Polyfill not found in `' + file + '`: ' + polyname);
}
});
}
metadata.polyfills = pfs;
if (!metadata.async) {
metadata.async = false;
}
if (!metadata.notes) {
metadata.notes = [];
}
if (!metadata.warnings) {
metadata.warnings = [];
}
if (!metadata.caniuse) {
metadata.caniuse = null;
}
if (!metadata.cssclass && metadata.property) {
metadata.cssclass = metadata.property;
} else {
metadata.cssclass = null;
}
// Maybe catch a bug
if (!metadata.doc && metadata.docs) {
metadata.doc = metadata.docs;
delete metadata.docs;
}
// If you want markdown parsed code minus the docs and metadata, this'll do it.
// Off by default for now.
// metadata.code = md.render('```javascript\n' + test.replace(metaRE, '').replace(docRE, '') + '\n```');
if (!metadata.tags) {
metadata.tags = [];
}
if (!metadata.authors) {
metadata.authors = [];
}
if (!metadata.knownBugs) {
metadata.knownBugs = [];
}
tests.push(metadata);
});
});
if (cb && typeof cb == 'function') {
return cb(tests);
}
return tests;
}n/a
function options(cb, allMetadata) {
var opts;
file.walkSync(srcRoot, function(start, dirs, files) {
opts = _.chain(files)
.map(function(file) {
var srcFile = fs.readFileSync(start + '/' + file, 'utf8');
var docs = srcFile.match(jsdocRE);
if (docs) {
docs = docs
.map(stripComments)
.map(function(str) {
return jsdoc.parse(str, {
sloppy: true,
tags: [
'access',
'author',
'class',
'example',
'function',
'memberOf',
'memberof',
'name',
'optionName',
'optionProp',
'param',
'params',
'preserve',
'private',
'returns',
'type'
]
});
});
var option = _.chain(docs)
.flatten()
.filter(function(doc) {
if (allMetadata) {
return true;
} else {
return doc && _.some(doc.tags, {title: 'optionName'});
}
})
.map(function(opt) {
if (allMetadata) {
return opt;
} else {
var tags = opt.tags.filter(function(tag) {
return tag.title.indexOf('option') === 0;
});
return {
name: _.filter(tags, {title: 'optionName'})[0].description,
property: _.filter(tags, {title: 'optionProp'})[0].description
};
}
})
.value();
return option;
}
})
.filter(function(doc) {
return doc && doc.length;
})
.flatten()
.value();
});
if (cb) {
cb(opts);
}
return opts;
}n/a