Brunobkr/llama.cpp_AlgMor24_github

1# brace-expansion2 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## Example13 14```js15var 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## API49 50```js51var expand = require('brace-expansion');52```53 54### var expanded = expand(str, [options])55 56Return an array of all possible and valid expansions of `str`. If none are57found, `[str]` is returned.58 59The `options` object can provide a `max` value to cap the number60of expansions allowed. This is limited to `100_000` by default,61to prevent DoS attacks.62 63```js64const expansions = expand('{1..100}'.repeat(5), {65  max: 100,66})67// expansions.length will be 100, not 100^568```69 70The `options` object can also provide a `maxLength` value to cap the71total number of characters across all expansions. This is limited to72`4_000_000` by default, to prevent memory exhaustion from inputs whose73result count stays under `max` while each result grows very long.74 75```js76const expansions = expand('{a,b}'.repeat(1500), {77  maxLength: 10_000,78})79```80 81Valid expansions are:82 83```js84/^(.*,)+(.+)?$/85// {a,b,...}86```87 88A comma separated list of options, like `{a,b}` or `{a,{b,c}}` or `{,a,}`.89 90```js91/^-?\d+\.\.-?\d+(\.\.-?\d+)?$/92// {x..y[..incr]}93```94 95A numeric sequence from `x` to `y` inclusive, with optional increment.96If `x` or `y` start with a leading `0`, all the numbers will be padded97to have equal length. Negative numbers and backwards iteration work too.98 99```js100/^-?\d+\.\.-?\d+(\.\.-?\d+)?$/101// {x..y[..incr]}102```103 104An alphabetic sequence from `x` to `y` inclusive, with optional increment.105`x` and `y` must be exactly one character, and if given, `incr` must be a106number.107 108For compatibility reasons, the string `${` is not eligible for brace expansion.109 110## Installation111 112With [npm](https://npmjs.org) do:113 114```bash115npm install brace-expansion116```117 118## Contributors119 120- [Julian Gruber](https://github.com/juliangruber)121- [Isaac Z. Schlueter](https://github.com/isaacs)122 123## Sponsors124 125This module is proudly supported by my [Sponsors](https://github.com/juliangruber/sponsors)!126 127Do 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)!128 129## License130 131(MIT)132 133Copyright (c) 2013 Julian Gruber <julian@juliangruber.com>134 135Permission is hereby granted, free of charge, to any person obtaining a copy of136this software and associated documentation files (the "Software"), to deal in137the Software without restriction, including without limitation the rights to138use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies139of the Software, and to permit persons to whom the Software is furnished to do140so, subject to the following conditions:141 142The above copyright notice and this permission notice shall be included in all143copies or substantial portions of the Software.144 145THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR146IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,147FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE148AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER149LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,150OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE151SOFTWARE.152