diff options
author | Florian Dold <florian.dold@gmail.com> | 2017-05-28 00:38:50 +0200 |
---|---|---|
committer | Florian Dold <florian.dold@gmail.com> | 2017-05-28 00:40:43 +0200 |
commit | 7fff4499fd915bcea3fa93b1aa8b35f4fe7a6027 (patch) | |
tree | 6de9a1aebd150a23b7f8c273ec657a5d0a18fe3e /node_modules/matcher/readme.md | |
parent | 963b7a41feb29cc4be090a2446bdfe0c1f1bcd81 (diff) |
add linting (and some initial fixes)
Diffstat (limited to 'node_modules/matcher/readme.md')
-rw-r--r-- | node_modules/matcher/readme.md | 78 |
1 files changed, 78 insertions, 0 deletions
diff --git a/node_modules/matcher/readme.md b/node_modules/matcher/readme.md new file mode 100644 index 000000000..42488b5a7 --- /dev/null +++ b/node_modules/matcher/readme.md @@ -0,0 +1,78 @@ +# matcher [](https://travis-ci.org/sindresorhus/matcher) + +> Simple [wildcard](https://en.wikipedia.org/wiki/Wildcard_character) matching + +Useful when you want to accept loose string input and regexes/globs are too convoluted. + + +## Install + +``` +$ npm install --save matcher +``` + + +## Usage + +```js +const matcher = require('matcher'); + +matcher(['foo', 'bar', 'moo'], ['*oo', '!foo']); +//=> ['moo'] + +matcher(['foo', 'bar', 'moo'], ['!*oo']); +//=> ['bar'] + +matcher.isMatch('unicorn', 'uni*'); +//=> true + +matcher.isMatch('unicorn', '*corn'); +//=> true + +matcher.isMatch('unicorn', 'un*rn'); +//=> true + +matcher.isMatch('rainbow', '!unicorn'); +//=> true + +matcher.isMatch('foo bar baz', 'foo b* b*'); +//=> true + +matcher.isMatch('unicorn', 'uni\\*'); +//=> false +``` + + +## API + +### matcher(inputs, patterns) + +Accepts an array of `input`'s and `pattern`'s. + +Returns an array of of `inputs` filtered based on the `patterns`. + +### matcher.isMatch(input, pattern) + +Returns a boolean of whether the `input` matches the `pattern`. + +#### input + +Type: `string` + +String to match. + +#### pattern + +Type: `string` + +Case-insensitive. Use `*` to match zero or more characters. A pattern starting with `!` will be negated. + + +## Related + +- [multimatch](https://github.com/sindresorhus/multimatch) - Extends `minimatch.match()` with support for multiple patterns + + +## License + +MIT © [Sindre Sorhus](http://sindresorhus.com) |