* 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://www.npmjs.com/package/glob-base): Returns an object with the (non-glob) base path and the actual pattern. | [homepage](https://github.com/jonschlinkert/glob-base)
* [glob-parent](https://www.npmjs.com/package/glob-parent): Strips glob magic from a string to provide the parent path | [homepage](https://github.com/es128/glob-parent)
* [glob-path-regex](https://www.npmjs.com/package/glob-path-regex): Regular expression for matching the parts of glob pattern. | [homepage](https://github.com/regexps/glob-path-regex)
* [is-glob](https://www.npmjs.com/package/is-glob): Returns `true` if the given string looks like a glob pattern. | [homepage](https://github.com/jonschlinkert/is-glob)
* [micromatch](https://www.npmjs.com/package/micromatch): Glob matching for javascript/node.js. A drop-in replacement and faster alternative to minimatch and multimatch. Just… [more](https://www.npmjs.com/package/micromatch) | [homepage](https://github.com/jonschlinkert/micromatch)
## Contributing
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/parse-glob/issues/new).
