files-generator

A tool to generate bunch of files, using different kinds of content definition and sources

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
files-generator
0.5.07 years ago7 years agoMinified + gzip package size for files-generator in KB

Readme

Files Generator
draft
Branch : release version npm version
Build Status Coverage Status
Dependency Status devDependency Status
A tool to generate bunch of files, using different kinds of content definition and sources

Install

npm i files-generator

Basic usage

const generate = require('files-generator')();

generate({
  'path/to/file': 'file content',
  'path/to/file2': generate.use('other file content')
});
generate.on('finish', event => {
  console.log(event.success); // ["path/to/file", "path/to/file2"]
})

Documentation

generateGenerate

Create a generate function using the defined options
Parameters
  • options object? An object containing the generate function options. (optional, default {})
-   `options.eventData` **[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** Each time that generate will emit an event, the event handler will receive as first argument an event object with a data key containing this eventData option. (optional, default `undefined`)
-   `options.writeFile` **[function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function)?** The function which will be used to create files and/or directories. (optional, default `defaultWriteFile`)
-   `options.encoding` **[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** The encoding to use when writing files. (optional, default `'utf-8'`)
-   `options.cwd` **[string](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** The cwd used if you try to generate some relative paths. Must be an absolute path. (optional, default `process.cwd()`)
Returns generate A generate function which uses by default the options provided as generateGenerate parameters

generate

Generate files from different kinds of inputs
Parameters
  • generateConfig GenerateConfig The generate config contains all the file paths to generate.
  • options object This options object can be used to overide some options defined in the generateGenerate function. (optional, default {})
-   `options.eventData`   (optional, default `_eventData`)
-   `options.writeFile`   (optional, default `_writeFile`)
-   `options.encoding`   (optional, default `_encoding`)
-   `options.cwd`   (optional, default `_cwd`)
Returns
undefined

License

files-generator is released under MIT
. Copyright (c) 2017-present Alexis Tessier