www.aleph1.co.uk Git - yaffs-website/blob - node_modules/glob-parent/README.md

   1 glob-parent [![Build Status](https://travis-ci.org/es128/glob-parent.svg)](https://travis-ci.org/es128/glob-parent) [![Coverage Status](https://img.shields.io/coveralls/es128/glob-parent.svg)](https://coveralls.io/r/es128/glob-parent?branch=master)
   2 ======
   3 Javascript module to extract the non-magic parent path from a glob string.
   4
   5 [![NPM](https://nodei.co/npm/glob-parent.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/glob-parent/)
   6 [![NPM](https://nodei.co/npm-dl/glob-parent.png?height=3&months=9)](https://nodei.co/npm-dl/glob-parent/)
   7
   8 Usage
   9 -----
  10 ```sh
  11 npm install glob-parent --save
  12 ```
  13
  14 ```js
  15 var globParent = require('glob-parent');
  16
  17 globParent('path/to/*.js'); // 'path/to'
  18 globParent('/root/path/to/*.js'); // '/root/path/to'
  19 globParent('/*.js'); // '/'
  20 globParent('*.js'); // '.'
  21 globParent('**/*.js'); // '.'
  22 globParent('path/{to,from}'); // 'path'
  23 globParent('path/!(to|from)'); // 'path'
  24 globParent('path/?(to|from)'); // 'path'
  25 globParent('path/+(to|from)'); // 'path'
  26 globParent('path/*(to|from)'); // 'path'
  27 globParent('path/@(to|from)'); // 'path'
  28 globParent('path/**/*'); // 'path'
  29
  30 // if provided a non-glob path, returns the nearest dir
  31 globParent('path/foo/bar.js'); // 'path/foo'
  32 globParent('path/foo/'); // 'path/foo'
  33 globParent('path/foo'); // 'path' (see issue #3 for details)
  34
  35 ```
  36
  37 Change Log
  38 ----------
  39 [See release notes page on GitHub](https://github.com/es128/glob-parent/releases)
  40
  41 License
  42 -------
  43 [ISC](https://raw.github.com/es128/glob-parent/master/LICENSE)