Ignore is a manager and filter for .gitignore rules.
Pay attention that
minimatch does not work in the gitignore way. To filter filenames according to .gitignore file, I recommend this module.
npm install ignore --save
var ignore = require'ignore';var ig = ignoreoptionsaddPattern'.abc/*' '!.abc/d/';
var paths ='.abc/a.js' // filtered out'.abc/d/e.js' // included;igfilterpaths; // ['.abc/d/e.js']
pathsfilterigcreateFilter; // ['.abc/d/e.js']
For most cases, we'd better use only one ignore file. We could use
ignore.select to select the first existing file.
ignore only contains utility methods to filter paths according to the specified ignore rules, so
ignore never try to find out ignore rules by traversing directories or fetching from git configurations.
ignore don't cares about sub-modules of git projects.
/*.js' should only match '
a.js', but not '
**/foo' should match '
Adds a rule or several rules to the current manager.
The ignore rule or a array of rules.
Notice that a line starting with
'#'(hash) is treated as a comment. Put a backslash (
'\') in front of the first hash for patterns that begin with a hash, if you want to ignore a file with a hash at the beginning of the filename.
ignoreaddPattern'#abc'filter'#abc'; // ['abc']ignoreaddPattern'\#abc'filter'#abc'; // 
Adds rules from a ignore file or several files
Filters the given array of pathnames, and returns the filtered array.
The array of paths to be filtered.
NOTICE that each
path here should be a relative path to the root of your repository. Suppose the dir structure is:
/path/to/your/repo|-- a| |-- a.js||-- .b||-- .c|-- .DS_store
paths might be like this:
Usually, you could use
glob to fetch the structure of the current directory:
var glob = require'glob';glob'**'var filtered;if errconsole.logerr;elsefiltered = ignoreaddIgnoreFile'.gitignore'filterfiles;console.logfiltered;;
Creates a filter function which could filter an array of paths with
The filter function.
By default, all ignore rules will be treated as case-insensitive ones as well as the git does.
ignoreRules will omit every pattern that includes '
**' (two consecutive asterisks) which is not compatible cross operating systems, because the behavior of file .gitignore depends on the implementation of command
fnmatch in shell.
By the way, Mac OS doesn't support '
The ignore rules to be added. Default to
['.git', '.svn', '.DS_Store']
If you want those directories to be included, you could
You can also use
.addPattern() method to do this.