feat: using writeIndex programatically was not respecting passed options configuration (#41)

* Create .gitattributes

* pass full options object to createIndexCode in writeIndex

.babelrc

@@ -0,0 +1,8 @@
+{
+  "plugins": [
+    "transform-es2015-modules-commonjs",
+    "transform-export-extensions",
+    "transform-es2015-destructuring",
+    "transform-es2015-parameters"
+  ]
+}

.editorconfig

@@ -0,0 +1,7 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2

.eslintignore

@@ -0,0 +1 @@
+./test/fixtures

.eslintrc

@@ -0,0 +1,3 @@
+{
+  "extends": "canonical"
+}

.gitattributes

@@ -0,0 +1 @@
+* text eol=lf

.gitignore

@@ -1,9 +1,12 @@
-node_modules
 coverage
 dist
+node_modules
 *.log
 .*
+!.babelrc
+!.editorconfig
+!.eslintignore
+!.eslintrc
 !.gitignore
 !.npmignore
-!.babelrc
 !.travis.yml

.npmignore

@@ -1,6 +1,6 @@
+coverage
 fixtures
 src
-tests
+test
-coverage
 .*
 *.log

.travis.yml

@@ -1,7 +1,11 @@
 language: node_js
 node_js:
-    - '5.0'
+  - node
-    - '4.0'
+  - 7
+  - 6
+  - 5
+after_success:
+  - semantic-release pre && npm publish && semantic-release post
 notifications:
-    email: false
+  email: false
 sudo: false

README.md

@@ -6,6 +6,72 @@
 
 `create-index` program creates (and maintains) ES6 `./index.js` file in target directories that imports and exports sibling files and directories.
 
+## 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
@@ -16,20 +82,21 @@ npm install create-index
 create-index --help
 
 Options:
-  --update-index  Recursively iterates target directories looking for "index.js"
+  --recursive, -r     Create/update index files recursively. Halts on any unsafe
-                  files that start with "'create index';\n" (create-index index
+                      "index.js" files.               [boolean] [default: false]
-                  file). Updates found index files. Does not create new index
+  --ignoreUnsafe, -i  Ignores unsafe "index.js" files instead of halting.
-                  files.                              [boolean] [default: false]
+                                                      [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 ./src ./src/utilities   Creates or updates an existing
-                                            create-index index file in the
+                                       create-index index file in the target
-                                            target (./src, ./src/utilities)
+                                       (./src, ./src/utilities) directories.
-                                            directories.
+  create-index --update ./src ./tests  Finds all create-index index files in the
-  create-index --update-index ./src         Finds all create-index index files
+                                       target directories and descending
-  ./tests                                   in the target directories and
+                                       directories. Updates found index files.
-                                            descending directories. Updates
-                                            found index files.
 ```
 
 ### Using `create-index` Programmatically
@@ -88,10 +155,10 @@ Note that the `writeIndex` function is synchronous.
 If there is no `./index.js`, it will create a new file, e.g.
 
 ```js
-'create index';
+// @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.
+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.
 
@@ -108,10 +175,10 @@ drwxr-xr-x   2 gajus  staff    68B  6 Jan 15:29 foo
 Given the above directory contents, `./index.js` will be:
 
 ```js
-'create index';
+// @create-index
 
-import bar from './bar';
+import { default as bar } from './bar';
-import foo from './foo.js';
+import { default as foo } from './foo.js';
 
 export {
     bar,
@@ -123,6 +190,40 @@ When file has the same name as a sibling directory, file `import` takes preceden
 
 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`.
+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.
+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
+};
+```

fixtures/find-index-files/do-not-find-no-index/not-index.js

@@ -1 +0,0 @@
-'create index';

fixtures/find-index-files/do-not-find/index.js

@@ -1 +0,0 @@
-// 'create index';

fixtures/find-index-files/find-1/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/find-index-files/nested/do-not-find/index.js

@@ -1 +0,0 @@
-// 'create index';

fixtures/find-index-files/nested/find-2/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/find-index-files/nested/find-3/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-and-files/foo/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-unsafe-name/bar-bar/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-unsafe-name/foo-foo/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-unsafe-name/present/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-without-index/bar/bar.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-without-index/foo/foo.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories-without-index/present.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories/bar/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-directories/foo/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-index/bar/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-index/foo/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/read-directory/children-index/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/validate-target-directory/safe-index/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/write-index/mixed/bar/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/write-index/mixed/foo/index.js

@@ -1 +0,0 @@
-'create index';

fixtures/write-index/mixed/index.js

@@ -1,5 +0,0 @@
-'create index';
-
-export bar from './bar';
-export foo from './foo.js';
-

package.json

@@ -1,44 +1,54 @@
 {
-  "name": "create-index",
+  "author": {
-  "description": "Creates ES6 ./index.js file in target directories that imports and exports all sibling files and directories.",
+    "email": "gajus@gajus.com",
-  "version": "0.1.0",
+    "name": "Gajus Kuizinas",
-  "main": "./dist/index.js",
+    "url": "http://gajus.com"
+  },
   "bin": "./dist/bin/create-index.js",
-  "repository": {
+  "dependencies": {
-    "type": "git",
+    "chalk": "^1.1.3",
-    "url": "https://github.com/gajus/create-index"
+    "glob": "^7.1.1",
+    "lodash": "^4.16.6",
+    "moment": "^2.15.2",
+    "yargs": "^6.3.0"
+  },
+  "description": "Creates ES6 ./index.js file in target directories that imports and exports all sibling files and directories.",
+  "devDependencies": {
+    "babel-cli": "^6.18.0",
+    "babel-plugin-transform-es2015-destructuring": "^6.18.0",
+    "babel-plugin-transform-es2015-modules-commonjs": "^6.18.0",
+    "babel-plugin-transform-es2015-parameters": "^6.18.0",
+    "babel-plugin-transform-export-extensions": "^6.8.0",
+    "babel-register": "^6.18.0",
+    "chai": "^3.5.0",
+    "cross-env": "^3.1.3",
+    "eslint": "^3.9.1",
+    "eslint-config-canonical": "^4.0.0",
+    "husky": "^0.11.9",
+    "mocha": "^3.1.2",
+    "semantic-release": "^6.3.2"
+  },
+  "engines": {
+    "node": ">=5"
   },
   "keywords": [
     "index",
     "import",
     "export"
   ],
-  "author": {
-    "name": "Gajus Kuizinas",
-    "email": "gajus@gajus.com",
-    "url": "http://gajus.com"
-  },
   "license": "BSD-3-Clause",
+  "main": "./dist/index.js",
+  "name": "create-index",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gajus/create-index"
+  },
   "scripts": {
-    "pragmatist": "node ./node_modules/.bin/pragmatist --es5",
+    "build": "cross-env NODE_ENV=production babel --source-maps --copy-files ./src --out-dir ./dist",
-    "lint": "npm run pragmatist lint",
+    "create-index": "node ./dist/bin/create-index ./src/utilities",
-    "test": "npm run pragmatist test",
+    "lint": "cross-env NODE_ENV=development eslint ./src ./tests",
-    "build": "npm run pragmatist build",
+    "precommit": "npm run test",
-    "watch": "npm run pragmatist watch",
+    "test": "npm run build && npm run lint && cross-env NODE_ENV=development mocha --compilers js:babel-register"
-    "watch-lint": "npm run pragmatist watch-lint",
-    "watch-test": "npm run pragmatist watch-test",
-    "watch-build": "npm run pragmatist watch-build",
-    "create-index": "node ./dist/bin/create-index ./src/utilities"
   },
-  "devDependencies": {
+  "version": "1.1.0"
-    "chai": "^3.5.0",
-    "chalk": "^1.1.1",
-    "moment": "^2.11.1",
-    "pragmatist": "^3.0.3"
-  },
-  "dependencies": {
-    "glob": "^6.0.4",
-    "lodash": "^4.0.1",
-    "yargs": "^4.0.0-alpha1"
-  }
 }

src/bin/create-index.js

@@ -3,23 +3,57 @@
 import yargs from 'yargs';
 import {
     writeIndexCli
-} from './../utilities';
+} from '../utilities';
 
-let argv;
+const argv = yargs
-
+  .demand(1)
-argv = yargs
+  .options({
-    .demand(1)
+    recursive: {
-    .options({
+      alias: 'r',
-        'update-index': {
+      default: false,
-            default: false,
+      description: 'Create/update index files recursively. Halts on any unsafe "index.js" files.',
-            description: 'Recursively iterates target directories looking for "index.js" files that start with "\'create index\';\\n" (create-index index file). Updates found index files. Does not create new index files.',
+      type: 'boolean'
-            type: 'boolean'
+    }
-        }
+  })
-    })
+  .options({
-    .example('create-index ./src ./src/utilities', 'Creates or updates an existing create-index index file in the target (./src, ./src/utilities) directories.')
+    ignoreUnsafe: {
-    .example('create-index --update-index ./src ./tests', 'Finds all create-index index files in the target directories and descending directories. Updates found index files.')
+      alias: 'i',
-    .argv;
+      default: false,
+      description: 'Ignores unsafe "index.js" files instead of halting.',
+      type: 'boolean'
+    }
+  })
+  .options({
+    update: {
+      alias: 'u',
+      default: false,
+      description: 'Updates only previously created index files (recursively).',
+      type: 'boolean'
+    }
+  })
+  .options({
+    banner: {
+      description: 'Add a custom banner at the top of the index file',
+      type: 'string'
+    }
+  })
+  .options({
+    extensions: {
+      alias: 'x',
+      default: ['js'],
+      description: 'Allows some extensions to be parsed as valid source. First extension will always be preferred to homonyms with another allowed extension.',
+      type: 'array'
+    }
+  })
+  .example('create-index ./src ./src/utilities', 'Creates or updates an existing create-index index file in the target (./src, ./src/utilities) directories.')
+  .example('create-index --update ./src ./tests', 'Finds all create-index index files in the target directories and descending directories. Updates found index files.')
+  .example('create-index ./src --extensions js jsx', 'Creates or updates an existing create-index index file in the target (./src) directory for both .js and .jsx extensions.')
+  .argv;
 
 writeIndexCli(argv._, {
-    updateIndex: argv.updateIndex
+  banner: argv.banner,
+  extensions: argv.extensions,
+  ignoreUnsafe: argv.ignoreUnsafe,
+  recursive: argv.recursive,
+  updateIndex: argv.update
 });

src/index.js

@@ -1,4 +1,4 @@
 export {
-    findIndexFiles,
+  findIndexFiles,
-    writeIndex
+  writeIndex
 } from './utilities';

src/utilities/constants.js

@@ -0,0 +1,2 @@
+// eslint-disable-next-line
+export const CREATE_INDEX_PATTERN = /(?:^|[\n\r]+)\/\/ @create-index\s?({.*})?[\n\r]+/;

src/utilities/createIndexCode.js

@@ -1,43 +1,55 @@
 import _ from 'lodash';
 
-let buildExportBlock,
+const safeVariableName = (fileName) => {
-    safeVariableName;
+  const indexOfDot = fileName.indexOf('.');
 
-safeVariableName = (fileName) => {
+  if (indexOfDot === -1) {
-    let indexOfDot;
+    return fileName;
-
+  } else {
-    indexOfDot = fileName.indexOf('.');
+    return fileName.slice(0, indexOfDot);
-
+  }
-    if (indexOfDot === -1) {
-        return fileName;
-    } else {
-        return fileName.slice(0, indexOfDot);
-    }
 };
 
-buildExportBlock = (files) => {
+const buildExportBlock = (files) => {
-    let importBlock;
+  let importBlock;
 
-    importBlock = _.map(files, (fileName) => {
+  importBlock = _.map(files, (fileName) => {
-        return 'export ' + safeVariableName(fileName) + ' from \'./' + fileName + '\';';
+    return 'export { default as ' + safeVariableName(fileName) + ' } from \'./' + fileName + '\';';
+  });
+
+  importBlock = importBlock.join('\n');
+
+  return importBlock;
+};
+
+export default (filePaths, options = {}) => {
+  let code;
+  let configCode;
+
+  code = '';
+  configCode = '';
+
+  if (options.banner) {
+    const banners = _.isArray(options.banner) ? options.banner : [options.banner];
+
+    banners.forEach((banner) => {
+      code += banner + '\n';
     });
 
-    importBlock = importBlock.join('\n');
+    code += '\n';
+  }
 
-    return importBlock;
+  if (options.config && _.size(options.config) > 0) {
-};
+    configCode += ' ' + JSON.stringify(options.config);
+  }
 
-export default (filePaths) => {
+  code += '// @create-index' + configCode + '\n\n';
-    let code,
-        sortedFilePaths;
 
-    code = '\'create index\';\n\n';
+  if (filePaths.length) {
+    const sortedFilePaths = filePaths.sort();
 
-    if (filePaths.length) {
+    code += buildExportBlock(sortedFilePaths) + '\n\n';
-        sortedFilePaths = filePaths.sort();
+  }
 
-        code += buildExportBlock(sortedFilePaths) + '\n\n';
+  return code;
-    }
-
-    return code;
 };

src/utilities/findIndexFiles.js

@@ -1,28 +1,23 @@
+import path from 'path';
 import _ from 'lodash';
 import glob from 'glob';
-import path from 'path';
 import validateTargetDirectory from './validateTargetDirectory';
 
-export default (directoryPath) => {
+export default (directoryPath, options = {}) => {
-    let targetDirectories;
+  let fileName, targetDirectories;
 
-    targetDirectories = glob.sync(path.join(directoryPath, './**/index.js'));
+  fileName = options.fileName || 'index.js';
+  fileName = './**/' + fileName;
 
-    targetDirectories = _.filter(targetDirectories, (targetDirectoryPath) => {
+  targetDirectories = glob.sync(path.join(directoryPath, fileName));
-        try {
-            validateTargetDirectory(path.dirname(targetDirectoryPath));
 
-            return true;
+  targetDirectories = _.filter(targetDirectories, (targetDirectoryPath) => {
-        /* eslint-disable no-empty */
+    return validateTargetDirectory(path.dirname(targetDirectoryPath), {
-        } catch (error) {
+      silent: options.silent
-
-        }
-        /* eslint-enable no-empty */
-
-        return false;
     });
+  });
 
-    targetDirectories = _.map(targetDirectories, path.dirname);
+  targetDirectories = _.map(targetDirectories, path.dirname);
 
-    return targetDirectories;
+  return targetDirectories;
 };

src/utilities/hasIndex.js

@@ -0,0 +1,14 @@
+import fs from 'fs';
+import path from 'path';
+
+export default (directoryPath) => {
+  const indexPath = path.resolve(directoryPath, 'index.js');
+
+  try {
+    fs.statSync(indexPath);
+
+    return true;
+  } catch (error) {
+    return false;
+  }
+};

src/utilities/index.js

@@ -1,4 +1,4 @@
-'create index';
+// @create-index
 
 export createIndexCode from './createIndexCode.js';
 export findIndexFiles from './findIndexFiles.js';
@@ -8,4 +8,3 @@ export sortByDepth from './sortByDepth.js';
 export validateTargetDirectory from './validateTargetDirectory.js';
 export writeIndex from './writeIndex.js';
 export writeIndexCli from './writeIndexCli.js';
-

src/utilities/log.js

@@ -2,7 +2,6 @@ import chalk from 'chalk';
 import moment from 'moment';
 
 export default (...append) => {
-    /* eslint-disable no-console */
+  // eslint-disable-next-line
-    console.log(chalk.dim('[' + moment().format('HH:mm:ss') + ']'), ...append);
+  console.log(chalk.dim('[' + moment().format('HH:mm:ss') + ']'), ...append);
-    /* eslint-enable no-console */
 };

src/utilities/readDirectory.js

@@ -1,97 +1,125 @@
 import fs from 'fs';
-import _ from 'lodash';
 import path from 'path';
+import _ from 'lodash';
+import hasIndex from './hasIndex';
 import validateTargetDirectory from './validateTargetDirectory';
 
-let hasIndex,
+const hasNoExtension = (fileName) => {
-    hasMultipleExtensions,
+  const matches = fileName.match(/\./g);
-    hasNoExtension,
-    isSafeName,
-    removeDuplicates;
 
-hasIndex = (directoryPath) => {
+  return !matches;
-    let indexPath;
+};
 
-    indexPath = path.resolve(directoryPath, 'index.js');
+const hasMultipleExtensions = (fileName) => {
+  const matches = fileName.match(/\./g);
 
-    try {
+  return matches && matches.length > 1;
-        fs.statSync(indexPath);
+};
 
-        return true;
+const isSafeName = (fileName) => {
-    } catch (error) {
+  return /^[a-z][a-z0-9._]+$/i.test(fileName);
-        return false;
+};
+
+const stripExtension = (fileName) => {
+  const pos = fileName.lastIndexOf('.');
+
+  if (pos === -1) {
+    return fileName;
+  }
+
+  return fileName.substr(0, pos);
+};
+
+const removeDuplicates = (files, preferredExtension) => {
+  return _.filter(files, (fileName) => {
+    const withoutExtension = stripExtension(fileName);
+    const mainAlternative = withoutExtension + '.' + preferredExtension;
+
+    if (mainAlternative === fileName) {
+      return true;
     }
+
+    return !_.includes(files, mainAlternative);
+  });
 };
 
-hasNoExtension = (fileName) => {
+const removeIgnoredFiles = (files, ignorePatterns = []) => {
-    let matches;
+  if (ignorePatterns.length === 0) {
+    return files;
+  }
 
-    matches = fileName.match(/\./g);
+  const patterns = ignorePatterns.map((pattern) => {
+    if (_.startsWith(pattern, '/') && _.endsWith(pattern, '/')) {
+      const patternWithoutSlashes = pattern.slice(1, -1);
 
-    return !matches;
+      return new RegExp(patternWithoutSlashes);
+    }
+
+    return new RegExp(pattern);
+  });
+
+  return _.filter(files, (fileName) => {
+    let pattern;
+
+    for (pattern of patterns) {
+      if (fileName.match(pattern) !== null) {
+        return false;
+      }
+    }
+
+    return true;
+  });
 };
 
-hasMultipleExtensions = (fileName) => {
+export default (directoryPath, options = {}) => {
-    let matches;
+  if (!validateTargetDirectory(directoryPath, {silent: options.silent})) {
+    return false;
+  }
 
-    matches = fileName.match(/\./g);
+  const {
+    extensions = ['js'],
+    config = {}
+  } = options;
 
-    return matches && matches.length > 1;
+  let children;
-};
 
-isSafeName = (fileName) => {
+  children = fs.readdirSync(directoryPath);
-    return /^[a-z][a-z0-9\.]+$/i.test(fileName);
-};
 
-removeDuplicates = (files) => {
+  children = _.filter(children, (fileName) => {
-    return _.filter(files, (fileName) => {
+    const absolutePath = path.resolve(directoryPath, fileName);
-        return !_.includes(files, fileName + '.js');
+    const isDirectory = fs.statSync(absolutePath).isDirectory();
-    });
-};
 
-export default (directoryPath) => {
+    if (!isSafeName(fileName)) {
-    let children;
+      return false;
+    }
 
-    validateTargetDirectory(directoryPath);
+    if (hasNoExtension(fileName) && !isDirectory) {
+      return false;
+    }
 
-    children = fs.readdirSync(directoryPath);
+    if (hasMultipleExtensions(fileName)) {
+      return false;
+    }
 
-    children = _.filter(children, (fileName) => {
+    if (_.startsWith(fileName, 'index.js')) {
-        let absolutePath,
+      return false;
-            isDirectory;
+    }
 
-        absolutePath = path.resolve(directoryPath, fileName);
+    if (!isDirectory && !extensions.some((ext) => {
+      return _.endsWith(fileName, '.' + ext);
+    })) {
+      return false;
+    }
 
-        isDirectory = fs.statSync(absolutePath).isDirectory();
+    if (isDirectory && !hasIndex(absolutePath)) {
+      return false;
+    }
 
-        if (!isSafeName(fileName)) {
+    return true;
-            return false;
+  });
-        }
 
-        if (hasNoExtension(fileName) && !isDirectory) {
+  children = removeDuplicates(children, extensions[0]);
-            return false;
+  children = removeIgnoredFiles(children, config.ignore);
-        }
 
-        if (hasMultipleExtensions(fileName)) {
+  return children.sort();
-            return false;
-        }
-
-        if (_.startsWith(fileName, 'index.js')) {
-            return false;
-        }
-
-        if (!isDirectory && !_.endsWith(fileName, '.js')) {
-            return false;
-        }
-
-        if (isDirectory && !hasIndex(absolutePath)) {
-            return false;
-        }
-
-        return true;
-    });
-
-    children = removeDuplicates(children);
-
-    return children.sort();
 };

src/utilities/readIndexConfig.js

@@ -0,0 +1,32 @@
+import fs from 'fs';
+import path from 'path';
+import hasIndex from './hasIndex';
+import {CREATE_INDEX_PATTERN} from './constants';
+
+export default (directoryPath) => {
+  if (!hasIndex(directoryPath)) {
+    return {};
+  }
+
+  const indexPath = path.resolve(directoryPath, 'index.js');
+  const indexContents = fs.readFileSync(indexPath, 'utf-8');
+  const found = indexContents.match(CREATE_INDEX_PATTERN);
+  const configLine = typeof found[1] === 'string' ? found[1].trim() : '';
+
+  if (configLine.length === 0) {
+    return {};
+  }
+
+  let config;
+
+  try {
+    config = JSON.parse(configLine);
+  } catch (error) {
+    throw new Error(
+      '"' + indexPath + '" contains invalid configuration object.\n' +
+      'Configuration object must be a valid JSON.'
+    );
+  }
+
+  return config;
+};

src/utilities/sortByDepth.js

@@ -1,7 +1,7 @@
 import _ from 'lodash';
 
 export default (paths) => {
-    return _.sortBy(paths, (path) => {
+  return _.sortBy(paths, (path) => {
-        return -path.split('/').length;
+    return -path.split('/').length;
-    });
+  });
 };

src/utilities/validateTargetDirectory.js

@@ -1,35 +1,47 @@
-import _ from 'lodash';
 import fs from 'fs';
 import path from 'path';
+import {CREATE_INDEX_PATTERN} from './constants';
 
-export default (targetDirectory) => {
+export default (targetDirectory, options = {}) => {
-    let indexFile,
+  const silent = options.silent;
-        indexFilePath,
+  let stats;
-        stats;
 
-    try {
+  try {
-        stats = fs.statSync(targetDirectory);
+    stats = fs.statSync(targetDirectory);
-    } catch (error) {
+  } catch (error) {
-        throw new Error('Directory "' + targetDirectory + '" does not exist.');
+    if (silent) {
+      return false;
+    } else {
+      throw new Error('Directory "' + targetDirectory + '" does not exist.');
     }
+  }
 
-    if (!stats.isDirectory()) {
+  if (!stats.isDirectory()) {
-        throw new Error('"' + targetDirectory + '" is not a directory.');
+    if (silent) {
+      return false;
+    } else {
+      throw new Error('"' + targetDirectory + '" is not a directory.');
     }
+  }
 
-    indexFilePath = path.resolve(targetDirectory, './index.js');
+  const indexFilePath = path.resolve(targetDirectory, './index.js');
-
-    try {
-        fs.statSync(indexFilePath);
-    } catch (error) {
-        return true;
-    }
-
-    indexFile = fs.readFileSync(indexFilePath, 'utf8');
-
-    if (!_.startsWith(indexFile, '\'create index\';\n')) {
-        throw new Error('"' + indexFilePath + '" unsafe index.');
-    }
 
+  try {
+    fs.statSync(indexFilePath);
+  } catch (error) {
     return true;
+  }
+
+  const indexFile = fs.readFileSync(indexFilePath, 'utf8');
+
+  if (!indexFile.match(CREATE_INDEX_PATTERN)) {
+    if (silent) {
+      return false;
+    } else {
+      throw new Error('"' + indexFilePath + '" unsafe index.');
+    }
+  }
+
+  return true;
 };
+

src/utilities/writeIndex.js

@@ -1,31 +1,25 @@
-import _ from 'lodash';
-import createIndexCode from './createIndexCode';
 import fs from 'fs';
 import path from 'path';
+import _ from 'lodash';
+import createIndexCode from './createIndexCode';
 import validateTargetDirectory from './validateTargetDirectory';
 import readDirectory from './readDirectory';
+import readIndexConfig from './readIndexConfig';
 import sortByDepth from './sortByDepth';
 
-export default (directoryPaths) => {
+export default (directoryPaths, options = {}) => {
-    let sortedDirectoryPaths;
+  const sortedDirectoryPaths = sortByDepth(directoryPaths)
-
+    .filter((directoryPath) => {
-    sortedDirectoryPaths = sortByDepth(directoryPaths);
+      return validateTargetDirectory(directoryPath, {silent: options.ignoreUnsafe});
-
-    _.forEach(sortedDirectoryPaths, (directoryPath) => {
-        validateTargetDirectory(directoryPath);
     });
 
-    _.forEach(sortedDirectoryPaths, (directoryPath) => {
+  _.forEach(sortedDirectoryPaths, (directoryPath) => {
-        let indexCode,
+    const config = readIndexConfig(directoryPath);
-            indexFilePath,
+    const optionsWithConfig = Object.assign({}, options, {config});
-            siblings;
+    const siblings = readDirectory(directoryPath, optionsWithConfig);
+    const indexCode = createIndexCode(siblings, optionsWithConfig);
+    const indexFilePath = path.resolve(directoryPath, 'index.js');
 
-        siblings = readDirectory(directoryPath);
+    fs.writeFileSync(indexFilePath, indexCode);
-
+  });
-        indexCode = createIndexCode(siblings);
-
-        indexFilePath = path.resolve(directoryPath, 'index.js');
-
-        fs.writeFileSync(indexFilePath, indexCode);
-    });
 };

src/utilities/writeIndexCli.js

@@ -1,65 +1,85 @@
-import _ from 'lodash';
-import createIndexCode from './createIndexCode';
 import fs from 'fs';
 import path from 'path';
+import _ from 'lodash';
+import chalk from 'chalk';
+import createIndexCode from './createIndexCode';
 import validateTargetDirectory from './validateTargetDirectory';
 import readDirectory from './readDirectory';
+import readIndexConfig from './readIndexConfig';
 import sortByDepth from './sortByDepth';
 import log from './log';
 import findIndexFiles from './findIndexFiles';
-import chalk from 'chalk';
 
 export default (directoryPaths, options = {}) => {
-    let sortedDirectoryPaths;
+  let sortedDirectoryPaths;
 
-    sortedDirectoryPaths = sortByDepth(directoryPaths);
+  sortedDirectoryPaths = sortByDepth(directoryPaths);
 
-    log('Target directories', sortedDirectoryPaths);
+  log('Target directories', sortedDirectoryPaths);
+  if (options.updateIndex) {
     log('Update index:', options.updateIndex ? chalk.green('true') : chalk.red('false'));
+  } else {
+    log('Recursive:', options.recursive ? chalk.green('true') : chalk.red('false'));
+    log('Ignore unsafe:', options.ignoreUnsafe ? chalk.green('true') : chalk.red('false'));
+    log('Extensions:', chalk.green(options.extensions));
+  }
 
-    if (options.updateIndex) {
+  if (options.updateIndex || options.recursive) {
-        sortedDirectoryPaths = _.map(sortedDirectoryPaths, findIndexFiles);
+    sortedDirectoryPaths = _.map(sortedDirectoryPaths, (dir) => {
-        sortedDirectoryPaths = _.flatten(sortedDirectoryPaths);
+      return findIndexFiles(dir, {
-        sortedDirectoryPaths = _.uniq(sortedDirectoryPaths);
+        fileName: options.updateIndex ? 'index.js' : '*',
-        sortedDirectoryPaths = sortByDepth(sortedDirectoryPaths);
+        silent: options.updateIndex || options.ignoreUnsafe
+      });
+    });
+    sortedDirectoryPaths = _.flatten(sortedDirectoryPaths);
+    sortedDirectoryPaths = _.uniq(sortedDirectoryPaths);
+    sortedDirectoryPaths = sortByDepth(sortedDirectoryPaths);
+
+    log('Updating index files in:', sortedDirectoryPaths.reverse().join(', '));
+  }
+
+  sortedDirectoryPaths = sortedDirectoryPaths.filter((directoryPath) => {
+    return validateTargetDirectory(directoryPath, {silent: options.ignoreUnsafe});
+  });
+
+  _.forEach(sortedDirectoryPaths, (directoryPath) => {
+    let existingIndexCode;
+
+    const config = readIndexConfig(directoryPath);
+
+    const siblings = readDirectory(directoryPath, {
+      config,
+      extensions: options.extensions,
+      silent: options.ignoreUnsafe
+    });
+
+    const indexCode = createIndexCode(siblings, {
+      banner: options.banner,
+      config
+    });
+
+    const indexFilePath = path.resolve(directoryPath, 'index.js');
+
+    try {
+      existingIndexCode = fs.readFileSync(indexFilePath, 'utf8');
+
+        /* eslint-disable no-empty */
+    } catch (error) {
 
-        log('Found index file in:', sortedDirectoryPaths);
     }
 
-    _.forEach(sortedDirectoryPaths, (directoryPath) => {
-        validateTargetDirectory(directoryPath);
-    });
-
-    _.forEach(sortedDirectoryPaths, (directoryPath) => {
-        let existingIndexCode,
-            indexCode,
-            indexFilePath,
-            siblings;
-
-        siblings = readDirectory(directoryPath);
-
-        indexCode = createIndexCode(siblings);
-
-        indexFilePath = path.resolve(directoryPath, 'index.js');
-
-        try {
-            existingIndexCode = fs.readFileSync(indexFilePath, 'utf8');
-        /* eslint-disable no-empty */
-        } catch (error) {
-
-        }
         /* eslint-enable no-empty */
 
-        fs.writeFileSync(indexFilePath, indexCode);
+    fs.writeFileSync(indexFilePath, indexCode);
 
-        if (existingIndexCode && existingIndexCode === indexCode) {
+    if (existingIndexCode && existingIndexCode === indexCode) {
-            log(indexFilePath, chalk.yellow('[index have not changed]'));
+      log(indexFilePath, chalk.yellow('[index has not changed]'));
-        } else if (existingIndexCode && existingIndexCode !== indexCode) {
+    } else if (existingIndexCode && existingIndexCode !== indexCode) {
-            log(indexFilePath, chalk.green('[updated index]'));
+      log(indexFilePath, chalk.green('[updated index]'));
-        } else {
+    } else {
-            log(indexFilePath, chalk.green('[created index]'));
+      log(indexFilePath, chalk.green('[created index]'));
-        }
+    }
-    });
+  });
 
-    log('Done');
+  log('Done');
 };

test/codeExample.js

@@ -1,5 +1,5 @@
 import _ from 'lodash';
 
 export default (code) => {
-    return _.trim(code) + '\n\n';
+  return _.trim(code) + '\n\n';
 };

test/createIndexCode.js

@@ -0,0 +1,75 @@
+/* eslint-disable no-restricted-syntax */
+
+import {
+    expect
+} from 'chai';
+import createIndexCode from '../src/utilities/createIndexCode';
+import codeExample from './codeExample';
+
+describe('createIndexCode()', () => {
+  it('describes no children', () => {
+    const indexCode = createIndexCode([]);
+
+    expect(indexCode).to.equal(codeExample(`
+// @create-index
+    `));
+  });
+  it('describes a single child', () => {
+    const indexCode = createIndexCode(['foo']);
+
+    expect(indexCode).to.equal(codeExample(`
+// @create-index
+
+export { default as foo } from './foo';
+    `));
+  });
+  it('describes multiple children', () => {
+    const indexCode = createIndexCode(['bar', 'foo']);
+
+    expect(indexCode).to.equal(codeExample(`
+// @create-index
+
+export { default as bar } from './bar';
+export { default as foo } from './foo';
+    `));
+  });
+  context('file with extension', () => {
+    it('removes the extension from the export statement', () => {
+      const indexCode = createIndexCode(['foo.js']);
+
+      expect(indexCode).to.equal(codeExample(`
+// @create-index
+
+export { default as foo } from './foo.js';
+      `));
+    });
+  });
+  context('multiple, unsorted', () => {
+    it('sorts the files', () => {
+      const indexCode = createIndexCode(['foo', 'bar']);
+
+      expect(indexCode).to.equal(codeExample(`
+// @create-index
+
+export { default as bar } from './bar';
+export { default as foo } from './foo';
+      `));
+    });
+  });
+
+  context('with config', () => {
+    it('should append config', () => {
+      const config = {
+        ignore: ['/^zoo/']
+      };
+      const indexCode = createIndexCode(['foo', 'bar'], {config});
+
+      expect(indexCode).to.equal(codeExample(`
+// @create-index {"ignore":["/^zoo/"]}
+
+export { default as bar } from './bar';
+export { default as foo } from './foo';
+      `));
+    });
+  });
+});

test/findIndexFiles.js

@@ -0,0 +1,19 @@
+import path from 'path';
+import {
+    expect
+} from 'chai';
+import glob from 'glob';
+import findIndexFiles from '../src/utilities/findIndexFiles';
+
+const fixturesPath = path.resolve(__dirname, '../../fixtures/find-index-files');
+
+describe('findIndexFiles()', () => {
+  it('finds only the directories that have an existing valid index file', () => {
+    let names;
+
+    names = findIndexFiles(path.resolve(fixturesPath));
+    names = names.sort();
+
+    expect(names).to.deep.equal(glob.sync(path.resolve(fixturesPath, '**/find-*')));
+  });
+});

test/fixtures/find-index-files/do-not-find-no-index/not-index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/find-index-files/do-not-find/index.js

@@ -0,0 +1 @@
+// create-index

test/fixtures/find-index-files/find-1/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/find-index-files/nested/do-not-find/index.js

@@ -0,0 +1 @@
+// create-index

test/fixtures/find-index-files/nested/find-2/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/find-index-files/nested/find-3/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-and-files/foo/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-unsafe-name/bar-bar/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-unsafe-name/foo-foo/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-unsafe-name/present/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-without-index/bar/bar.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-without-index/foo/foo.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories-without-index/present.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories/bar/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-directories/foo/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-index/bar/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-index/foo/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-directory/children-index/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/read-index-config/with-config/index.js

@@ -0,0 +1 @@
+// @create-index {"ignore": ["/foo.js$/"]}

test/fixtures/read-index-config/with-invalid-config/index.js

@@ -0,0 +1 @@
+// @create-index {ignore: 'foo'}

test/fixtures/read-index-config/without-config/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/validate-target-directory/safe-index-with-banner/index.js

@@ -0,0 +1,3 @@
+/* eslint-disable */
+
+// @create-index

test/fixtures/validate-target-directory/safe-index/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/write-index/mixed/bar/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/write-index/mixed/foo/index.js

@@ -0,0 +1 @@
+// @create-index

test/fixtures/write-index/mixed/index.js

@@ -0,0 +1,5 @@
+// @create-index
+
+export { default as bar } from './bar';
+export { default as foo } from './foo.js';
+

test/fixtures/write-index/with-config/index.js

@@ -0,0 +1,4 @@
+// @create-index {"ignore":["/bar.js$/"]}
+
+export { default as foo } from './foo.js';
+