Extends minimatch.match() with support for multiple patterns
JavaScript
Permalink
Failed to load latest commit information.
.editorconfig minor refactor for clearity Jun 21, 2014
.gitattributes init Jan 15, 2014
.gitignore init Jan 15, 2014
.jshintrc minor refactor for clearity Jun 21, 2014
.travis.yml Update .travis.yml Feb 8, 2015
index.js Tweaks Jul 14, 2015
license various tweaks Jun 21, 2014
package.json 2.1.0 Nov 14, 2015
readme.md add related project to readme Feb 5, 2016
test.js fixed misleading tests Sep 16, 2015

readme.md

multimatch Build Status

Extends minimatch.match() with support for multiple patterns

Install

$ npm install --save multimatch

Usage

var multimatch = require('multimatch');

multimatch(['unicorn', 'cake', 'rainbows'], ['*', '!cake']);
//=> ['unicorn', 'rainbows']

See the tests for more usage examples and expected matches.

API

Same as minimatch.match() except for pattern also accepting an array.

var results = multimatch(paths, patterns);

The return value is an array of matching paths.

How multiple patterns work

Positive patterns (e.g. foo or *) add to the results, while negative patterns (e.g. !foo) subtract from the results.

Therefore a lone negation (e.g. ['!foo']) will never match anything – use ['*', '!foo'] instead.

Globbing patterns

Just a quick overview.

  • * matches any number of characters, but not /
  • ? matches a single character, but not /
  • ** matches any number of characters, including /, as long as it's the only thing in a path part
  • {} allows for a comma-separated list of "or" expressions
  • ! at the beginning of a pattern will negate the match

Related

  • globby - Match against the filesystem instead of a list
  • matcher - Simple wildcard matching

License

MIT © Sindre Sorhus, Jon Schlinkert