From 46e43f4bde4a35785b4997b81e86cd19f046b69b Mon Sep 17 00:00:00 2001 From: Minteck Date: Tue, 21 Dec 2021 16:52:28 +0100 Subject: Commit --- src/node_modules/multimatch/readme.md | 80 +++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 src/node_modules/multimatch/readme.md (limited to 'src/node_modules/multimatch/readme.md') diff --git a/src/node_modules/multimatch/readme.md b/src/node_modules/multimatch/readme.md new file mode 100644 index 0000000..6426d2e --- /dev/null +++ b/src/node_modules/multimatch/readme.md @@ -0,0 +1,80 @@ +# multimatch [![Build Status](https://travis-ci.com/sindresorhus/multimatch.svg?branch=master)](https://travis-ci.com/github/sindresorhus/multimatch) + +> Extends [`minimatch.match()`](https://github.com/isaacs/minimatch#minimatchmatchlist-pattern-options) with support for multiple patterns + +## Install + +``` +$ npm install multimatch +``` + +## Usage + +```js +const multimatch = require('multimatch'); + +multimatch(['unicorn', 'cake', 'rainbows'], ['*', '!cake']); +//=> ['unicorn', 'rainbows'] +``` + +See the [tests](https://github.com/sindresorhus/multimatch/tree/master/test) for more usage examples and expected matches. + +## API + +### multimatch(paths, patterns, options?) + +Returns an array of matching paths in the order of input paths. + +#### paths + +Type: `string | string[]` + +Paths to match against. + +#### patterns + +Type: `string | string[]` + +Globbing patterns to use. For example: `['*', '!cake']`. See supported [`minimatch` patterns](https://github.com/isaacs/minimatch#usage). + +- [Pattern examples with expected matches](https://github.com/sindresorhus/multimatch/blob/master/test/test.js) +- [Quick globbing pattern overview](https://github.com/sindresorhus/multimatch#globbing-patterns) + +#### options + +Type: `object` + +See the [`minimatch` options](https://github.com/isaacs/minimatch#options). + +## 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](https://github.com/sindresorhus/globby) - Match against the filesystem instead of a list +- [matcher](https://github.com/sindresorhus/matcher) - Simple wildcard matching + +--- + +
+ + Get professional support for this package with a Tidelift subscription + +
+ + Tidelift helps make open source sustainable for maintainers while giving companies
assurances about security, maintenance, and licensing for their dependencies. +
+
-- cgit