source: trip-planner-front/node_modules/brace-expansion/README.md@ b738035

Last change on this file since b738035 was 6a3a178, checked in by Ema <ema_spirova@…>, 3 years ago

initial commit

  • Property mode set to 100644
File size: 4.0 KB
Line 
1# brace-expansion
2
3[Brace expansion](https://www.gnu.org/software/bash/manual/html_node/Brace-Expansion.html),
4as known from sh/bash, in JavaScript.
5
6[![build status](https://secure.travis-ci.org/juliangruber/brace-expansion.svg)](http://travis-ci.org/juliangruber/brace-expansion)
7[![downloads](https://img.shields.io/npm/dm/brace-expansion.svg)](https://www.npmjs.org/package/brace-expansion)
8[![Greenkeeper badge](https://badges.greenkeeper.io/juliangruber/brace-expansion.svg)](https://greenkeeper.io/)
9
10[![testling badge](https://ci.testling.com/juliangruber/brace-expansion.png)](https://ci.testling.com/juliangruber/brace-expansion)
11
12## Example
13
14```js
15var expand = require('brace-expansion');
16
17expand('file-{a,b,c}.jpg')
18// => ['file-a.jpg', 'file-b.jpg', 'file-c.jpg']
19
20expand('-v{,,}')
21// => ['-v', '-v', '-v']
22
23expand('file{0..2}.jpg')
24// => ['file0.jpg', 'file1.jpg', 'file2.jpg']
25
26expand('file-{a..c}.jpg')
27// => ['file-a.jpg', 'file-b.jpg', 'file-c.jpg']
28
29expand('file{2..0}.jpg')
30// => ['file2.jpg', 'file1.jpg', 'file0.jpg']
31
32expand('file{0..4..2}.jpg')
33// => ['file0.jpg', 'file2.jpg', 'file4.jpg']
34
35expand('file-{a..e..2}.jpg')
36// => ['file-a.jpg', 'file-c.jpg', 'file-e.jpg']
37
38expand('file{00..10..5}.jpg')
39// => ['file00.jpg', 'file05.jpg', 'file10.jpg']
40
41expand('{{A..C},{a..c}}')
42// => ['A', 'B', 'C', 'a', 'b', 'c']
43
44expand('ppp{,config,oe{,conf}}')
45// => ['ppp', 'pppconfig', 'pppoe', 'pppoeconf']
46```
47
48## API
49
50```js
51var expand = require('brace-expansion');
52```
53
54### var expanded = expand(str)
55
56Return an array of all possible and valid expansions of `str`. If none are
57found, `[str]` is returned.
58
59Valid expansions are:
60
61```js
62/^(.*,)+(.+)?$/
63// {a,b,...}
64```
65
66A comma separated list of options, like `{a,b}` or `{a,{b,c}}` or `{,a,}`.
67
68```js
69/^-?\d+\.\.-?\d+(\.\.-?\d+)?$/
70// {x..y[..incr]}
71```
72
73A numeric sequence from `x` to `y` inclusive, with optional increment.
74If `x` or `y` start with a leading `0`, all the numbers will be padded
75to have equal length. Negative numbers and backwards iteration work too.
76
77```js
78/^-?\d+\.\.-?\d+(\.\.-?\d+)?$/
79// {x..y[..incr]}
80```
81
82An alphabetic sequence from `x` to `y` inclusive, with optional increment.
83`x` and `y` must be exactly one character, and if given, `incr` must be a
84number.
85
86For compatibility reasons, the string `${` is not eligible for brace expansion.
87
88## Installation
89
90With [npm](https://npmjs.org) do:
91
92```bash
93npm install brace-expansion
94```
95
96## Contributors
97
98- [Julian Gruber](https://github.com/juliangruber)
99- [Isaac Z. Schlueter](https://github.com/isaacs)
100
101## Sponsors
102
103This module is proudly supported by my [Sponsors](https://github.com/juliangruber/sponsors)!
104
105Do you want to support modules like this to improve their quality, stability and weigh in on new features? Then please consider donating to my [Patreon](https://www.patreon.com/juliangruber). Not sure how much of my modules you're using? Try [feross/thanks](https://github.com/feross/thanks)!
106
107## License
108
109(MIT)
110
111Copyright (c) 2013 Julian Gruber &lt;julian@juliangruber.com&gt;
112
113Permission is hereby granted, free of charge, to any person obtaining a copy of
114this software and associated documentation files (the "Software"), to deal in
115the Software without restriction, including without limitation the rights to
116use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
117of the Software, and to permit persons to whom the Software is furnished to do
118so, subject to the following conditions:
119
120The above copyright notice and this permission notice shall be included in all
121copies or substantial portions of the Software.
122
123THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
124IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
125FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
126AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
127LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
128OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
129SOFTWARE.
Note: See TracBrowser for help on using the repository browser.