mirror of
https://github.com/documentationjs/documentation.git
synced 2026-01-18 14:17:30 +00:00
cb8fdfa74f
This brings logic from eslint over to documentation: instead of readdirSync, we're using the glob module. This also, I hope, will let us support globs on Windows without changing OSX/Linux behavior. Fixes #607
83 lines
2.8 KiB
JavaScript
83 lines
2.8 KiB
JavaScript
'use strict';
|
|
|
|
var mdeps = require('module-deps-sortable');
|
|
var fs = require('fs');
|
|
var path = require('path');
|
|
var babelify = require('babelify');
|
|
var concat = require('concat-stream');
|
|
var moduleFilters = require('../../lib/module_filters');
|
|
var smartGlob = require('../smart_glob.js');
|
|
|
|
/**
|
|
* Returns a readable stream of dependencies, given an array of entry
|
|
* points and an object of options to provide to module-deps.
|
|
*
|
|
* This stream requires filesystem access, and thus isn't suitable
|
|
* for a browser environment.
|
|
*
|
|
* @param {Array<string>} indexes paths to entry files as strings
|
|
* @param {Object} options optional options passed
|
|
* @param {Function} callback called with (err, inputs)
|
|
* @returns {undefined} calls callback
|
|
*/
|
|
function dependencyStream(indexes, options, callback) {
|
|
var md = mdeps({
|
|
/**
|
|
* Determine whether a module should be included in documentation
|
|
* @param {string} id path to a module
|
|
* @returns {boolean} true if the module should be included.
|
|
*/
|
|
filter: function (id) {
|
|
return !!options.external || moduleFilters.internalOnly(id);
|
|
},
|
|
extensions: [].concat(options.requireExtension || [])
|
|
.map(function (ext) {
|
|
return '.' + ext.replace(/^\./, '');
|
|
})
|
|
.concat(['.js', '.json', '.es6', '.jsx']),
|
|
transform: [babelify.configure({
|
|
sourceMap: false,
|
|
compact: false,
|
|
presets: [
|
|
require('babel-preset-es2015'),
|
|
require('babel-preset-stage-0'),
|
|
require('babel-preset-react')
|
|
],
|
|
plugins: [
|
|
require('babel-plugin-transform-decorators-legacy').default,
|
|
// Required to support webpack's System.import
|
|
// https://github.com/documentationjs/documentation/issues/578
|
|
require('babel-plugin-system-import-transformer').default
|
|
]
|
|
})],
|
|
postFilter: moduleFilters.externals(indexes, options)
|
|
});
|
|
smartGlob(indexes, options.parseExtensions).forEach(function (index) {
|
|
md.write(path.resolve(index));
|
|
});
|
|
md.end();
|
|
md.once('error', function (error) {
|
|
return callback(error);
|
|
});
|
|
md.pipe(concat(function (inputs) {
|
|
callback(null, inputs
|
|
.filter(function (input) {
|
|
// At this point, we may have allowed a JSON file to be caught by
|
|
// module-deps, or anything else allowed by requireExtension.
|
|
// otherwise module-deps would complain about
|
|
// it not being found. But Babel can't parse JSON, so we filter non-JavaScript
|
|
// files away.
|
|
return options.parseExtensions.indexOf(
|
|
path.extname(input.file).replace(/^\./, '')
|
|
) > -1;
|
|
})
|
|
.map(function (input) {
|
|
// un-transform babelify transformed source
|
|
input.source = fs.readFileSync(input.file, 'utf8');
|
|
return input;
|
|
}));
|
|
}));
|
|
}
|
|
|
|
module.exports = dependencyStream;
|