glob-module-file

Pass in a file pattern and an output path, and a file will be created that imports all the matching files, and then exports them as a single array.

Why would you need this?

It's really nice to be able to auto-initialize a whole bunch of parts of your application, without having to maintain a list of modules to require in your index.js:

1// Maintaining this is inconvenient
2const coolService = require('./service/cool/the-coolest.js')
3const niftyService = require('./service/nifty/nearly-as-cool.js')
4const yetAnotherService = require('./service/hope-you-didnt-forget-any-other-files.js')
5
6coolService(initialConfig)
7niftyService(initialConfig)
8yetAnotherService(initialConfig)

To avoid dealing with such ever-growing lists of modules, I've used this pattern in node.js code:

1glob.sync('service/**/*.js', { ignore: 'service/**/*.test.js' })
2.map(file => require(`./${file}`))
3.forEach(moduleFunction => {
4	moduleFunction(initialConfig)
5})

It finds all the js files in a part of the application's directory tree, requires them, and then runs them as a function passing in some initial options.

However

The above code doesn't work for client-side apps built with a bundler.

Bundlers must be able to tell which files will be loaded by reading the code, without executing it.

So, you're back to maintaining a long list imports/requires somewhere. Unless you use this library.

What does it do?

Given these files:

fixtures/one.js
fixtures/someDirectory/two.js

Calling this library and passing in fixtures/**/*.js and my-globbed-files.js will cause it to spit out a file containing:

1const fixtures$47$one$46$js = require('./fixtures/one.js')
2const fixtures$47$someDirectory$47$two$46$js = require('./fixtures/someDirectory/two.js')
3
4module.exports = [
5	fixtures$47$one$46$js,
6	fixtures$47$someDirectory$47$two$46$js,
7]

or, for es6 module bundlers:

1import fixtures$47$one$46$js from './fixtures/one.js'
2import fixtures$47$someDirectory$47$two$46$js from './fixtures/someDirectory/two.js'
3
4export default [
5	fixtures$47$one$46$js,
6	fixtures$47$someDirectory$47$two$46$js,
7]

Then, all your index file needs to do is

1require('my-globbed-files.js').forEach(moduleFunction => {
2	moduleFunction(initialConfig)
3})

API

globModuleFile(options, [globOptions])

Returns a promise that resolves to the JS code with all the requires/imports and exports.

If an outputPath is provided, the promise will not resolve until after the file is done being written.

options

• pattern: (required): Passed to glob.
• outputPath: A file to be created or overwritten with all of the import code.
• exportWithPath: If false, exports whatever value was imported from the original file. If true, exports an object { path: thePathStringThatWasImported, export: theObjectExportedFromTheGlobbedFile }. Defaults to false.
• format: Specify the module output - either the string es (import/export) or cjs (require/module.exports). Defaults to cjs
• sortFunction: A comparison function to be passed to Array.sort to determine the order to import the files in (and determine their order in the output array). Defaults to a function that orders by how deep in the directory structure the file is (shallowest to deepest).
• pathPrefix: A string to be prepended to the paths passed to require. Defaults to ./
• importStar: whether to use import * as whateverExport instead of import defaultExport when outputting ES module syntax. Defaults to false

globOptions

Optional. Passed straight through as the options argument to glob.

Example

1const expected = `const fixtures$47$one$46$js = require('./fixtures/one.js')
2const fixtures$47$someDirectory$47$two$46$js = require('./fixtures/someDirectory/two.js')
3
4module.exports = [
5\tfixtures$47$one$46$js,
6\tfixtures$47$someDirectory$47$two$46$js,
7]
8`
9
10globModuleFiles({ pattern: 'fixtures/**/*.js', outputPath: '/tmp/globbed.js' }).then(code => {
11	code // => expected
12
13	require('fs').readFileSync('/tmp/globbed.js', { encoding: 'utf8' }) // => code
14}).catch(err => {
15	console.error(err)
16})

CLI

1glob-module-file --pattern="fixtures/**/*.js" --format=es --ignore="**/one.js"

Takes any number of named arguments corresponding to the options objects above.

Spits the code to stdout so you can pipe it into a file or what have you.

License

WTFPL