# create-exports-index > Creates ES6 ./index.js file in target directories that imports and exports all sibling files and directories. Latest version **1.3.0** (published 2018-03-21) · BSD-3-Clause license · 0 weekly downloads ## Install ```sh npm install create-exports-index pnpm add create-exports-index yarn add create-exports-index bun add create-exports-index ``` Provides the command `create-exports-index`. ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.3.0 | | Published | 2018-03-21 | | First published | 2018-02-09 | | Weekly downloads | 0 | | License | BSD-3-Clause | | TypeScript types | none | | Module format | CommonJS | | Node | >=5 | | Dependencies | 5 | | Unpacked size | 58.4 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 0 | | Author | Gajus Kuizinas | | Maintainers | cpt | | Keywords | index, import, export | ## Links - npm: https://www.npmjs.com/package/create-exports-index - Repository: https://github.com/colepatrickturner/create-index - Homepage: https://github.com/colepatrickturner/create-index#readme - Issues: https://github.com/colepatrickturner/create-index/issues - npm.io page: https://npm.io/package/create-exports-index ## Dependencies (5) - [glob](https://npm.io/package/glob.md) ^7.1.1 - [chalk](https://npm.io/package/chalk.md) ^1.1.3 - [yargs](https://npm.io/package/yargs.md) ^6.3.0 - [lodash](https://npm.io/package/lodash.md) ^4.16.6 - [moment](https://npm.io/package/moment.md) ^2.15.2 ## Recent versions - 1.3.0 (latest) — 2018-03-21 - 1.2.0 — 2018-02-09 ## README # create-exports-index [![NPM version](http://img.shields.io/npm/v/create-index.svg?style=flat-square)](https://www.npmjs.org/package/create-exports-index) `create-exports-index` program creates (and maintains) ES6 `./index.js` file in target directories that imports and exports sibling files and directories. ## What's different? `create-exports-index` is a fork of `create-index` that allows you to customize the output that's generated by `write-index`. If you also desire this behavior, please visit the following pull request and leave a comment to have this functionality merged into the main package: https://github.com/gajus/create-index/pull/43 ## Example ```sh > tree ./ ./ ├── bar.js └── foo.js 0 directories, 2 files > create-index ./ [13:17:34] Target directories [ './' ] [13:17:34] Update index: false [13:17:34] ./index.js [created index] [13:17:34] Done > tree . ├── bar.js ├── foo.js └── index.js 0 directories, 3 files ``` This created `index.js` with: ```js // @create-index export { default as bar } from './bar.js'; export { default as foo } from './foo.js'; ``` Lets create a new file and re-run `create-index`: ```js > touch baz.js > tree ./ ./ ├── bar.js ├── baz.js ├── foo.js └── index.js 0 directories, 4 files > create-index ./ [13:21:55] Target directories [ './' ] [13:21:55] Update index: false [13:21:55] ./index.js [updated index] [13:21:55] Done ``` This have updated `index.js` file: ```js // @create-index export { default as bar } from './bar.js'; export { default as baz } from './baz.js'; export { default as foo } from './foo.js'; ``` ## Usage ### Using CLI Program ```sh npm install create-index create-index --help Options: --recursive, -r Create/update index files recursively. Halts on any unsafe "index.js" files. [boolean] [default: false] --ignoreUnsafe, -i Ignores unsafe "index.js" files instead of halting. [boolean] [default: false] --update, -u Updates only previously created index files (recursively). [boolean] [default: false] --banner Add a custom banner at the top of the index file [string] Examples: create-index ./src ./src/utilities Creates or updates an existing create-index index file in the target (./src, ./src/utilities) directories. create-index --update ./src ./tests Finds all create-index index files in the target directories and descending directories. Updates found index files. ``` ### Using `create-index` Programmatically ```js import { writeIndex } from 'create-index'; /** * @type {Function} * @param {Array} directoryPaths * @throws {Error} Directory "..." does not exist. * @throws {Error} "..." is not a directory. * @throws {Error} "..." unsafe index. * @returns {boolean} */ writeIndex; writeIndex(['./target_directory'], {}, (varName, fileName) => `export * as ${varName} from './${fileName}`); // export * as Example from './Example'; ``` Note that the `writeIndex` function is synchronous. ```js import { findIndexFiles } from 'create-index'; /** * @type {Function} * @param {string} directoryPath * @returns {Array} List of directory paths that have create-index index file. */ findIndexFiles; ``` ### Gulp Since [Gulp](http://gulpjs.com/) can ran arbitrary JavaScript code, there is no need for a separate plugin. See [Using `create-index` Programmatically](#using-create-index-programmatically). ```js import { writeIndex } from 'create-index'; gulp.task('create-index', () => { writeIndex(['./target_directory']); }); ``` Note that the `writeIndex` function is synchronous. ## Implementation `create-index` program will look into the target directory. If there is no `./index.js`, it will create a new file, e.g. ```js // @create-index ``` Created index file must start with `// @create-index\n\n`. This is used to make sure that `create-index` does not accidentally overwrite your local files. If there are sibling files, index file will `import` them and `export`, e.g. ```sh children-directories-and-files git:(master) ✗ ls -lah total 0 drwxr-xr-x 5 gajus staff 170B 6 Jan 15:39 . drwxr-xr-x 10 gajus staff 340B 6 Jan 15:53 .. drwxr-xr-x 2 gajus staff 68B 6 Jan 15:29 bar drwxr-xr-x 2 gajus staff 68B 6 Jan 15:29 foo -rw-r--r-- 1 gajus staff 0B 6 Jan 15:29 foo.js ``` Given the above directory contents, `./index.js` will be: ```js // @create-index import { default as bar } from './bar'; import { default as foo } from './foo.js'; export { bar, foo }; ``` When file has the same name as a sibling directory, file `import` takes precedence. Directories that do not have `./index.js` in themselves will be excluded. When run again, `create-index` will update existing `./index.js` if it starts with `// @create-index\n\n`. If `create-index` is executed against a directory that contains `./index.js`, which does not start with `// @create-index\n\n`, an error will be thrown. ## Ignore files on `--update` `create-index` can ignore files in a directory if `./index.js` contains special object with defined `ignore` property which takes `an array` of `regular expressions` defined as `strings`, e.g. ```js > cat index.js // @create-index {"ignore": ["/baz.js$/"]} ``` ```js > tree ./ ./ ├── bar.js ├── baz.js ├── foo.js └── index.js 0 directories, 4 files ``` Given the above directory contents, after running `create-index` with `--update` flag, `./index.js` will be: ```js // @create-index {"ignore": ["/baz.js$/"]} import { default as bar } from './bar.js'; import { default as foo } from './foo.js'; export { bar, foo }; ``` --- _Source: https://npm.io/package/create-exports-index · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._