angular-slickgrid 4.2.1 → 4.2.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +20 -20
- package/app/modules/angular-slickgrid/components/angular-slickgrid.component.d.ts +2 -2
- package/app/modules/angular-slickgrid/extensions/slickRowDetailView.d.ts +0 -2
- package/docs/assets/lib/multiple-select/README.md +17 -17
- package/esm2020/app/modules/angular-slickgrid/components/angular-slickgrid.component.mjs +14 -14
- package/esm2020/app/modules/angular-slickgrid/constants.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/extensions/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/extensions/slickRowDetailView.mjs +2 -4
- package/esm2020/app/modules/angular-slickgrid/global-grid-options.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/angularComponentOutput.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/angularGridInstance.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/externalTestingDependencies.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/gridOption.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/rowDetailView.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/models/slickGrid.interface.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/modules/angular-slickgrid.module.mjs +7 -10
- package/esm2020/app/modules/angular-slickgrid/services/angularUtil.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/bsDropdown.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/container.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/index.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/services/translater.service.mjs +4 -4
- package/esm2020/app/modules/angular-slickgrid/services/utilities.mjs +1 -1
- package/esm2020/app/modules/angular-slickgrid/slickgrid-config.mjs +1 -1
- package/esm2020/public_api.mjs +1 -1
- package/fesm2015/angular-slickgrid.mjs +32 -37
- package/fesm2015/angular-slickgrid.mjs.map +1 -1
- package/fesm2020/angular-slickgrid.mjs +32 -37
- package/fesm2020/angular-slickgrid.mjs.map +1 -1
- package/i18n/en.json +89 -89
- package/i18n/fr.json +90 -90
- package/{angular-slickgrid.d.ts → index.d.ts} +0 -0
- package/package.json +11 -11
- package/test/cypress/node_modules/@cypress/request/README.md +1038 -0
- package/test/cypress/node_modules/@cypress/xvfb/README.md +48 -0
- package/test/cypress/node_modules/@cypress/xvfb/node_modules/debug/README.md +437 -0
- package/test/cypress/node_modules/@types/node/README.md +16 -0
- package/test/cypress/node_modules/@types/sinonjs__fake-timers/README.md +16 -0
- package/test/cypress/node_modules/@types/sizzle/README.md +16 -0
- package/test/cypress/node_modules/@types/yauzl/README.md +16 -0
- package/test/cypress/node_modules/@types/yauzl/node_modules/@types/node/README.md +16 -0
- package/test/cypress/node_modules/aggregate-error/README.md +61 -0
- package/test/cypress/node_modules/ansi-colors/README.md +315 -0
- package/test/cypress/node_modules/ansi-escapes/README.md +245 -0
- package/test/cypress/node_modules/ansi-regex/README.md +78 -0
- package/test/cypress/node_modules/ansi-styles/README.md +152 -0
- package/test/cypress/node_modules/arch/README.md +71 -0
- package/test/cypress/node_modules/asn1/README.md +50 -0
- package/test/cypress/node_modules/assert-plus/README.md +162 -0
- package/test/cypress/node_modules/astral-regex/README.md +46 -0
- package/test/cypress/node_modules/async/README.md +60 -0
- package/test/cypress/node_modules/asynckit/README.md +233 -0
- package/test/cypress/node_modules/at-least-node/README.md +25 -0
- package/test/cypress/node_modules/aws-sign2/README.md +4 -0
- package/test/cypress/node_modules/aws4/README.md +183 -0
- package/test/cypress/node_modules/balanced-match/README.md +91 -0
- package/test/cypress/node_modules/base64-js/README.md +34 -0
- package/test/cypress/node_modules/bcrypt-pbkdf/README.md +45 -0
- package/test/cypress/node_modules/blob-util/README.md +623 -0
- package/test/cypress/node_modules/bluebird/README.md +57 -0
- package/test/cypress/node_modules/brace-expansion/README.md +129 -0
- package/test/cypress/node_modules/buffer/README.md +410 -0
- package/test/cypress/node_modules/buffer-crc32/README.md +47 -0
- package/test/cypress/node_modules/cachedir/README.md +27 -0
- package/test/cypress/node_modules/caseless/README.md +45 -0
- package/test/cypress/node_modules/chalk/README.md +293 -0
- package/test/cypress/node_modules/chalk/node_modules/supports-color/README.md +76 -0
- package/test/cypress/node_modules/check-more-types/README.md +952 -0
- package/test/cypress/node_modules/ci-info/README.md +114 -0
- package/test/cypress/node_modules/clean-stack/README.md +76 -0
- package/test/cypress/node_modules/cli-cursor/README.md +55 -0
- package/test/cypress/node_modules/cli-table3/README.md +218 -0
- package/test/cypress/node_modules/cli-truncate/README.md +139 -0
- package/test/cypress/node_modules/color-convert/README.md +68 -0
- package/test/cypress/node_modules/color-name/README.md +11 -0
- package/test/cypress/node_modules/colorette/README.md +102 -0
- package/test/cypress/node_modules/colors/README.md +221 -0
- package/test/cypress/node_modules/combined-stream/README.md +138 -0
- package/test/cypress/node_modules/commander/README.md +737 -0
- package/test/cypress/node_modules/common-tags/README.md +687 -0
- package/test/cypress/node_modules/core-util-is/README.md +3 -0
- package/test/cypress/node_modules/cross-spawn/README.md +96 -0
- package/test/cypress/node_modules/cypress/README.md +25 -0
- package/test/cypress/node_modules/cypress/mount-utils/README.md +14 -0
- package/test/cypress/node_modules/cypress/react/README.md +414 -0
- package/test/cypress/node_modules/cypress/vue/README.md +678 -0
- package/test/cypress/node_modules/cypress/vue2/README.md +693 -0
- package/test/cypress/node_modules/dashdash/README.md +574 -0
- package/test/cypress/node_modules/dayjs/README.md +128 -0
- package/test/cypress/node_modules/debug/README.md +455 -0
- package/test/cypress/node_modules/delayed-stream/README.md +141 -0
- package/test/cypress/node_modules/ecc-jsbn/README.md +8 -0
- package/test/cypress/node_modules/emoji-regex/README.md +73 -0
- package/test/cypress/node_modules/end-of-stream/README.md +54 -0
- package/test/cypress/node_modules/enquirer/README.md +1752 -0
- package/test/cypress/node_modules/escape-string-regexp/README.md +27 -0
- package/test/cypress/node_modules/eventemitter2/README.md +809 -0
- package/test/cypress/node_modules/execa/README.md +656 -0
- package/test/cypress/node_modules/executable/README.md +64 -0
- package/test/cypress/node_modules/extend/README.md +81 -0
- package/test/cypress/node_modules/extract-zip/README.md +57 -0
- package/test/cypress/node_modules/extract-zip/node_modules/debug/README.md +455 -0
- package/test/cypress/node_modules/extsprintf/README.md +46 -0
- package/test/cypress/node_modules/fd-slicer/README.md +199 -0
- package/test/cypress/node_modules/figures/README.md +139 -0
- package/test/cypress/node_modules/forever-agent/README.md +4 -0
- package/test/cypress/node_modules/form-data/README.md +234 -0
- package/test/cypress/node_modules/fs-extra/README.md +264 -0
- package/test/cypress/node_modules/fs.realpath/README.md +33 -0
- package/test/cypress/node_modules/get-stream/README.md +124 -0
- package/test/cypress/node_modules/getos/README.md +79 -0
- package/test/cypress/node_modules/getpass/README.md +32 -0
- package/test/cypress/node_modules/glob/README.md +375 -0
- package/test/cypress/node_modules/global-dirs/README.md +72 -0
- package/test/cypress/node_modules/graceful-fs/README.md +133 -0
- package/test/cypress/node_modules/has-flag/README.md +89 -0
- package/test/cypress/node_modules/http-signature/README.md +80 -0
- package/test/cypress/node_modules/human-signals/README.md +155 -0
- package/test/cypress/node_modules/ieee754/README.md +51 -0
- package/test/cypress/node_modules/indent-string/README.md +70 -0
- package/test/cypress/node_modules/inflight/README.md +37 -0
- package/test/cypress/node_modules/inherits/README.md +42 -0
- package/test/cypress/node_modules/ini/README.md +102 -0
- package/test/cypress/node_modules/is-ci/README.md +50 -0
- package/test/cypress/node_modules/is-fullwidth-code-point/README.md +39 -0
- package/test/cypress/node_modules/is-installed-globally/README.md +31 -0
- package/test/cypress/node_modules/is-path-inside/README.md +63 -0
- package/test/cypress/node_modules/is-stream/README.md +57 -0
- package/test/cypress/node_modules/is-typedarray/README.md +16 -0
- package/test/cypress/node_modules/isexe/README.md +51 -0
- package/test/cypress/node_modules/isstream/README.md +66 -0
- package/test/cypress/node_modules/jsbn/README.md +175 -0
- package/test/cypress/node_modules/json-schema/README.md +3 -0
- package/test/cypress/node_modules/json-stringify-safe/README.md +52 -0
- package/test/cypress/node_modules/jsonfile/README.md +205 -0
- package/test/cypress/node_modules/jsonfile/node_modules/universalify/README.md +76 -0
- package/test/cypress/node_modules/jsprim/README.md +287 -0
- package/test/cypress/node_modules/lazy-ass/README.md +269 -0
- package/test/cypress/node_modules/listr2/README.md +17 -0
- package/test/cypress/node_modules/lodash/README.md +39 -0
- package/test/cypress/node_modules/lodash.once/README.md +18 -0
- package/test/cypress/node_modules/log-symbols/README.md +51 -0
- package/test/cypress/node_modules/log-update/README.md +97 -0
- package/test/cypress/node_modules/log-update/node_modules/slice-ansi/README.md +66 -0
- package/test/cypress/node_modules/log-update/node_modules/wrap-ansi/README.md +97 -0
- package/test/cypress/node_modules/lru-cache/README.md +166 -0
- package/test/cypress/node_modules/merge-stream/README.md +78 -0
- package/test/cypress/node_modules/mime-db/README.md +102 -0
- package/test/cypress/node_modules/mime-types/README.md +123 -0
- package/test/cypress/node_modules/mimic-fn/README.md +69 -0
- package/test/cypress/node_modules/minimatch/README.md +209 -0
- package/test/cypress/node_modules/ms/README.md +60 -0
- package/test/cypress/node_modules/npm-run-path/README.md +115 -0
- package/test/cypress/node_modules/once/README.md +79 -0
- package/test/cypress/node_modules/onetime/README.md +94 -0
- package/test/cypress/node_modules/ospath/README.md +53 -0
- package/test/cypress/node_modules/p-map/README.md +89 -0
- package/test/cypress/node_modules/path-is-absolute/README.md +59 -0
- package/test/cypress/node_modules/path-key/README.md +61 -0
- package/test/cypress/node_modules/pend/README.md +41 -0
- package/test/cypress/node_modules/performance-now/README.md +30 -0
- package/test/cypress/node_modules/pify/README.md +119 -0
- package/test/cypress/node_modules/pretty-bytes/README.md +131 -0
- package/test/cypress/node_modules/proxy-from-env/README.md +131 -0
- package/test/cypress/node_modules/psl/README.md +215 -0
- package/test/cypress/node_modules/pump/README.md +65 -0
- package/test/cypress/node_modules/punycode/README.md +122 -0
- package/test/cypress/node_modules/qs/README.md +475 -0
- package/test/cypress/node_modules/request-progress/README.md +78 -0
- package/test/cypress/node_modules/restore-cursor/README.md +26 -0
- package/test/cypress/node_modules/rimraf/README.md +101 -0
- package/test/cypress/node_modules/rxjs/README.md +147 -0
- package/test/cypress/node_modules/rxjs/_esm2015/README.md +147 -0
- package/test/cypress/node_modules/rxjs/_esm5/README.md +147 -0
- package/test/cypress/node_modules/rxjs/src/README.md +147 -0
- package/test/cypress/node_modules/safe-buffer/README.md +584 -0
- package/test/cypress/node_modules/safer-buffer/README.md +156 -0
- package/test/cypress/node_modules/semver/README.md +566 -0
- package/test/cypress/node_modules/shebang-command/README.md +34 -0
- package/test/cypress/node_modules/shebang-regex/README.md +33 -0
- package/test/cypress/node_modules/signal-exit/README.md +39 -0
- package/test/cypress/node_modules/slice-ansi/README.md +72 -0
- package/test/cypress/node_modules/sshpk/README.md +804 -0
- package/test/cypress/node_modules/string-width/README.md +50 -0
- package/test/cypress/node_modules/strip-ansi/README.md +46 -0
- package/test/cypress/node_modules/strip-final-newline/README.md +30 -0
- package/test/cypress/node_modules/supports-color/README.md +77 -0
- package/test/cypress/node_modules/throttleit/README.md +32 -0
- package/test/cypress/node_modules/tmp/README.md +365 -0
- package/test/cypress/node_modules/tough-cookie/README.md +527 -0
- package/test/cypress/node_modules/tslib/README.md +142 -0
- package/test/cypress/node_modules/tunnel-agent/README.md +4 -0
- package/test/cypress/node_modules/tweetnacl/README.md +459 -0
- package/test/cypress/node_modules/type-fest/README.md +760 -0
- package/test/cypress/node_modules/universalify/README.md +76 -0
- package/test/cypress/node_modules/untildify/README.md +30 -0
- package/test/cypress/node_modules/uuid/README.md +505 -0
- package/test/cypress/node_modules/verror/README.md +528 -0
- package/test/cypress/node_modules/verror/node_modules/extsprintf/README.md +46 -0
- package/test/cypress/node_modules/which/README.md +54 -0
- package/test/cypress/node_modules/wrap-ansi/README.md +91 -0
- package/test/cypress/node_modules/wrappy/README.md +36 -0
- package/test/cypress/node_modules/yallist/README.md +204 -0
- package/test/cypress/node_modules/yauzl/README.md +658 -0
|
@@ -0,0 +1,375 @@
|
|
|
1
|
+
# Glob
|
|
2
|
+
|
|
3
|
+
Match files using the patterns the shell uses, like stars and stuff.
|
|
4
|
+
|
|
5
|
+
[](https://travis-ci.org/isaacs/node-glob/) [](https://ci.appveyor.com/project/isaacs/node-glob) [](https://coveralls.io/github/isaacs/node-glob?branch=master)
|
|
6
|
+
|
|
7
|
+
This is a glob implementation in JavaScript. It uses the `minimatch`
|
|
8
|
+
library to do its matching.
|
|
9
|
+
|
|
10
|
+

|
|
11
|
+
|
|
12
|
+
## Usage
|
|
13
|
+
|
|
14
|
+
Install with npm
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
npm i glob
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
```javascript
|
|
21
|
+
var glob = require("glob")
|
|
22
|
+
|
|
23
|
+
// options is optional
|
|
24
|
+
glob("**/*.js", options, function (er, files) {
|
|
25
|
+
// files is an array of filenames.
|
|
26
|
+
// If the `nonull` option is set, and nothing
|
|
27
|
+
// was found, then files is ["**/*.js"]
|
|
28
|
+
// er is an error object or null.
|
|
29
|
+
})
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## Glob Primer
|
|
33
|
+
|
|
34
|
+
"Globs" are the patterns you type when you do stuff like `ls *.js` on
|
|
35
|
+
the command line, or put `build/*` in a `.gitignore` file.
|
|
36
|
+
|
|
37
|
+
Before parsing the path part patterns, braced sections are expanded
|
|
38
|
+
into a set. Braced sections start with `{` and end with `}`, with any
|
|
39
|
+
number of comma-delimited sections within. Braced sections may contain
|
|
40
|
+
slash characters, so `a{/b/c,bcd}` would expand into `a/b/c` and `abcd`.
|
|
41
|
+
|
|
42
|
+
The following characters have special magic meaning when used in a
|
|
43
|
+
path portion:
|
|
44
|
+
|
|
45
|
+
* `*` Matches 0 or more characters in a single path portion
|
|
46
|
+
* `?` Matches 1 character
|
|
47
|
+
* `[...]` Matches a range of characters, similar to a RegExp range.
|
|
48
|
+
If the first character of the range is `!` or `^` then it matches
|
|
49
|
+
any character not in the range.
|
|
50
|
+
* `!(pattern|pattern|pattern)` Matches anything that does not match
|
|
51
|
+
any of the patterns provided.
|
|
52
|
+
* `?(pattern|pattern|pattern)` Matches zero or one occurrence of the
|
|
53
|
+
patterns provided.
|
|
54
|
+
* `+(pattern|pattern|pattern)` Matches one or more occurrences of the
|
|
55
|
+
patterns provided.
|
|
56
|
+
* `*(a|b|c)` Matches zero or more occurrences of the patterns provided
|
|
57
|
+
* `@(pattern|pat*|pat?erN)` Matches exactly one of the patterns
|
|
58
|
+
provided
|
|
59
|
+
* `**` If a "globstar" is alone in a path portion, then it matches
|
|
60
|
+
zero or more directories and subdirectories searching for matches.
|
|
61
|
+
It does not crawl symlinked directories.
|
|
62
|
+
|
|
63
|
+
### Dots
|
|
64
|
+
|
|
65
|
+
If a file or directory path portion has a `.` as the first character,
|
|
66
|
+
then it will not match any glob pattern unless that pattern's
|
|
67
|
+
corresponding path part also has a `.` as its first character.
|
|
68
|
+
|
|
69
|
+
For example, the pattern `a/.*/c` would match the file at `a/.b/c`.
|
|
70
|
+
However the pattern `a/*/c` would not, because `*` does not start with
|
|
71
|
+
a dot character.
|
|
72
|
+
|
|
73
|
+
You can make glob treat dots as normal characters by setting
|
|
74
|
+
`dot:true` in the options.
|
|
75
|
+
|
|
76
|
+
### Basename Matching
|
|
77
|
+
|
|
78
|
+
If you set `matchBase:true` in the options, and the pattern has no
|
|
79
|
+
slashes in it, then it will seek for any file anywhere in the tree
|
|
80
|
+
with a matching basename. For example, `*.js` would match
|
|
81
|
+
`test/simple/basic.js`.
|
|
82
|
+
|
|
83
|
+
### Empty Sets
|
|
84
|
+
|
|
85
|
+
If no matching files are found, then an empty array is returned. This
|
|
86
|
+
differs from the shell, where the pattern itself is returned. For
|
|
87
|
+
example:
|
|
88
|
+
|
|
89
|
+
$ echo a*s*d*f
|
|
90
|
+
a*s*d*f
|
|
91
|
+
|
|
92
|
+
To get the bash-style behavior, set the `nonull:true` in the options.
|
|
93
|
+
|
|
94
|
+
### See Also:
|
|
95
|
+
|
|
96
|
+
* `man sh`
|
|
97
|
+
* `man bash` (Search for "Pattern Matching")
|
|
98
|
+
* `man 3 fnmatch`
|
|
99
|
+
* `man 5 gitignore`
|
|
100
|
+
* [minimatch documentation](https://github.com/isaacs/minimatch)
|
|
101
|
+
|
|
102
|
+
## glob.hasMagic(pattern, [options])
|
|
103
|
+
|
|
104
|
+
Returns `true` if there are any special characters in the pattern, and
|
|
105
|
+
`false` otherwise.
|
|
106
|
+
|
|
107
|
+
Note that the options affect the results. If `noext:true` is set in
|
|
108
|
+
the options object, then `+(a|b)` will not be considered a magic
|
|
109
|
+
pattern. If the pattern has a brace expansion, like `a/{b/c,x/y}`
|
|
110
|
+
then that is considered magical, unless `nobrace:true` is set in the
|
|
111
|
+
options.
|
|
112
|
+
|
|
113
|
+
## glob(pattern, [options], cb)
|
|
114
|
+
|
|
115
|
+
* `pattern` `{String}` Pattern to be matched
|
|
116
|
+
* `options` `{Object}`
|
|
117
|
+
* `cb` `{Function}`
|
|
118
|
+
* `err` `{Error | null}`
|
|
119
|
+
* `matches` `{Array<String>}` filenames found matching the pattern
|
|
120
|
+
|
|
121
|
+
Perform an asynchronous glob search.
|
|
122
|
+
|
|
123
|
+
## glob.sync(pattern, [options])
|
|
124
|
+
|
|
125
|
+
* `pattern` `{String}` Pattern to be matched
|
|
126
|
+
* `options` `{Object}`
|
|
127
|
+
* return: `{Array<String>}` filenames found matching the pattern
|
|
128
|
+
|
|
129
|
+
Perform a synchronous glob search.
|
|
130
|
+
|
|
131
|
+
## Class: glob.Glob
|
|
132
|
+
|
|
133
|
+
Create a Glob object by instantiating the `glob.Glob` class.
|
|
134
|
+
|
|
135
|
+
```javascript
|
|
136
|
+
var Glob = require("glob").Glob
|
|
137
|
+
var mg = new Glob(pattern, options, cb)
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
It's an EventEmitter, and starts walking the filesystem to find matches
|
|
141
|
+
immediately.
|
|
142
|
+
|
|
143
|
+
### new glob.Glob(pattern, [options], [cb])
|
|
144
|
+
|
|
145
|
+
* `pattern` `{String}` pattern to search for
|
|
146
|
+
* `options` `{Object}`
|
|
147
|
+
* `cb` `{Function}` Called when an error occurs, or matches are found
|
|
148
|
+
* `err` `{Error | null}`
|
|
149
|
+
* `matches` `{Array<String>}` filenames found matching the pattern
|
|
150
|
+
|
|
151
|
+
Note that if the `sync` flag is set in the options, then matches will
|
|
152
|
+
be immediately available on the `g.found` member.
|
|
153
|
+
|
|
154
|
+
### Properties
|
|
155
|
+
|
|
156
|
+
* `minimatch` The minimatch object that the glob uses.
|
|
157
|
+
* `options` The options object passed in.
|
|
158
|
+
* `aborted` Boolean which is set to true when calling `abort()`. There
|
|
159
|
+
is no way at this time to continue a glob search after aborting, but
|
|
160
|
+
you can re-use the statCache to avoid having to duplicate syscalls.
|
|
161
|
+
* `cache` Convenience object. Each field has the following possible
|
|
162
|
+
values:
|
|
163
|
+
* `false` - Path does not exist
|
|
164
|
+
* `true` - Path exists
|
|
165
|
+
* `'FILE'` - Path exists, and is not a directory
|
|
166
|
+
* `'DIR'` - Path exists, and is a directory
|
|
167
|
+
* `[file, entries, ...]` - Path exists, is a directory, and the
|
|
168
|
+
array value is the results of `fs.readdir`
|
|
169
|
+
* `statCache` Cache of `fs.stat` results, to prevent statting the same
|
|
170
|
+
path multiple times.
|
|
171
|
+
* `symlinks` A record of which paths are symbolic links, which is
|
|
172
|
+
relevant in resolving `**` patterns.
|
|
173
|
+
* `realpathCache` An optional object which is passed to `fs.realpath`
|
|
174
|
+
to minimize unnecessary syscalls. It is stored on the instantiated
|
|
175
|
+
Glob object, and may be re-used.
|
|
176
|
+
|
|
177
|
+
### Events
|
|
178
|
+
|
|
179
|
+
* `end` When the matching is finished, this is emitted with all the
|
|
180
|
+
matches found. If the `nonull` option is set, and no match was found,
|
|
181
|
+
then the `matches` list contains the original pattern. The matches
|
|
182
|
+
are sorted, unless the `nosort` flag is set.
|
|
183
|
+
* `match` Every time a match is found, this is emitted with the specific
|
|
184
|
+
thing that matched. It is not deduplicated or resolved to a realpath.
|
|
185
|
+
* `error` Emitted when an unexpected error is encountered, or whenever
|
|
186
|
+
any fs error occurs if `options.strict` is set.
|
|
187
|
+
* `abort` When `abort()` is called, this event is raised.
|
|
188
|
+
|
|
189
|
+
### Methods
|
|
190
|
+
|
|
191
|
+
* `pause` Temporarily stop the search
|
|
192
|
+
* `resume` Resume the search
|
|
193
|
+
* `abort` Stop the search forever
|
|
194
|
+
|
|
195
|
+
### Options
|
|
196
|
+
|
|
197
|
+
All the options that can be passed to Minimatch can also be passed to
|
|
198
|
+
Glob to change pattern matching behavior. Also, some have been added,
|
|
199
|
+
or have glob-specific ramifications.
|
|
200
|
+
|
|
201
|
+
All options are false by default, unless otherwise noted.
|
|
202
|
+
|
|
203
|
+
All options are added to the Glob object, as well.
|
|
204
|
+
|
|
205
|
+
If you are running many `glob` operations, you can pass a Glob object
|
|
206
|
+
as the `options` argument to a subsequent operation to shortcut some
|
|
207
|
+
`stat` and `readdir` calls. At the very least, you may pass in shared
|
|
208
|
+
`symlinks`, `statCache`, `realpathCache`, and `cache` options, so that
|
|
209
|
+
parallel glob operations will be sped up by sharing information about
|
|
210
|
+
the filesystem.
|
|
211
|
+
|
|
212
|
+
* `cwd` The current working directory in which to search. Defaults
|
|
213
|
+
to `process.cwd()`.
|
|
214
|
+
* `root` The place where patterns starting with `/` will be mounted
|
|
215
|
+
onto. Defaults to `path.resolve(options.cwd, "/")` (`/` on Unix
|
|
216
|
+
systems, and `C:\` or some such on Windows.)
|
|
217
|
+
* `dot` Include `.dot` files in normal matches and `globstar` matches.
|
|
218
|
+
Note that an explicit dot in a portion of the pattern will always
|
|
219
|
+
match dot files.
|
|
220
|
+
* `nomount` By default, a pattern starting with a forward-slash will be
|
|
221
|
+
"mounted" onto the root setting, so that a valid filesystem path is
|
|
222
|
+
returned. Set this flag to disable that behavior.
|
|
223
|
+
* `mark` Add a `/` character to directory matches. Note that this
|
|
224
|
+
requires additional stat calls.
|
|
225
|
+
* `nosort` Don't sort the results.
|
|
226
|
+
* `stat` Set to true to stat *all* results. This reduces performance
|
|
227
|
+
somewhat, and is completely unnecessary, unless `readdir` is presumed
|
|
228
|
+
to be an untrustworthy indicator of file existence.
|
|
229
|
+
* `silent` When an unusual error is encountered when attempting to
|
|
230
|
+
read a directory, a warning will be printed to stderr. Set the
|
|
231
|
+
`silent` option to true to suppress these warnings.
|
|
232
|
+
* `strict` When an unusual error is encountered when attempting to
|
|
233
|
+
read a directory, the process will just continue on in search of
|
|
234
|
+
other matches. Set the `strict` option to raise an error in these
|
|
235
|
+
cases.
|
|
236
|
+
* `cache` See `cache` property above. Pass in a previously generated
|
|
237
|
+
cache object to save some fs calls.
|
|
238
|
+
* `statCache` A cache of results of filesystem information, to prevent
|
|
239
|
+
unnecessary stat calls. While it should not normally be necessary
|
|
240
|
+
to set this, you may pass the statCache from one glob() call to the
|
|
241
|
+
options object of another, if you know that the filesystem will not
|
|
242
|
+
change between calls. (See "Race Conditions" below.)
|
|
243
|
+
* `symlinks` A cache of known symbolic links. You may pass in a
|
|
244
|
+
previously generated `symlinks` object to save `lstat` calls when
|
|
245
|
+
resolving `**` matches.
|
|
246
|
+
* `sync` DEPRECATED: use `glob.sync(pattern, opts)` instead.
|
|
247
|
+
* `nounique` In some cases, brace-expanded patterns can result in the
|
|
248
|
+
same file showing up multiple times in the result set. By default,
|
|
249
|
+
this implementation prevents duplicates in the result set. Set this
|
|
250
|
+
flag to disable that behavior.
|
|
251
|
+
* `nonull` Set to never return an empty set, instead returning a set
|
|
252
|
+
containing the pattern itself. This is the default in glob(3).
|
|
253
|
+
* `debug` Set to enable debug logging in minimatch and glob.
|
|
254
|
+
* `nobrace` Do not expand `{a,b}` and `{1..3}` brace sets.
|
|
255
|
+
* `noglobstar` Do not match `**` against multiple filenames. (Ie,
|
|
256
|
+
treat it as a normal `*` instead.)
|
|
257
|
+
* `noext` Do not match `+(a|b)` "extglob" patterns.
|
|
258
|
+
* `nocase` Perform a case-insensitive match. Note: on
|
|
259
|
+
case-insensitive filesystems, non-magic patterns will match by
|
|
260
|
+
default, since `stat` and `readdir` will not raise errors.
|
|
261
|
+
* `matchBase` Perform a basename-only match if the pattern does not
|
|
262
|
+
contain any slash characters. That is, `*.js` would be treated as
|
|
263
|
+
equivalent to `**/*.js`, matching all js files in all directories.
|
|
264
|
+
* `nodir` Do not match directories, only files. (Note: to match
|
|
265
|
+
*only* directories, simply put a `/` at the end of the pattern.)
|
|
266
|
+
* `ignore` Add a pattern or an array of glob patterns to exclude matches.
|
|
267
|
+
Note: `ignore` patterns are *always* in `dot:true` mode, regardless
|
|
268
|
+
of any other settings.
|
|
269
|
+
* `follow` Follow symlinked directories when expanding `**` patterns.
|
|
270
|
+
Note that this can result in a lot of duplicate references in the
|
|
271
|
+
presence of cyclic links.
|
|
272
|
+
* `realpath` Set to true to call `fs.realpath` on all of the results.
|
|
273
|
+
In the case of a symlink that cannot be resolved, the full absolute
|
|
274
|
+
path to the matched entry is returned (though it will usually be a
|
|
275
|
+
broken symlink)
|
|
276
|
+
* `absolute` Set to true to always receive absolute paths for matched
|
|
277
|
+
files. Unlike `realpath`, this also affects the values returned in
|
|
278
|
+
the `match` event.
|
|
279
|
+
|
|
280
|
+
## Comparisons to other fnmatch/glob implementations
|
|
281
|
+
|
|
282
|
+
While strict compliance with the existing standards is a worthwhile
|
|
283
|
+
goal, some discrepancies exist between node-glob and other
|
|
284
|
+
implementations, and are intentional.
|
|
285
|
+
|
|
286
|
+
The double-star character `**` is supported by default, unless the
|
|
287
|
+
`noglobstar` flag is set. This is supported in the manner of bsdglob
|
|
288
|
+
and bash 4.3, where `**` only has special significance if it is the only
|
|
289
|
+
thing in a path part. That is, `a/**/b` will match `a/x/y/b`, but
|
|
290
|
+
`a/**b` will not.
|
|
291
|
+
|
|
292
|
+
Note that symlinked directories are not crawled as part of a `**`,
|
|
293
|
+
though their contents may match against subsequent portions of the
|
|
294
|
+
pattern. This prevents infinite loops and duplicates and the like.
|
|
295
|
+
|
|
296
|
+
If an escaped pattern has no matches, and the `nonull` flag is set,
|
|
297
|
+
then glob returns the pattern as-provided, rather than
|
|
298
|
+
interpreting the character escapes. For example,
|
|
299
|
+
`glob.match([], "\\*a\\?")` will return `"\\*a\\?"` rather than
|
|
300
|
+
`"*a?"`. This is akin to setting the `nullglob` option in bash, except
|
|
301
|
+
that it does not resolve escaped pattern characters.
|
|
302
|
+
|
|
303
|
+
If brace expansion is not disabled, then it is performed before any
|
|
304
|
+
other interpretation of the glob pattern. Thus, a pattern like
|
|
305
|
+
`+(a|{b),c)}`, which would not be valid in bash or zsh, is expanded
|
|
306
|
+
**first** into the set of `+(a|b)` and `+(a|c)`, and those patterns are
|
|
307
|
+
checked for validity. Since those two are valid, matching proceeds.
|
|
308
|
+
|
|
309
|
+
### Comments and Negation
|
|
310
|
+
|
|
311
|
+
Previously, this module let you mark a pattern as a "comment" if it
|
|
312
|
+
started with a `#` character, or a "negated" pattern if it started
|
|
313
|
+
with a `!` character.
|
|
314
|
+
|
|
315
|
+
These options were deprecated in version 5, and removed in version 6.
|
|
316
|
+
|
|
317
|
+
To specify things that should not match, use the `ignore` option.
|
|
318
|
+
|
|
319
|
+
## Windows
|
|
320
|
+
|
|
321
|
+
**Please only use forward-slashes in glob expressions.**
|
|
322
|
+
|
|
323
|
+
Though windows uses either `/` or `\` as its path separator, only `/`
|
|
324
|
+
characters are used by this glob implementation. You must use
|
|
325
|
+
forward-slashes **only** in glob expressions. Back-slashes will always
|
|
326
|
+
be interpreted as escape characters, not path separators.
|
|
327
|
+
|
|
328
|
+
Results from absolute patterns such as `/foo/*` are mounted onto the
|
|
329
|
+
root setting using `path.join`. On windows, this will by default result
|
|
330
|
+
in `/foo/*` matching `C:\foo\bar.txt`.
|
|
331
|
+
|
|
332
|
+
## Race Conditions
|
|
333
|
+
|
|
334
|
+
Glob searching, by its very nature, is susceptible to race conditions,
|
|
335
|
+
since it relies on directory walking and such.
|
|
336
|
+
|
|
337
|
+
As a result, it is possible that a file that exists when glob looks for
|
|
338
|
+
it may have been deleted or modified by the time it returns the result.
|
|
339
|
+
|
|
340
|
+
As part of its internal implementation, this program caches all stat
|
|
341
|
+
and readdir calls that it makes, in order to cut down on system
|
|
342
|
+
overhead. However, this also makes it even more susceptible to races,
|
|
343
|
+
especially if the cache or statCache objects are reused between glob
|
|
344
|
+
calls.
|
|
345
|
+
|
|
346
|
+
Users are thus advised not to use a glob result as a guarantee of
|
|
347
|
+
filesystem state in the face of rapid changes. For the vast majority
|
|
348
|
+
of operations, this is never a problem.
|
|
349
|
+
|
|
350
|
+
## Glob Logo
|
|
351
|
+
Glob's logo was created by [Tanya Brassie](http://tanyabrassie.com/). Logo files can be found [here](https://github.com/isaacs/node-glob/tree/master/logo).
|
|
352
|
+
|
|
353
|
+
The logo is licensed under a [Creative Commons Attribution-ShareAlike 4.0 International License](https://creativecommons.org/licenses/by-sa/4.0/).
|
|
354
|
+
|
|
355
|
+
## Contributing
|
|
356
|
+
|
|
357
|
+
Any change to behavior (including bugfixes) must come with a test.
|
|
358
|
+
|
|
359
|
+
Patches that fail tests or reduce performance will be rejected.
|
|
360
|
+
|
|
361
|
+
```
|
|
362
|
+
# to run tests
|
|
363
|
+
npm test
|
|
364
|
+
|
|
365
|
+
# to re-generate test fixtures
|
|
366
|
+
npm run test-regen
|
|
367
|
+
|
|
368
|
+
# to benchmark against bash/zsh
|
|
369
|
+
npm run bench
|
|
370
|
+
|
|
371
|
+
# to profile javascript
|
|
372
|
+
npm run prof
|
|
373
|
+
```
|
|
374
|
+
|
|
375
|
+

|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
# global-dirs
|
|
2
|
+
|
|
3
|
+
> Get the directory of globally installed packages and binaries
|
|
4
|
+
|
|
5
|
+
Uses the same resolution logic as `npm` and `yarn`.
|
|
6
|
+
|
|
7
|
+
## Install
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
$ npm install global-dirs
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Usage
|
|
14
|
+
|
|
15
|
+
```js
|
|
16
|
+
const globalDirectories = require('global-dirs');
|
|
17
|
+
|
|
18
|
+
console.log(globalDirectories.npm.prefix);
|
|
19
|
+
//=> '/usr/local'
|
|
20
|
+
|
|
21
|
+
console.log(globalDirectories.npm.packages);
|
|
22
|
+
//=> '/usr/local/lib/node_modules'
|
|
23
|
+
|
|
24
|
+
console.log(globalDirectories.npm.binaries);
|
|
25
|
+
//=> '/usr/local/bin'
|
|
26
|
+
|
|
27
|
+
console.log(globalDirectories.yarn.packages);
|
|
28
|
+
//=> '/Users/sindresorhus/.config/yarn/global/node_modules'
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## API
|
|
32
|
+
|
|
33
|
+
### globalDirectories
|
|
34
|
+
|
|
35
|
+
#### npm
|
|
36
|
+
#### yarn
|
|
37
|
+
|
|
38
|
+
##### packages
|
|
39
|
+
|
|
40
|
+
Directory with globally installed packages.
|
|
41
|
+
|
|
42
|
+
Equivalent to `npm root --global`.
|
|
43
|
+
|
|
44
|
+
##### binaries
|
|
45
|
+
|
|
46
|
+
Directory with globally installed binaries.
|
|
47
|
+
|
|
48
|
+
Equivalent to `npm bin --global`.
|
|
49
|
+
|
|
50
|
+
##### prefix
|
|
51
|
+
|
|
52
|
+
Directory with directories for packages and binaries. You probably want either of the above.
|
|
53
|
+
|
|
54
|
+
Equivalent to `npm prefix --global`.
|
|
55
|
+
|
|
56
|
+
## Related
|
|
57
|
+
|
|
58
|
+
- [import-global](https://github.com/sindresorhus/import-global) - Import a globally installed module
|
|
59
|
+
- [resolve-global](https://github.com/sindresorhus/resolve-global) - Resolve the path of a globally installed module
|
|
60
|
+
- [is-installed-globally](https://github.com/sindresorhus/is-installed-globally) - Check if your package was installed globally
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
<div align="center">
|
|
65
|
+
<b>
|
|
66
|
+
<a href="https://tidelift.com/subscription/pkg/npm-global-dirs?utm_source=npm-global-dirs&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
|
|
67
|
+
</b>
|
|
68
|
+
<br>
|
|
69
|
+
<sub>
|
|
70
|
+
Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
|
|
71
|
+
</sub>
|
|
72
|
+
</div>
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# graceful-fs
|
|
2
|
+
|
|
3
|
+
graceful-fs functions as a drop-in replacement for the fs module,
|
|
4
|
+
making various improvements.
|
|
5
|
+
|
|
6
|
+
The improvements are meant to normalize behavior across different
|
|
7
|
+
platforms and environments, and to make filesystem access more
|
|
8
|
+
resilient to errors.
|
|
9
|
+
|
|
10
|
+
## Improvements over [fs module](https://nodejs.org/api/fs.html)
|
|
11
|
+
|
|
12
|
+
* Queues up `open` and `readdir` calls, and retries them once
|
|
13
|
+
something closes if there is an EMFILE error from too many file
|
|
14
|
+
descriptors.
|
|
15
|
+
* fixes `lchmod` for Node versions prior to 0.6.2.
|
|
16
|
+
* implements `fs.lutimes` if possible. Otherwise it becomes a noop.
|
|
17
|
+
* ignores `EINVAL` and `EPERM` errors in `chown`, `fchown` or
|
|
18
|
+
`lchown` if the user isn't root.
|
|
19
|
+
* makes `lchmod` and `lchown` become noops, if not available.
|
|
20
|
+
* retries reading a file if `read` results in EAGAIN error.
|
|
21
|
+
|
|
22
|
+
On Windows, it retries renaming a file for up to one second if `EACCESS`
|
|
23
|
+
or `EPERM` error occurs, likely because antivirus software has locked
|
|
24
|
+
the directory.
|
|
25
|
+
|
|
26
|
+
## USAGE
|
|
27
|
+
|
|
28
|
+
```javascript
|
|
29
|
+
// use just like fs
|
|
30
|
+
var fs = require('graceful-fs')
|
|
31
|
+
|
|
32
|
+
// now go and do stuff with it...
|
|
33
|
+
fs.readFileSync('some-file-or-whatever')
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Global Patching
|
|
37
|
+
|
|
38
|
+
If you want to patch the global fs module (or any other fs-like
|
|
39
|
+
module) you can do this:
|
|
40
|
+
|
|
41
|
+
```javascript
|
|
42
|
+
// Make sure to read the caveat below.
|
|
43
|
+
var realFs = require('fs')
|
|
44
|
+
var gracefulFs = require('graceful-fs')
|
|
45
|
+
gracefulFs.gracefulify(realFs)
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
This should only ever be done at the top-level application layer, in
|
|
49
|
+
order to delay on EMFILE errors from any fs-using dependencies. You
|
|
50
|
+
should **not** do this in a library, because it can cause unexpected
|
|
51
|
+
delays in other parts of the program.
|
|
52
|
+
|
|
53
|
+
## Changes
|
|
54
|
+
|
|
55
|
+
This module is fairly stable at this point, and used by a lot of
|
|
56
|
+
things. That being said, because it implements a subtle behavior
|
|
57
|
+
change in a core part of the node API, even modest changes can be
|
|
58
|
+
extremely breaking, and the versioning is thus biased towards
|
|
59
|
+
bumping the major when in doubt.
|
|
60
|
+
|
|
61
|
+
The main change between major versions has been switching between
|
|
62
|
+
providing a fully-patched `fs` module vs monkey-patching the node core
|
|
63
|
+
builtin, and the approach by which a non-monkey-patched `fs` was
|
|
64
|
+
created.
|
|
65
|
+
|
|
66
|
+
The goal is to trade `EMFILE` errors for slower fs operations. So, if
|
|
67
|
+
you try to open a zillion files, rather than crashing, `open`
|
|
68
|
+
operations will be queued up and wait for something else to `close`.
|
|
69
|
+
|
|
70
|
+
There are advantages to each approach. Monkey-patching the fs means
|
|
71
|
+
that no `EMFILE` errors can possibly occur anywhere in your
|
|
72
|
+
application, because everything is using the same core `fs` module,
|
|
73
|
+
which is patched. However, it can also obviously cause undesirable
|
|
74
|
+
side-effects, especially if the module is loaded multiple times.
|
|
75
|
+
|
|
76
|
+
Implementing a separate-but-identical patched `fs` module is more
|
|
77
|
+
surgical (and doesn't run the risk of patching multiple times), but
|
|
78
|
+
also imposes the challenge of keeping in sync with the core module.
|
|
79
|
+
|
|
80
|
+
The current approach loads the `fs` module, and then creates a
|
|
81
|
+
lookalike object that has all the same methods, except a few that are
|
|
82
|
+
patched. It is safe to use in all versions of Node from 0.8 through
|
|
83
|
+
7.0.
|
|
84
|
+
|
|
85
|
+
### v4
|
|
86
|
+
|
|
87
|
+
* Do not monkey-patch the fs module. This module may now be used as a
|
|
88
|
+
drop-in dep, and users can opt into monkey-patching the fs builtin
|
|
89
|
+
if their app requires it.
|
|
90
|
+
|
|
91
|
+
### v3
|
|
92
|
+
|
|
93
|
+
* Monkey-patch fs, because the eval approach no longer works on recent
|
|
94
|
+
node.
|
|
95
|
+
* fixed possible type-error throw if rename fails on windows
|
|
96
|
+
* verify that we *never* get EMFILE errors
|
|
97
|
+
* Ignore ENOSYS from chmod/chown
|
|
98
|
+
* clarify that graceful-fs must be used as a drop-in
|
|
99
|
+
|
|
100
|
+
### v2.1.0
|
|
101
|
+
|
|
102
|
+
* Use eval rather than monkey-patching fs.
|
|
103
|
+
* readdir: Always sort the results
|
|
104
|
+
* win32: requeue a file if error has an OK status
|
|
105
|
+
|
|
106
|
+
### v2.0
|
|
107
|
+
|
|
108
|
+
* A return to monkey patching
|
|
109
|
+
* wrap process.cwd
|
|
110
|
+
|
|
111
|
+
### v1.1
|
|
112
|
+
|
|
113
|
+
* wrap readFile
|
|
114
|
+
* Wrap fs.writeFile.
|
|
115
|
+
* readdir protection
|
|
116
|
+
* Don't clobber the fs builtin
|
|
117
|
+
* Handle fs.read EAGAIN errors by trying again
|
|
118
|
+
* Expose the curOpen counter
|
|
119
|
+
* No-op lchown/lchmod if not implemented
|
|
120
|
+
* fs.rename patch only for win32
|
|
121
|
+
* Patch fs.rename to handle AV software on Windows
|
|
122
|
+
* Close #4 Chown should not fail on einval or eperm if non-root
|
|
123
|
+
* Fix isaacs/fstream#1 Only wrap fs one time
|
|
124
|
+
* Fix #3 Start at 1024 max files, then back off on EMFILE
|
|
125
|
+
* lutimes that doens't blow up on Linux
|
|
126
|
+
* A full on-rewrite using a queue instead of just swallowing the EMFILE error
|
|
127
|
+
* Wrap Read/Write streams as well
|
|
128
|
+
|
|
129
|
+
### 1.0
|
|
130
|
+
|
|
131
|
+
* Update engines for node 0.6
|
|
132
|
+
* Be lstat-graceful on Windows
|
|
133
|
+
* first
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
# has-flag [](https://travis-ci.org/sindresorhus/has-flag)
|
|
2
|
+
|
|
3
|
+
> Check if [`argv`](https://nodejs.org/docs/latest/api/process.html#process_process_argv) has a specific flag
|
|
4
|
+
|
|
5
|
+
Correctly stops looking after an `--` argument terminator.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
<div align="center">
|
|
10
|
+
<b>
|
|
11
|
+
<a href="https://tidelift.com/subscription/pkg/npm-has-flag?utm_source=npm-has-flag&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
|
|
12
|
+
</b>
|
|
13
|
+
<br>
|
|
14
|
+
<sub>
|
|
15
|
+
Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
|
|
16
|
+
</sub>
|
|
17
|
+
</div>
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
## Install
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
$ npm install has-flag
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
## Usage
|
|
30
|
+
|
|
31
|
+
```js
|
|
32
|
+
// foo.js
|
|
33
|
+
const hasFlag = require('has-flag');
|
|
34
|
+
|
|
35
|
+
hasFlag('unicorn');
|
|
36
|
+
//=> true
|
|
37
|
+
|
|
38
|
+
hasFlag('--unicorn');
|
|
39
|
+
//=> true
|
|
40
|
+
|
|
41
|
+
hasFlag('f');
|
|
42
|
+
//=> true
|
|
43
|
+
|
|
44
|
+
hasFlag('-f');
|
|
45
|
+
//=> true
|
|
46
|
+
|
|
47
|
+
hasFlag('foo=bar');
|
|
48
|
+
//=> true
|
|
49
|
+
|
|
50
|
+
hasFlag('foo');
|
|
51
|
+
//=> false
|
|
52
|
+
|
|
53
|
+
hasFlag('rainbow');
|
|
54
|
+
//=> false
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
$ node foo.js -f --unicorn --foo=bar -- --rainbow
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
## API
|
|
63
|
+
|
|
64
|
+
### hasFlag(flag, [argv])
|
|
65
|
+
|
|
66
|
+
Returns a boolean for whether the flag exists.
|
|
67
|
+
|
|
68
|
+
#### flag
|
|
69
|
+
|
|
70
|
+
Type: `string`
|
|
71
|
+
|
|
72
|
+
CLI flag to look for. The `--` prefix is optional.
|
|
73
|
+
|
|
74
|
+
#### argv
|
|
75
|
+
|
|
76
|
+
Type: `string[]`<br>
|
|
77
|
+
Default: `process.argv`
|
|
78
|
+
|
|
79
|
+
CLI arguments.
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
## Security
|
|
83
|
+
|
|
84
|
+
To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure.
|
|
85
|
+
|
|
86
|
+
|
|
87
|
+
## License
|
|
88
|
+
|
|
89
|
+
MIT © [Sindre Sorhus](https://sindresorhus.com)
|