115 lines
3.6 KiB
Markdown
115 lines
3.6 KiB
Markdown
# parse-glob [](http://badge.fury.io/js/parse-glob) [](https://travis-ci.org/jonschlinkert/parse-glob)
|
|
|
|
> Parse a glob pattern into an object of tokens.
|
|
|
|
**Changes from v1.0.0 to v3.0.0**
|
|
|
|
- all path-related properties are now on the `path` object
|
|
- all boolean properties are now on the `is` object
|
|
- adds `base` property
|
|
|
|
See the [properties](#properties) section for details.
|
|
|
|
## Install with [npm](npmjs.org)
|
|
|
|
```bash
|
|
npm i parse-glob --save
|
|
```
|
|
|
|
- parses 1,000+ glob patterns in 29ms (2.3 GHz Intel Core i7)
|
|
- Extensive [unit tests](./test.js) (more than 1,000 lines), covering wildcards, globstars, character classes, brace patterns, extglobs, dotfiles and other complex patterns.
|
|
|
|
See the tests for [hundreds of examples](./test.js).
|
|
|
|
## Usage
|
|
|
|
```js
|
|
var parseGlob = require('parse-glob');
|
|
```
|
|
|
|
**Example**
|
|
|
|
```js
|
|
parseGlob('a/b/c/**/*.{yml,json}');
|
|
```
|
|
|
|
**Returns:**
|
|
|
|
```js
|
|
{ orig: 'a/b/c/**/*.{yml,json}',
|
|
is:
|
|
{ glob: true,
|
|
negated: false,
|
|
extglob: false,
|
|
braces: true,
|
|
brackets: false,
|
|
globstar: true,
|
|
dotfile: false,
|
|
dotdir: false },
|
|
glob: '**/*.{yml,json}',
|
|
base: 'a/b/c',
|
|
path:
|
|
{ dirname: 'a/b/c/**/',
|
|
basename: '*.{yml,json}',
|
|
filename: '*',
|
|
extname: '.{yml,json}',
|
|
ext: '{yml,json}' } }
|
|
```
|
|
|
|
## Properties
|
|
|
|
The object returned by parseGlob has the following properties:
|
|
|
|
- `orig`: a copy of the original, unmodified glob pattern
|
|
- `is`: an object with boolean information about the glob:
|
|
+ `glob`: true if the pattern actually a glob pattern
|
|
+ `negated`: true if it's a negation pattern (`!**/foo.js`)
|
|
+ `extglob`: true if it has extglobs (`@(foo|bar)`)
|
|
+ `braces`: true if it has braces (`{1..2}` or `.{txt,md}`)
|
|
+ `brackets`: true if it has POSIX brackets (`[[:alpha:]]`)
|
|
+ `globstar`: true if the pattern has a globstar (double star, `**`)
|
|
+ `dotfile`: true if the pattern should match dotfiles
|
|
+ `dotdir`: true if the pattern should match dot-directories (like `.git`)
|
|
- `glob`: the glob pattern part of the string, if any
|
|
- `base`: the non-glob part of the string, if any
|
|
- `path`: file path segments
|
|
+ `dirname`: directory
|
|
+ `basename`: file name with extension
|
|
+ `filename`: file name without extension
|
|
+ `extname`: file extension with dot
|
|
+ `ext`: file extension without dot
|
|
|
|
## Related
|
|
* [glob-base](https://github.com/jonschlinkert/glob-base): Returns an object with the (non-glob) base path and the actual pattern.
|
|
* [glob-parent](https://github.com/es128/glob-parent): Strips glob magic from a string to provide the parent path
|
|
* [is-glob](https://github.com/jonschlinkert/is-glob): Returns `true` if the given string looks like a glob pattern.
|
|
* [glob-path-regex](https://github.com/regexps/glob-path-regex): Regular expression for matching the parts of glob pattern.
|
|
* [micromatch](https://github.com/jonschlinkert/micromatch): Glob matching for javascript/node.js. A faster alternative to minimatch (10-45x faster on avg), with all the features you're used to using in your Grunt and gulp tasks.
|
|
|
|
## Contributing
|
|
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/parse-glob/issues)
|
|
|
|
|
|
## Tests
|
|
Install dev dependencies.
|
|
|
|
```bash
|
|
npm i -d && npm test
|
|
```
|
|
|
|
|
|
## Author
|
|
|
|
**Jon Schlinkert**
|
|
|
|
+ [github/jonschlinkert](https://github.com/jonschlinkert)
|
|
+ [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
|
|
|
|
## License
|
|
Copyright (c) 2014-2015 Jon Schlinkert
|
|
Released under the MIT license
|
|
|
|
***
|
|
|
|
_This file was generated by [verb-cli](https://github.com/assemble/verb-cli) on March 08, 2015._
|