pax_global_header00006660000000000000000000000064146230611000014503gustar00rootroot0000000000000052 comment=74b2db2938fad48a2ea54a9c8bf27a37a62c350d braces-3.0.3/000077500000000000000000000000001462306110000127455ustar00rootroot00000000000000braces-3.0.3/.editorconfig000066400000000000000000000004411462306110000154210ustar00rootroot00000000000000# http://editorconfig.org/ root = true [*] charset = utf-8 end_of_line = lf indent_size = 2 indent_style = space insert_final_newline = true trim_trailing_whitespace = true [{**/{actual,fixtures,expected,templates}/**,*.md}] trim_trailing_whitespace = false insert_final_newline = false braces-3.0.3/.eslintrc.json000066400000000000000000000146001462306110000155420ustar00rootroot00000000000000{ "root": true, "extends": "eslint:recommended", "env": { "browser": false, "es6": true, "mocha": true, "node": true }, "parserOptions":{ "ecmaVersion": 9, "sourceType": "module", "ecmaFeatures": { "modules": true, "experimentalObjectRestSpread": true } }, "globals": { "document": false, "navigator": false, "window": false }, "rules": { "accessor-pairs": 2, "array-bracket-newline": [1, "consistent"], "array-bracket-spacing": [1, "never"], "array-callback-return": 1, "array-element-newline": [1, "consistent"], "arrow-body-style": 0, "arrow-parens": [1, "as-needed"], "arrow-spacing": [1, { "before": true, "after": true }], "block-scoped-var": 1, "block-spacing": [1, "always"], "brace-style": [1, "1tbs", { "allowSingleLine": true }], "callback-return": 0, "camelcase": [0, { "allow": [] }], "capitalized-comments": 0, "class-methods-use-this": 0, "comma-dangle": [1, "never"], "comma-spacing": [1, { "before": false, "after": true }], "comma-style": [1, "last"], "computed-property-spacing": 1, "consistent-return": 0, "consistent-this": 1, "constructor-super": 2, "curly": [1, "multi-line", "consistent"], "default-case": 1, "dot-location": [1, "property"], "dot-notation": 1, "eol-last": 1, "eqeqeq": [1, "allow-null"], "for-direction": 1, "func-call-spacing": 2, "generator-star-spacing": [1, { "before": true, "after": true }], "handle-callback-err": [2, "^(err|error)$"], "indent": [1, 2, { "SwitchCase": 1 }], "key-spacing": [1, { "beforeColon": false, "afterColon": true }], "keyword-spacing": [1, { "before": true, "after": true }], "linebreak-style": [1, "unix"], "new-cap": [1, { "newIsCap": true, "capIsNew": false }], "new-parens": 2, "no-alert": 1, "no-array-constructor": 1, "no-async-promise-executor": 1, "no-caller": 2, "no-case-declarations": 1, "no-class-assign": 2, "no-cond-assign": 2, "no-const-assign": 2, "no-constant-condition": [1, { "checkLoops": false }], "no-control-regex": 2, "no-debugger": 2, "no-delete-var": 2, "no-dupe-args": 2, "no-dupe-class-members": 2, "no-dupe-keys": 2, "no-duplicate-case": 2, "no-duplicate-imports": 0, "no-else-return": 0, "no-empty-character-class": 2, "no-empty-function": 0, "no-empty-pattern": 0, "no-empty": [1, { "allowEmptyCatch": true }], "no-eval": 0, "no-ex-assign": 2, "no-extend-native": 2, "no-extra-bind": 1, "no-extra-boolean-cast": 1, "no-extra-label": 1, "no-extra-parens": [1, "all", { "conditionalAssign": false, "returnAssign": false, "nestedBinaryExpressions": false, "ignoreJSX": "multi-line", "enforceForArrowConditionals": false } ], "no-extra-semi": 1, "no-fallthrough": 2, "no-floating-decimal": 2, "no-func-assign": 2, "no-global-assign": 2, "no-implicit-coercion": 2, "no-implicit-globals": 1, "no-implied-eval": 2, "no-inner-declarations": [1, "functions"], "no-invalid-regexp": 2, "no-invalid-this": 1, "no-irregular-whitespace": 2, "no-iterator": 2, "no-label-var": 2, "no-labels": 2, "no-lone-blocks": 2, "no-lonely-if": 2, "no-loop-func": 1, "no-mixed-requires": 1, "no-mixed-spaces-and-tabs": 2, "no-multi-assign": 0, "no-multi-spaces": 1, "no-multi-str": 2, "no-multiple-empty-lines": [1, { "max": 1 }], "no-native-reassign": 2, "no-negated-condition": 0, "no-negated-in-lhs": 2, "no-new-func": 2, "no-new-object": 2, "no-new-require": 2, "no-new-symbol": 1, "no-new-wrappers": 2, "no-new": 1, "no-obj-calls": 2, "no-octal-escape": 2, "no-octal": 2, "no-path-concat": 1, "no-proto": 2, "no-prototype-builtins": 0, "no-redeclare": 2, "no-regex-spaces": 2, "no-restricted-globals": 2, "no-return-assign": 1, "no-return-await": 2, "no-script-url": 1, "no-self-assign": 1, "no-self-compare": 1, "no-sequences": 2, "no-shadow-restricted-names": 2, "no-shadow": 0, "no-spaced-func": 2, "no-sparse-arrays": 2, "no-template-curly-in-string": 0, "no-this-before-super": 2, "no-throw-literal": 2, "no-trailing-spaces": 1, "no-undef-init": 2, "no-undef": 2, "no-unexpected-multiline": 2, "no-unneeded-ternary": [1, { "defaultAssignment": false }], "no-unreachable-loop": 1, "no-unreachable": 2, "no-unsafe-assignment": 0, "no-unsafe-call": 0, "no-unsafe-finally": 2, "no-unsafe-member-access": 0, "no-unsafe-negation": 2, "no-unsafe-optional-chaining": 0, "no-unsafe-return": 0, "no-unused-expressions": 2, "no-unused-vars": [1, { "vars": "all", "args": "after-used" }], "no-use-before-define": 0, "no-useless-call": 2, "no-useless-catch": 0, "no-useless-escape": 0, "no-useless-rename": 1, "no-useless-return": 1, "no-var": 1, "no-void": 1, "no-warning-comments": 0, "no-with": 2, "object-curly-spacing": [1, "always", { "objectsInObjects": true }], "object-shorthand": 1, "one-var": [1, { "initialized": "never" }], "operator-linebreak": [0, "after", { "overrides": { "?": "before", ":": "before" } }], "padded-blocks": [1, { "switches": "never" }], "prefer-const": [1, { "destructuring": "all", "ignoreReadBeforeAssign": false }], "prefer-promise-reject-errors": 1, "quotes": [1, "single", "avoid-escape"], "radix": 2, "rest-spread-spacing": 1, "semi-spacing": [1, { "before": false, "after": true }], "semi-style": 1, "semi": [1, "always"], "space-before-blocks": [1, "always"], "space-before-function-paren": [1, { "anonymous": "never", "named": "never", "asyncArrow": "always" }], "space-in-parens": [1, "never"], "space-infix-ops": 1, "space-unary-ops": [1, { "words": true, "nonwords": false }], "spaced-comment": [0, "always", { "markers": ["global", "globals", "eslint", "eslint-disable", "*package", "!", ","] }], "strict": 2, "switch-colon-spacing": 1, "symbol-description": 1, "template-curly-spacing": [2, "never"], "template-tag-spacing": [2, "never"], "unicode-bom": 1, "use-isnan": 2, "valid-jsdoc": 1, "valid-typeof": 2, "wrap-iife": [1, "any"], "yoda": [1, "never"] } } braces-3.0.3/.gitattributes000066400000000000000000000003551462306110000156430ustar00rootroot00000000000000# Enforce Unix newlines *.* text eol=lf *.css text eol=lf *.html text eol=lf *.js text eol=lf *.json text eol=lf *.less text eol=lf *.md text eol=lf *.yml text eol=lf *.jpg binary *.gif binary *.png binary *.jpeg binarybraces-3.0.3/.gitignore000066400000000000000000000004561462306110000147420ustar00rootroot00000000000000# always ignore files *.DS_Store .idea .vscode *.sublime-* # test related, or directories generated by tests test/actual actual coverage .nyc* # npm node_modules npm-debug.log # yarn yarn.lock yarn-error.log # misc _gh_pages _draft _drafts bower_components vendor temp tmp TODO.md package-lock.jsonbraces-3.0.3/.travis.yml000066400000000000000000000001271462306110000150560ustar00rootroot00000000000000os: - linux - osx - windows language: node_js node_js: - node - '10' - '8' braces-3.0.3/.verb.md000066400000000000000000000446431462306110000143160ustar00rootroot00000000000000 ## v3.0.0 Released!! See the [changelog](CHANGELOG.md) for details. ## Why use braces? Brace patterns make globs more powerful by adding the ability to match specific ranges and sequences of characters. - **Accurate** - complete support for the [Bash 4.3 Brace Expansion][bash] specification (passes all of the Bash braces tests) - **[fast and performant](#benchmarks)** - Starts fast, runs fast and [scales well](#performance) as patterns increase in complexity. - **Organized code base** - The parser and compiler are easy to maintain and update when edge cases crop up. - **Well-tested** - Thousands of test assertions, and passes all of the Bash, minimatch, and [brace-expansion][] unit tests (as of the date this was written). - **Safer** - You shouldn't have to worry about users defining aggressive or malicious brace patterns that can break your application. Braces takes measures to prevent malicious regex that can be used for DDoS attacks (see [catastrophic backtracking](https://www.regular-expressions.info/catastrophic.html)). - [Supports lists](#lists) - (aka "sets") `a/{b,c}/d` => `['a/b/d', 'a/c/d']` - [Supports sequences](#sequences) - (aka "ranges") `{01..03}` => `['01', '02', '03']` - [Supports steps](#steps) - (aka "increments") `{2..10..2}` => `['2', '4', '6', '8', '10']` - [Supports escaping](#escaping) - To prevent evaluation of special characters. ## Usage The main export is a function that takes one or more brace `patterns` and `options`. ```js const braces = require('braces'); // braces(patterns[, options]); console.log(braces(['{01..05}', '{a..e}'])); //=> ['(0[1-5])', '([a-e])'] console.log(braces(['{01..05}', '{a..e}'], { expand: true })); //=> ['01', '02', '03', '04', '05', 'a', 'b', 'c', 'd', 'e'] ``` ### Brace Expansion vs. Compilation By default, brace patterns are compiled into strings that are optimized for creating regular expressions and matching. **Compiled** ```js console.log(braces('a/{x,y,z}/b')); //=> ['a/(x|y|z)/b'] console.log(braces(['a/{01..20}/b', 'a/{1..5}/b'])); //=> [ 'a/(0[1-9]|1[0-9]|20)/b', 'a/([1-5])/b' ] ``` **Expanded** Enable brace expansion by setting the `expand` option to true, or by using [braces.expand()](#expand) (returns an array similar to what you'd expect from Bash, or `echo {1..5}`, or [minimatch](https://github.com/isaacs/minimatch)): ```js console.log(braces('a/{x,y,z}/b', { expand: true })); //=> ['a/x/b', 'a/y/b', 'a/z/b'] console.log(braces.expand('{01..10}')); //=> ['01','02','03','04','05','06','07','08','09','10'] ``` ### Lists Expand lists (like Bash "sets"): ```js console.log(braces('a/{foo,bar,baz}/*.js')); //=> ['a/(foo|bar|baz)/*.js'] console.log(braces.expand('a/{foo,bar,baz}/*.js')); //=> ['a/foo/*.js', 'a/bar/*.js', 'a/baz/*.js'] ``` ### Sequences Expand ranges of characters (like Bash "sequences"): ```js console.log(braces.expand('{1..3}')); // ['1', '2', '3'] console.log(braces.expand('a/{1..3}/b')); // ['a/1/b', 'a/2/b', 'a/3/b'] console.log(braces('{a..c}', { expand: true })); // ['a', 'b', 'c'] console.log(braces('foo/{a..c}', { expand: true })); // ['foo/a', 'foo/b', 'foo/c'] // supports zero-padded ranges console.log(braces('a/{01..03}/b')); //=> ['a/(0[1-3])/b'] console.log(braces('a/{001..300}/b')); //=> ['a/(0{2}[1-9]|0[1-9][0-9]|[12][0-9]{2}|300)/b'] ``` See [fill-range](https://github.com/jonschlinkert/fill-range) for all available range-expansion options. ### Steppped ranges Steps, or increments, may be used with ranges: ```js console.log(braces.expand('{2..10..2}')); //=> ['2', '4', '6', '8', '10'] console.log(braces('{2..10..2}')); //=> ['(2|4|6|8|10)'] ``` When the [.optimize](#optimize) method is used, or [options.optimize](#optionsoptimize) is set to true, sequences are passed to [to-regex-range](https://github.com/jonschlinkert/to-regex-range) for expansion. ### Nesting Brace patterns may be nested. The results of each expanded string are not sorted, and left to right order is preserved. **"Expanded" braces** ```js console.log(braces.expand('a{b,c,/{x,y}}/e')); //=> ['ab/e', 'ac/e', 'a/x/e', 'a/y/e'] console.log(braces.expand('a/{x,{1..5},y}/c')); //=> ['a/x/c', 'a/1/c', 'a/2/c', 'a/3/c', 'a/4/c', 'a/5/c', 'a/y/c'] ``` **"Optimized" braces** ```js console.log(braces('a{b,c,/{x,y}}/e')); //=> ['a(b|c|/(x|y))/e'] console.log(braces('a/{x,{1..5},y}/c')); //=> ['a/(x|([1-5])|y)/c'] ``` ### Escaping **Escaping braces** A brace pattern will not be expanded or evaluted if _either the opening or closing brace is escaped_: ```js console.log(braces.expand('a\\{d,c,b}e')); //=> ['a{d,c,b}e'] console.log(braces.expand('a{d,c,b\\}e')); //=> ['a{d,c,b}e'] ``` **Escaping commas** Commas inside braces may also be escaped: ```js console.log(braces.expand('a{b\\,c}d')); //=> ['a{b,c}d'] console.log(braces.expand('a{d\\,c,b}e')); //=> ['ad,ce', 'abe'] ``` **Single items** Following bash conventions, a brace pattern is also not expanded when it contains a single character: ```js console.log(braces.expand('a{b}c')); //=> ['a{b}c'] ``` ## Options ### options.maxLength **Type**: `Number` **Default**: `10,000` **Description**: Limit the length of the input string. Useful when the input string is generated or your application allows users to pass a string, et cetera. ```js console.log(braces('a/{b,c}/d', { maxLength: 3 })); //=> throws an error ``` ### options.expand **Type**: `Boolean` **Default**: `undefined` **Description**: Generate an "expanded" brace pattern (alternatively you can use the `braces.expand()` method, which does the same thing). ```js console.log(braces('a/{b,c}/d', { expand: true })); //=> [ 'a/b/d', 'a/c/d' ] ``` ### options.nodupes **Type**: `Boolean` **Default**: `undefined` **Description**: Remove duplicates from the returned array. ### options.rangeLimit **Type**: `Number` **Default**: `1000` **Description**: To prevent malicious patterns from being passed by users, an error is thrown when `braces.expand()` is used or `options.expand` is true and the generated range will exceed the `rangeLimit`. You can customize `options.rangeLimit` or set it to `Inifinity` to disable this altogether. **Examples** ```js // pattern exceeds the "rangeLimit", so it's optimized automatically console.log(braces.expand('{1..1000}')); //=> ['([1-9]|[1-9][0-9]{1,2}|1000)'] // pattern does not exceed "rangeLimit", so it's NOT optimized console.log(braces.expand('{1..100}')); //=> ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15', '16', '17', '18', '19', '20', '21', '22', '23', '24', '25', '26', '27', '28', '29', '30', '31', '32', '33', '34', '35', '36', '37', '38', '39', '40', '41', '42', '43', '44', '45', '46', '47', '48', '49', '50', '51', '52', '53', '54', '55', '56', '57', '58', '59', '60', '61', '62', '63', '64', '65', '66', '67', '68', '69', '70', '71', '72', '73', '74', '75', '76', '77', '78', '79', '80', '81', '82', '83', '84', '85', '86', '87', '88', '89', '90', '91', '92', '93', '94', '95', '96', '97', '98', '99', '100'] ``` ### options.transform **Type**: `Function` **Default**: `undefined` **Description**: Customize range expansion. **Example: Transforming non-numeric values** ```js const alpha = braces.expand('x/{a..e}/y', { transform(value, index) { // When non-numeric values are passed, "value" is a character code. return 'foo/' + String.fromCharCode(value) + '-' + index; } }); console.log(alpha); //=> [ 'x/foo/a-0/y', 'x/foo/b-1/y', 'x/foo/c-2/y', 'x/foo/d-3/y', 'x/foo/e-4/y' ] ``` **Example: Transforming numeric values** ```js const numeric = braces.expand('{1..5}', { transform(value) { // when numeric values are passed, "value" is a number return 'foo/' + value * 2; } }); console.log(numeric); //=> [ 'foo/2', 'foo/4', 'foo/6', 'foo/8', 'foo/10' ] ``` ### options.quantifiers **Type**: `Boolean` **Default**: `undefined` **Description**: In regular expressions, quanitifiers can be used to specify how many times a token can be repeated. For example, `a{1,3}` will match the letter `a` one to three times. Unfortunately, regex quantifiers happen to share the same syntax as [Bash lists](#lists) The `quantifiers` option tells braces to detect when [regex quantifiers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp#quantifiers) are defined in the given pattern, and not to try to expand them as lists. **Examples** ```js const braces = require('braces'); console.log(braces('a/b{1,3}/{x,y,z}')); //=> [ 'a/b(1|3)/(x|y|z)' ] console.log(braces('a/b{1,3}/{x,y,z}', {quantifiers: true})); //=> [ 'a/b{1,3}/(x|y|z)' ] console.log(braces('a/b{1,3}/{x,y,z}', {quantifiers: true, expand: true})); //=> [ 'a/b{1,3}/x', 'a/b{1,3}/y', 'a/b{1,3}/z' ] ``` ### options.unescape **Type**: `Boolean` **Default**: `undefined` **Description**: Strip backslashes that were used for escaping from the result. ## What is "brace expansion"? Brace expansion is a type of parameter expansion that was made popular by unix shells for generating lists of strings, as well as regex-like matching when used alongside wildcards (globs). In addition to "expansion", braces are also used for matching. In other words: * [brace expansion](#brace-expansion) is for generating new lists * [brace matching](#brace-matching) is for filtering existing lists
More about brace expansion (click to expand) There are two main types of brace expansion: 1. **lists**: which are defined using comma-separated values inside curly braces: `{a,b,c}` 2. **sequences**: which are defined using a starting value and an ending value, separated by two dots: `a{1..3}b`. Optionally, a third argument may be passed to define a "step" or increment to use: `a{1..100..10}b`. These are also sometimes referred to as "ranges". Here are some example brace patterns to illustrate how they work: **Sets** ``` {a,b,c} => a b c {a,b,c}{1,2} => a1 a2 b1 b2 c1 c2 ``` **Sequences** ``` {1..9} => 1 2 3 4 5 6 7 8 9 {4..-4} => 4 3 2 1 0 -1 -2 -3 -4 {1..20..3} => 1 4 7 10 13 16 19 {a..j} => a b c d e f g h i j {j..a} => j i h g f e d c b a {a..z..3} => a d g j m p s v y ``` **Combination** Sets and sequences can be mixed together or used along with any other strings. ``` {a,b,c}{1..3} => a1 a2 a3 b1 b2 b3 c1 c2 c3 foo/{a,b,c}/bar => foo/a/bar foo/b/bar foo/c/bar ``` The fact that braces can be "expanded" from relatively simple patterns makes them ideal for quickly generating test fixtures, file paths, and similar use cases. ## Brace matching In addition to _expansion_, brace patterns are also useful for performing regular-expression-like matching. For example, the pattern `foo/{1..3}/bar` would match any of following strings: ``` foo/1/bar foo/2/bar foo/3/bar ``` But not: ``` baz/1/qux baz/2/qux baz/3/qux ``` Braces can also be combined with [glob patterns][micromatch] to perform more advanced wildcard matching. For example, the pattern `*/{1..3}/*` would match any of following strings: ``` foo/1/bar foo/2/bar foo/3/bar baz/1/qux baz/2/qux baz/3/qux ``` ## Brace matching pitfalls Although brace patterns offer a user-friendly way of matching ranges or sets of strings, there are also some major disadvantages and potential risks you should be aware of. ### tldr **"brace bombs"** - brace expansion can eat up a huge amount of processing resources - as brace patterns increase _linearly in size_, the system resources required to expand the pattern increase exponentially - users can accidentally (or intentially) exhaust your system's resources resulting in the equivalent of a DoS attack (bonus: no programming knowledge is required!) For a more detailed explanation with examples, see the [geometric complexity](#geometric-complexity) section. ### The solution Jump to the [performance section](#performance) to see how Braces solves this problem in comparison to other libraries. ### Geometric complexity At minimum, brace patterns with sets limited to two elements have quadradic or `O(n^2)` complexity. But the complexity of the algorithm increases exponentially as the number of sets, _and elements per set_, increases, which is `O(n^c)`. For example, the following sets demonstrate quadratic (`O(n^2)`) complexity: ``` {1,2}{3,4} => (2X2) => 13 14 23 24 {1,2}{3,4}{5,6} => (2X2X2) => 135 136 145 146 235 236 245 246 ``` But add an element to a set, and we get a n-fold Cartesian product with `O(n^c)` complexity: ``` {1,2,3}{4,5,6}{7,8,9} => (3X3X3) => 147 148 149 157 158 159 167 168 169 247 248 249 257 258 259 267 268 269 347 348 349 357 358 359 367 368 369 ``` Now, imagine how this complexity grows given that each element is a n-tuple: ``` {1..100}{1..100} => (100X100) => 10,000 elements (38.4 kB) {1..100}{1..100}{1..100} => (100X100X100) => 1,000,000 elements (5.76 MB) ``` Although these examples are clearly contrived, they demonstrate how brace patterns can quickly grow out of control. **More information** Interested in learning more about brace expansion? - [linuxjournal/bash-brace-expansion](http://www.linuxjournal.com/content/bash-brace-expansion) - [rosettacode/Brace_expansion](https://rosettacode.org/wiki/Brace_expansion) - [cartesian product](https://en.wikipedia.org/wiki/Cartesian_product)
## Performance Braces is not only screaming fast, it's also more accurate the other brace expansion libraries. ### Better algorithms Fortunately there is a solution to the ["brace bomb" problem](#brace-matching-pitfalls): _don't expand brace patterns into an array when they're used for matching_. Instead, convert the pattern into an optimized regular expression. This is easier said than done, and braces is the only library that does this currently. **The proof is in the numbers** Minimatch gets exponentially slower as patterns increase in complexity, braces does not. The following results were generated using `braces()` and `minimatch.braceExpand()`, respectively. | **Pattern** | **braces** | **[minimatch][]** | | --- | --- | --- | | `{1..9007199254740991}`[^1] | `298 B` (5ms 459μs)| N/A (freezes) | | `{1..1000000000000000}` | `41 B` (1ms 15μs) | N/A (freezes) | | `{1..100000000000000}` | `40 B` (890μs) | N/A (freezes) | | `{1..10000000000000}` | `39 B` (2ms 49μs) | N/A (freezes) | | `{1..1000000000000}` | `38 B` (608μs) | N/A (freezes) | | `{1..100000000000}` | `37 B` (397μs) | N/A (freezes) | | `{1..10000000000}` | `35 B` (983μs) | N/A (freezes) | | `{1..1000000000}` | `34 B` (798μs) | N/A (freezes) | | `{1..100000000}` | `33 B` (733μs) | N/A (freezes) | | `{1..10000000}` | `32 B` (5ms 632μs) | `78.89 MB` (16s 388ms 569μs) | | `{1..1000000}` | `31 B` (1ms 381μs) | `6.89 MB` (1s 496ms 887μs) | | `{1..100000}` | `30 B` (950μs) | `588.89 kB` (146ms 921μs) | | `{1..10000}` | `29 B` (1ms 114μs) | `48.89 kB` (14ms 187μs) | | `{1..1000}` | `28 B` (760μs) | `3.89 kB` (1ms 453μs) | | `{1..100}` | `22 B` (345μs) | `291 B` (196μs) | | `{1..10}` | `10 B` (533μs) | `20 B` (37μs) | | `{1..3}` | `7 B` (190μs) | `5 B` (27μs) | ### Faster algorithms When you need expansion, braces is still much faster. _(the following results were generated using `braces.expand()` and `minimatch.braceExpand()`, respectively)_ | **Pattern** | **braces** | **[minimatch][]** | | --- | --- | --- | | `{1..10000000}` | `78.89 MB` (2s 698ms 642μs) | `78.89 MB` (18s 601ms 974μs) | | `{1..1000000}` | `6.89 MB` (458ms 576μs) | `6.89 MB` (1s 491ms 621μs) | | `{1..100000}` | `588.89 kB` (20ms 728μs) | `588.89 kB` (156ms 919μs) | | `{1..10000}` | `48.89 kB` (2ms 202μs) | `48.89 kB` (13ms 641μs) | | `{1..1000}` | `3.89 kB` (1ms 796μs) | `3.89 kB` (1ms 958μs) | | `{1..100}` | `291 B` (424μs) | `291 B` (211μs) | | `{1..10}` | `20 B` (487μs) | `20 B` (72μs) | | `{1..3}` | `5 B` (166μs) | `5 B` (27μs) | If you'd like to run these comparisons yourself, see [test/support/generate.js](test/support/generate.js). ## Benchmarks ### Running benchmarks Install dev dependencies: ```bash npm i -d && npm benchmark ``` ### Latest results Braces is more accurate, without sacrificing performance. ```bash # range (expanded) braces x 29,040 ops/sec ±3.69% (91 runs sampled)) minimatch x 4,735 ops/sec ±1.28% (90 runs sampled) # range (optimized for regex) braces x 382,878 ops/sec ±0.56% (94 runs sampled) minimatch x 1,040 ops/sec ±0.44% (93 runs sampled) # nested ranges (expanded) braces x 19,744 ops/sec ±2.27% (92 runs sampled)) minimatch x 4,579 ops/sec ±0.50% (93 runs sampled) # nested ranges (optimized for regex) braces x 246,019 ops/sec ±2.02% (93 runs sampled) minimatch x 1,028 ops/sec ±0.39% (94 runs sampled) # set (expanded) braces x 138,641 ops/sec ±0.53% (95 runs sampled) minimatch x 219,582 ops/sec ±0.98% (94 runs sampled) # set (optimized for regex) braces x 388,408 ops/sec ±0.41% (95 runs sampled) minimatch x 44,724 ops/sec ±0.91% (89 runs sampled) # nested sets (expanded) braces x 84,966 ops/sec ±0.48% (94 runs sampled) minimatch x 140,720 ops/sec ±0.37% (95 runs sampled) # nested sets (optimized for regex) braces x 263,340 ops/sec ±2.06% (92 runs sampled) minimatch x 28,714 ops/sec ±0.40% (90 runs sampled) ``` [^1]: this is the largest safe integer allowed in JavaScript. [bash]: www.gnu.org/software/bash/ [braces]: https://github.com/jonschlinkert/braces [brace-expansion]: https://github.com/juliangruber/brace-expansion [fill-range]: https://github.com/jonschlinkert/fill-range [micromatch]: https://github.com/jonschlinkert/micromatch [minimatch]: https://github.com/isaacs/minimatch [quantifiers]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp#quantifiers [dos]: https://en.wikipedia.org/wiki/Denial-of-service_attack [bug]: https://medium.com/node-security/minimatch-redos-vulnerability-590da24e6d3c#.jew0b6mpcbraces-3.0.3/CHANGELOG.md000066400000000000000000000120331462306110000145550ustar00rootroot00000000000000# Release history All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
Guiding Principles - Changelogs are for humans, not machines. - There should be an entry for every single version. - The same types of changes should be grouped. - Versions and sections should be linkable. - The latest version comes first. - The release date of each versions is displayed. - Mention whether you follow Semantic Versioning.
Types of changes Changelog entries are classified using the following labels _(from [keep-a-changelog](http://keepachangelog.com/)_): - `Added` for new features. - `Changed` for changes in existing functionality. - `Deprecated` for soon-to-be removed features. - `Removed` for now removed features. - `Fixed` for any bug fixes. - `Security` in case of vulnerabilities.
## [3.0.0] - 2018-04-08 v3.0 is a complete refactor, resulting in a faster, smaller codebase, with fewer deps, and a more accurate parser and compiler. **Breaking Changes** - The undocumented `.makeRe` method was removed **Non-breaking changes** - Caching was removed ## [2.3.2] - 2018-04-08 - start refactoring - cover sets - better range handling ## [2.3.1] - 2018-02-17 - Remove unnecessary escape in Regex. (#14) ## [2.3.0] - 2017-10-19 - minor code reorganization - optimize regex - expose `maxLength` option ## [2.2.1] - 2017-05-30 - don't condense when braces contain extglobs ## [2.2.0] - 2017-05-28 - ensure word boundaries are preserved - fixes edge case where extglob characters precede a brace pattern ## [2.1.1] - 2017-04-27 - use snapdragon-node - handle edge case - optimizations, lint ## [2.0.4] - 2017-04-11 - pass opts to compiler - minor optimization in create method - re-write parser handlers to remove negation regex ## [2.0.3] - 2016-12-10 - use split-string - clear queue at the end - adds sequences example - add unit tests ## [2.0.2] - 2016-10-21 - fix comma handling in nested extglobs ## [2.0.1] - 2016-10-20 - add comments - more tests, ensure quotes are stripped ## [2.0.0] - 2016-10-19 - don't expand braces inside character classes - add quantifier pattern ## [1.8.5] - 2016-05-21 - Refactor (#10) ## [1.8.4] - 2016-04-20 - fixes https://github.com/jonschlinkert/micromatch/issues/66 ## [1.8.0] - 2015-03-18 - adds exponent examples, tests - fixes the first example in https://github.com/jonschlinkert/micromatch/issues/38 ## [1.6.0] - 2015-01-30 - optimizations, `bash` mode: - improve path escaping ## [1.5.0] - 2015-01-28 - Merge pull request #5 from eush77/lib-files ## [1.4.0] - 2015-01-24 - add extglob tests - externalize exponent function - better whitespace handling ## [1.3.0] - 2015-01-24 - make regex patterns explicity ## [1.1.0] - 2015-01-11 - don't create a match group with `makeRe` ## [1.0.0] - 2014-12-23 - Merge commit '97b05f5544f8348736a8efaecf5c32bbe3e2ad6e' - support empty brace syntax - better bash coverage - better support for regex strings ## [0.1.4] - 2014-11-14 - improve recognition of bad args, recognize mismatched argument types - support escaping - remove pathname-expansion - support whitespace in patterns ## [0.1.0] - first commit [2.3.2]: https://github.com/micromatch/braces/compare/2.3.1...2.3.2 [2.3.1]: https://github.com/micromatch/braces/compare/2.3.0...2.3.1 [2.3.0]: https://github.com/micromatch/braces/compare/2.2.1...2.3.0 [2.2.1]: https://github.com/micromatch/braces/compare/2.2.0...2.2.1 [2.2.0]: https://github.com/micromatch/braces/compare/2.1.1...2.2.0 [2.1.1]: https://github.com/micromatch/braces/compare/2.1.0...2.1.1 [2.1.0]: https://github.com/micromatch/braces/compare/2.0.4...2.1.0 [2.0.4]: https://github.com/micromatch/braces/compare/2.0.3...2.0.4 [2.0.3]: https://github.com/micromatch/braces/compare/2.0.2...2.0.3 [2.0.2]: https://github.com/micromatch/braces/compare/2.0.1...2.0.2 [2.0.1]: https://github.com/micromatch/braces/compare/2.0.0...2.0.1 [2.0.0]: https://github.com/micromatch/braces/compare/1.8.5...2.0.0 [1.8.5]: https://github.com/micromatch/braces/compare/1.8.4...1.8.5 [1.8.4]: https://github.com/micromatch/braces/compare/1.8.0...1.8.4 [1.8.0]: https://github.com/micromatch/braces/compare/1.6.0...1.8.0 [1.6.0]: https://github.com/micromatch/braces/compare/1.5.0...1.6.0 [1.5.0]: https://github.com/micromatch/braces/compare/1.4.0...1.5.0 [1.4.0]: https://github.com/micromatch/braces/compare/1.3.0...1.4.0 [1.3.0]: https://github.com/micromatch/braces/compare/1.2.0...1.3.0 [1.2.0]: https://github.com/micromatch/braces/compare/1.1.0...1.2.0 [1.1.0]: https://github.com/micromatch/braces/compare/1.0.0...1.1.0 [1.0.0]: https://github.com/micromatch/braces/compare/0.1.4...1.0.0 [0.1.4]: https://github.com/micromatch/braces/compare/0.1.0...0.1.4 [Unreleased]: https://github.com/micromatch/braces/compare/0.1.0...HEAD [keep-a-changelog]: https://github.com/olivierlacan/keep-a-changelogbraces-3.0.3/LICENSE000066400000000000000000000021031462306110000137460ustar00rootroot00000000000000The MIT License (MIT) Copyright (c) 2014-present, Jon Schlinkert. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. braces-3.0.3/README.md000066400000000000000000000520011462306110000142220ustar00rootroot00000000000000# braces [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=W8YFZ425KND68) [![NPM version](https://img.shields.io/npm/v/braces.svg?style=flat)](https://www.npmjs.com/package/braces) [![NPM monthly downloads](https://img.shields.io/npm/dm/braces.svg?style=flat)](https://npmjs.org/package/braces) [![NPM total downloads](https://img.shields.io/npm/dt/braces.svg?style=flat)](https://npmjs.org/package/braces) [![Linux Build Status](https://img.shields.io/travis/micromatch/braces.svg?style=flat&label=Travis)](https://travis-ci.org/micromatch/braces) > Bash-like brace expansion, implemented in JavaScript. Safer than other brace expansion libs, with complete support for the Bash 4.3 braces specification, without sacrificing speed. Please consider following this project's author, [Jon Schlinkert](https://github.com/jonschlinkert), and consider starring the project to show your :heart: and support. ## Install Install with [npm](https://www.npmjs.com/): ```sh $ npm install --save braces ``` ## v3.0.0 Released!! See the [changelog](CHANGELOG.md) for details. ## Why use braces? Brace patterns make globs more powerful by adding the ability to match specific ranges and sequences of characters. - **Accurate** - complete support for the [Bash 4.3 Brace Expansion](www.gnu.org/software/bash/) specification (passes all of the Bash braces tests) - **[fast and performant](#benchmarks)** - Starts fast, runs fast and [scales well](#performance) as patterns increase in complexity. - **Organized code base** - The parser and compiler are easy to maintain and update when edge cases crop up. - **Well-tested** - Thousands of test assertions, and passes all of the Bash, minimatch, and [brace-expansion](https://github.com/juliangruber/brace-expansion) unit tests (as of the date this was written). - **Safer** - You shouldn't have to worry about users defining aggressive or malicious brace patterns that can break your application. Braces takes measures to prevent malicious regex that can be used for DDoS attacks (see [catastrophic backtracking](https://www.regular-expressions.info/catastrophic.html)). - [Supports lists](#lists) - (aka "sets") `a/{b,c}/d` => `['a/b/d', 'a/c/d']` - [Supports sequences](#sequences) - (aka "ranges") `{01..03}` => `['01', '02', '03']` - [Supports steps](#steps) - (aka "increments") `{2..10..2}` => `['2', '4', '6', '8', '10']` - [Supports escaping](#escaping) - To prevent evaluation of special characters. ## Usage The main export is a function that takes one or more brace `patterns` and `options`. ```js const braces = require('braces'); // braces(patterns[, options]); console.log(braces(['{01..05}', '{a..e}'])); //=> ['(0[1-5])', '([a-e])'] console.log(braces(['{01..05}', '{a..e}'], { expand: true })); //=> ['01', '02', '03', '04', '05', 'a', 'b', 'c', 'd', 'e'] ``` ### Brace Expansion vs. Compilation By default, brace patterns are compiled into strings that are optimized for creating regular expressions and matching. **Compiled** ```js console.log(braces('a/{x,y,z}/b')); //=> ['a/(x|y|z)/b'] console.log(braces(['a/{01..20}/b', 'a/{1..5}/b'])); //=> [ 'a/(0[1-9]|1[0-9]|20)/b', 'a/([1-5])/b' ] ``` **Expanded** Enable brace expansion by setting the `expand` option to true, or by using [braces.expand()](#expand) (returns an array similar to what you'd expect from Bash, or `echo {1..5}`, or [minimatch](https://github.com/isaacs/minimatch)): ```js console.log(braces('a/{x,y,z}/b', { expand: true })); //=> ['a/x/b', 'a/y/b', 'a/z/b'] console.log(braces.expand('{01..10}')); //=> ['01','02','03','04','05','06','07','08','09','10'] ``` ### Lists Expand lists (like Bash "sets"): ```js console.log(braces('a/{foo,bar,baz}/*.js')); //=> ['a/(foo|bar|baz)/*.js'] console.log(braces.expand('a/{foo,bar,baz}/*.js')); //=> ['a/foo/*.js', 'a/bar/*.js', 'a/baz/*.js'] ``` ### Sequences Expand ranges of characters (like Bash "sequences"): ```js console.log(braces.expand('{1..3}')); // ['1', '2', '3'] console.log(braces.expand('a/{1..3}/b')); // ['a/1/b', 'a/2/b', 'a/3/b'] console.log(braces('{a..c}', { expand: true })); // ['a', 'b', 'c'] console.log(braces('foo/{a..c}', { expand: true })); // ['foo/a', 'foo/b', 'foo/c'] // supports zero-padded ranges console.log(braces('a/{01..03}/b')); //=> ['a/(0[1-3])/b'] console.log(braces('a/{001..300}/b')); //=> ['a/(0{2}[1-9]|0[1-9][0-9]|[12][0-9]{2}|300)/b'] ``` See [fill-range](https://github.com/jonschlinkert/fill-range) for all available range-expansion options. ### Steppped ranges Steps, or increments, may be used with ranges: ```js console.log(braces.expand('{2..10..2}')); //=> ['2', '4', '6', '8', '10'] console.log(braces('{2..10..2}')); //=> ['(2|4|6|8|10)'] ``` When the [.optimize](#optimize) method is used, or [options.optimize](#optionsoptimize) is set to true, sequences are passed to [to-regex-range](https://github.com/jonschlinkert/to-regex-range) for expansion. ### Nesting Brace patterns may be nested. The results of each expanded string are not sorted, and left to right order is preserved. **"Expanded" braces** ```js console.log(braces.expand('a{b,c,/{x,y}}/e')); //=> ['ab/e', 'ac/e', 'a/x/e', 'a/y/e'] console.log(braces.expand('a/{x,{1..5},y}/c')); //=> ['a/x/c', 'a/1/c', 'a/2/c', 'a/3/c', 'a/4/c', 'a/5/c', 'a/y/c'] ``` **"Optimized" braces** ```js console.log(braces('a{b,c,/{x,y}}/e')); //=> ['a(b|c|/(x|y))/e'] console.log(braces('a/{x,{1..5},y}/c')); //=> ['a/(x|([1-5])|y)/c'] ``` ### Escaping **Escaping braces** A brace pattern will not be expanded or evaluted if _either the opening or closing brace is escaped_: ```js console.log(braces.expand('a\\{d,c,b}e')); //=> ['a{d,c,b}e'] console.log(braces.expand('a{d,c,b\\}e')); //=> ['a{d,c,b}e'] ``` **Escaping commas** Commas inside braces may also be escaped: ```js console.log(braces.expand('a{b\\,c}d')); //=> ['a{b,c}d'] console.log(braces.expand('a{d\\,c,b}e')); //=> ['ad,ce', 'abe'] ``` **Single items** Following bash conventions, a brace pattern is also not expanded when it contains a single character: ```js console.log(braces.expand('a{b}c')); //=> ['a{b}c'] ``` ## Options ### options.maxLength **Type**: `Number` **Default**: `10,000` **Description**: Limit the length of the input string. Useful when the input string is generated or your application allows users to pass a string, et cetera. ```js console.log(braces('a/{b,c}/d', { maxLength: 3 })); //=> throws an error ``` ### options.expand **Type**: `Boolean` **Default**: `undefined` **Description**: Generate an "expanded" brace pattern (alternatively you can use the `braces.expand()` method, which does the same thing). ```js console.log(braces('a/{b,c}/d', { expand: true })); //=> [ 'a/b/d', 'a/c/d' ] ``` ### options.nodupes **Type**: `Boolean` **Default**: `undefined` **Description**: Remove duplicates from the returned array. ### options.rangeLimit **Type**: `Number` **Default**: `1000` **Description**: To prevent malicious patterns from being passed by users, an error is thrown when `braces.expand()` is used or `options.expand` is true and the generated range will exceed the `rangeLimit`. You can customize `options.rangeLimit` or set it to `Inifinity` to disable this altogether. **Examples** ```js // pattern exceeds the "rangeLimit", so it's optimized automatically console.log(braces.expand('{1..1000}')); //=> ['([1-9]|[1-9][0-9]{1,2}|1000)'] // pattern does not exceed "rangeLimit", so it's NOT optimized console.log(braces.expand('{1..100}')); //=> ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '12', '13', '14', '15', '16', '17', '18', '19', '20', '21', '22', '23', '24', '25', '26', '27', '28', '29', '30', '31', '32', '33', '34', '35', '36', '37', '38', '39', '40', '41', '42', '43', '44', '45', '46', '47', '48', '49', '50', '51', '52', '53', '54', '55', '56', '57', '58', '59', '60', '61', '62', '63', '64', '65', '66', '67', '68', '69', '70', '71', '72', '73', '74', '75', '76', '77', '78', '79', '80', '81', '82', '83', '84', '85', '86', '87', '88', '89', '90', '91', '92', '93', '94', '95', '96', '97', '98', '99', '100'] ``` ### options.transform **Type**: `Function` **Default**: `undefined` **Description**: Customize range expansion. **Example: Transforming non-numeric values** ```js const alpha = braces.expand('x/{a..e}/y', { transform(value, index) { // When non-numeric values are passed, "value" is a character code. return 'foo/' + String.fromCharCode(value) + '-' + index; }, }); console.log(alpha); //=> [ 'x/foo/a-0/y', 'x/foo/b-1/y', 'x/foo/c-2/y', 'x/foo/d-3/y', 'x/foo/e-4/y' ] ``` **Example: Transforming numeric values** ```js const numeric = braces.expand('{1..5}', { transform(value) { // when numeric values are passed, "value" is a number return 'foo/' + value * 2; }, }); console.log(numeric); //=> [ 'foo/2', 'foo/4', 'foo/6', 'foo/8', 'foo/10' ] ``` ### options.quantifiers **Type**: `Boolean` **Default**: `undefined` **Description**: In regular expressions, quanitifiers can be used to specify how many times a token can be repeated. For example, `a{1,3}` will match the letter `a` one to three times. Unfortunately, regex quantifiers happen to share the same syntax as [Bash lists](#lists) The `quantifiers` option tells braces to detect when [regex quantifiers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp#quantifiers) are defined in the given pattern, and not to try to expand them as lists. **Examples** ```js const braces = require('braces'); console.log(braces('a/b{1,3}/{x,y,z}')); //=> [ 'a/b(1|3)/(x|y|z)' ] console.log(braces('a/b{1,3}/{x,y,z}', { quantifiers: true })); //=> [ 'a/b{1,3}/(x|y|z)' ] console.log(braces('a/b{1,3}/{x,y,z}', { quantifiers: true, expand: true })); //=> [ 'a/b{1,3}/x', 'a/b{1,3}/y', 'a/b{1,3}/z' ] ``` ### options.keepEscaping **Type**: `Boolean` **Default**: `undefined` **Description**: Do not strip backslashes that were used for escaping from the result. ## What is "brace expansion"? Brace expansion is a type of parameter expansion that was made popular by unix shells for generating lists of strings, as well as regex-like matching when used alongside wildcards (globs). In addition to "expansion", braces are also used for matching. In other words: - [brace expansion](#brace-expansion) is for generating new lists - [brace matching](#brace-matching) is for filtering existing lists
More about brace expansion (click to expand) There are two main types of brace expansion: 1. **lists**: which are defined using comma-separated values inside curly braces: `{a,b,c}` 2. **sequences**: which are defined using a starting value and an ending value, separated by two dots: `a{1..3}b`. Optionally, a third argument may be passed to define a "step" or increment to use: `a{1..100..10}b`. These are also sometimes referred to as "ranges". Here are some example brace patterns to illustrate how they work: **Sets** ``` {a,b,c} => a b c {a,b,c}{1,2} => a1 a2 b1 b2 c1 c2 ``` **Sequences** ``` {1..9} => 1 2 3 4 5 6 7 8 9 {4..-4} => 4 3 2 1 0 -1 -2 -3 -4 {1..20..3} => 1 4 7 10 13 16 19 {a..j} => a b c d e f g h i j {j..a} => j i h g f e d c b a {a..z..3} => a d g j m p s v y ``` **Combination** Sets and sequences can be mixed together or used along with any other strings. ``` {a,b,c}{1..3} => a1 a2 a3 b1 b2 b3 c1 c2 c3 foo/{a,b,c}/bar => foo/a/bar foo/b/bar foo/c/bar ``` The fact that braces can be "expanded" from relatively simple patterns makes them ideal for quickly generating test fixtures, file paths, and similar use cases. ## Brace matching In addition to _expansion_, brace patterns are also useful for performing regular-expression-like matching. For example, the pattern `foo/{1..3}/bar` would match any of following strings: ``` foo/1/bar foo/2/bar foo/3/bar ``` But not: ``` baz/1/qux baz/2/qux baz/3/qux ``` Braces can also be combined with [glob patterns](https://github.com/jonschlinkert/micromatch) to perform more advanced wildcard matching. For example, the pattern `*/{1..3}/*` would match any of following strings: ``` foo/1/bar foo/2/bar foo/3/bar baz/1/qux baz/2/qux baz/3/qux ``` ## Brace matching pitfalls Although brace patterns offer a user-friendly way of matching ranges or sets of strings, there are also some major disadvantages and potential risks you should be aware of. ### tldr **"brace bombs"** - brace expansion can eat up a huge amount of processing resources - as brace patterns increase _linearly in size_, the system resources required to expand the pattern increase exponentially - users can accidentally (or intentially) exhaust your system's resources resulting in the equivalent of a DoS attack (bonus: no programming knowledge is required!) For a more detailed explanation with examples, see the [geometric complexity](#geometric-complexity) section. ### The solution Jump to the [performance section](#performance) to see how Braces solves this problem in comparison to other libraries. ### Geometric complexity At minimum, brace patterns with sets limited to two elements have quadradic or `O(n^2)` complexity. But the complexity of the algorithm increases exponentially as the number of sets, _and elements per set_, increases, which is `O(n^c)`. For example, the following sets demonstrate quadratic (`O(n^2)`) complexity: ``` {1,2}{3,4} => (2X2) => 13 14 23 24 {1,2}{3,4}{5,6} => (2X2X2) => 135 136 145 146 235 236 245 246 ``` But add an element to a set, and we get a n-fold Cartesian product with `O(n^c)` complexity: ``` {1,2,3}{4,5,6}{7,8,9} => (3X3X3) => 147 148 149 157 158 159 167 168 169 247 248 249 257 258 259 267 268 269 347 348 349 357 358 359 367 368 369 ``` Now, imagine how this complexity grows given that each element is a n-tuple: ``` {1..100}{1..100} => (100X100) => 10,000 elements (38.4 kB) {1..100}{1..100}{1..100} => (100X100X100) => 1,000,000 elements (5.76 MB) ``` Although these examples are clearly contrived, they demonstrate how brace patterns can quickly grow out of control. **More information** Interested in learning more about brace expansion? - [linuxjournal/bash-brace-expansion](http://www.linuxjournal.com/content/bash-brace-expansion) - [rosettacode/Brace_expansion](https://rosettacode.org/wiki/Brace_expansion) - [cartesian product](https://en.wikipedia.org/wiki/Cartesian_product)
## Performance Braces is not only screaming fast, it's also more accurate the other brace expansion libraries. ### Better algorithms Fortunately there is a solution to the ["brace bomb" problem](#brace-matching-pitfalls): _don't expand brace patterns into an array when they're used for matching_. Instead, convert the pattern into an optimized regular expression. This is easier said than done, and braces is the only library that does this currently. **The proof is in the numbers** Minimatch gets exponentially slower as patterns increase in complexity, braces does not. The following results were generated using `braces()` and `minimatch.braceExpand()`, respectively. | **Pattern** | **braces** | **[minimatch][]** | | --------------------------- | ------------------- | ---------------------------- | | `{1..9007199254740991}`[^1] | `298 B` (5ms 459μs) | N/A (freezes) | | `{1..1000000000000000}` | `41 B` (1ms 15μs) | N/A (freezes) | | `{1..100000000000000}` | `40 B` (890μs) | N/A (freezes) | | `{1..10000000000000}` | `39 B` (2ms 49μs) | N/A (freezes) | | `{1..1000000000000}` | `38 B` (608μs) | N/A (freezes) | | `{1..100000000000}` | `37 B` (397μs) | N/A (freezes) | | `{1..10000000000}` | `35 B` (983μs) | N/A (freezes) | | `{1..1000000000}` | `34 B` (798μs) | N/A (freezes) | | `{1..100000000}` | `33 B` (733μs) | N/A (freezes) | | `{1..10000000}` | `32 B` (5ms 632μs) | `78.89 MB` (16s 388ms 569μs) | | `{1..1000000}` | `31 B` (1ms 381μs) | `6.89 MB` (1s 496ms 887μs) | | `{1..100000}` | `30 B` (950μs) | `588.89 kB` (146ms 921μs) | | `{1..10000}` | `29 B` (1ms 114μs) | `48.89 kB` (14ms 187μs) | | `{1..1000}` | `28 B` (760μs) | `3.89 kB` (1ms 453μs) | | `{1..100}` | `22 B` (345μs) | `291 B` (196μs) | | `{1..10}` | `10 B` (533μs) | `20 B` (37μs) | | `{1..3}` | `7 B` (190μs) | `5 B` (27μs) | ### Faster algorithms When you need expansion, braces is still much faster. _(the following results were generated using `braces.expand()` and `minimatch.braceExpand()`, respectively)_ | **Pattern** | **braces** | **[minimatch][]** | | --------------- | --------------------------- | ---------------------------- | | `{1..10000000}` | `78.89 MB` (2s 698ms 642μs) | `78.89 MB` (18s 601ms 974μs) | | `{1..1000000}` | `6.89 MB` (458ms 576μs) | `6.89 MB` (1s 491ms 621μs) | | `{1..100000}` | `588.89 kB` (20ms 728μs) | `588.89 kB` (156ms 919μs) | | `{1..10000}` | `48.89 kB` (2ms 202μs) | `48.89 kB` (13ms 641μs) | | `{1..1000}` | `3.89 kB` (1ms 796μs) | `3.89 kB` (1ms 958μs) | | `{1..100}` | `291 B` (424μs) | `291 B` (211μs) | | `{1..10}` | `20 B` (487μs) | `20 B` (72μs) | | `{1..3}` | `5 B` (166μs) | `5 B` (27μs) | If you'd like to run these comparisons yourself, see [test/support/generate.js](test/support/generate.js). ## Benchmarks ### Running benchmarks Install dev dependencies: ```bash npm i -d && npm benchmark ``` ### Latest results Braces is more accurate, without sacrificing performance. ```bash ● expand - range (expanded) braces x 53,167 ops/sec ±0.12% (102 runs sampled) minimatch x 11,378 ops/sec ±0.10% (102 runs sampled) ● expand - range (optimized for regex) braces x 373,442 ops/sec ±0.04% (100 runs sampled) minimatch x 3,262 ops/sec ±0.18% (100 runs sampled) ● expand - nested ranges (expanded) braces x 33,921 ops/sec ±0.09% (99 runs sampled) minimatch x 10,855 ops/sec ±0.28% (100 runs sampled) ● expand - nested ranges (optimized for regex) braces x 287,479 ops/sec ±0.52% (98 runs sampled) minimatch x 3,219 ops/sec ±0.28% (101 runs sampled) ● expand - set (expanded) braces x 238,243 ops/sec ±0.19% (97 runs sampled) minimatch x 538,268 ops/sec ±0.31% (96 runs sampled) ● expand - set (optimized for regex) braces x 321,844 ops/sec ±0.10% (97 runs sampled) minimatch x 140,600 ops/sec ±0.15% (100 runs sampled) ● expand - nested sets (expanded) braces x 165,371 ops/sec ±0.42% (96 runs sampled) minimatch x 337,720 ops/sec ±0.28% (100 runs sampled) ● expand - nested sets (optimized for regex) braces x 242,948 ops/sec ±0.12% (99 runs sampled) minimatch x 87,403 ops/sec ±0.79% (96 runs sampled) ``` ## About
Contributing Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).
Running Tests Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command: ```sh $ npm install && npm test ```
Building docs _(This project's readme.md is generated by [verb](https://github.com/verbose/verb-generate-readme), please don't edit the readme directly. Any changes to the readme must be made in the [.verb.md](.verb.md) readme template.)_ To generate the readme, run the following command: ```sh $ npm install -g verbose/verb#dev verb-generate-readme && verb ```
### Contributors | **Commits** | **Contributor** | | ----------- | ------------------------------------------------------------- | | 197 | [jonschlinkert](https://github.com/jonschlinkert) | | 4 | [doowb](https://github.com/doowb) | | 1 | [es128](https://github.com/es128) | | 1 | [eush77](https://github.com/eush77) | | 1 | [hemanth](https://github.com/hemanth) | | 1 | [wtgtybhertgeghgtwtg](https://github.com/wtgtybhertgeghgtwtg) | ### Author **Jon Schlinkert** - [GitHub Profile](https://github.com/jonschlinkert) - [Twitter Profile](https://twitter.com/jonschlinkert) - [LinkedIn Profile](https://linkedin.com/in/jonschlinkert) ### License Copyright © 2019, [Jon Schlinkert](https://github.com/jonschlinkert). Released under the [MIT License](LICENSE). --- _This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.8.0, on April 08, 2019._ braces-3.0.3/bench/000077500000000000000000000000001462306110000140245ustar00rootroot00000000000000braces-3.0.3/bench/index.js000066400000000000000000000051111462306110000154670ustar00rootroot00000000000000'use strict'; const { Suite } = require('benchmark'); const colors = require('ansi-colors'); const argv = require('minimist')(process.argv.slice(2)); const minimatch = require('minimatch'); const braces = require('..'); /** * Setup */ const cycle = (e, newline) => { process.stdout.write(`\u001b[G ${e.target}${newline ? '\n' : ''}`); }; const bench = (name, options) => { const config = { name, ...options }; const suite = new Suite(config); const add = suite.add.bind(suite); suite.on('error', console.error); if (argv.run && !new RegExp(argv.run).test(name)) { suite.add = () => suite; return suite; } console.log(colors.green(`● ${config.name}`)); suite.add = (key, fn, opts) => { if (typeof fn !== 'function') opts = fn; add(key, { onCycle: e => cycle(e), onComplete: e => cycle(e, true), fn, ...opts }); return suite; }; return suite; }; const skip = () => {}; skip.add = () => skip; skip.run = () => skip; bench.skip = name => { console.log(colors.cyan('● ' + colors.unstyle(name) + ' (skipped)')); return skip; }; bench('expand - range (expanded)') .add(' braces', () => braces.expand('foo/{1..250}/bar')) .add('minimatch', () => minimatch.braceExpand('foo/{1..250}/bar')) .run(); bench('expand - range (optimized for regex)') .add(' braces', () => braces.compile('foo/{1..250}/bar')) .add('minimatch', () => minimatch.makeRe('foo/{1..250}/bar')) .run(); bench('expand - nested ranges (expanded)') .add(' braces', () => braces.expand('foo/{a,b,{1..250}}/bar')) .add('minimatch', () => minimatch.braceExpand('foo/{a,b,{1..250}}/bar')) .run(); bench('expand - nested ranges (optimized for regex)') .add(' braces', () => braces.compile('foo/{a,b,{1..250}}/bar')) .add('minimatch', () => minimatch.makeRe('foo/{a,b,{1..250}}/bar')) .run(); bench('expand - set (expanded)') .add(' braces', () => braces.expand('foo/{a,b,c}/bar')) .add('minimatch', () => minimatch.braceExpand('foo/{a,b,c}/bar')) .run(); bench('expand - set (optimized for regex)') .add(' braces', () => braces.compile('foo/{a,b,c,d,e}/bar')) .add('minimatch', () => minimatch.makeRe('foo/{a,b,c,d,e}/bar')) .run(); bench('expand - nested sets (expanded)') .add(' braces', () => braces.expand('foo/{a,b,{x,y,z}}/bar')) .add('minimatch', () => minimatch.braceExpand('foo/{a,b,{x,y,z}}/bar')) .run(); bench('expand - nested sets (optimized for regex)') .add(' braces', () => braces.compile('foo/{a,b,c,d,e,{x,y,z}}/bar')) .add('minimatch', () => minimatch.makeRe('foo/{a,b,c,d,e,{x,y,z}}/bar')) .run(); braces-3.0.3/bench/package.json000066400000000000000000000005471462306110000163200ustar00rootroot00000000000000{ "name": "picomatch-benchmarks", "version": "0.0.0", "private": true, "main": "index.js", "dependencies": { "ansi-colors": "^3.0.3", "benchmark": "^2.1.4", "minimatch": "^3.0.4", "minimist": "^1.2.0" }, "lintDeps": { "devDependencies": { "files": { "patterns": [ "*.js" ] } } } } braces-3.0.3/examples/000077500000000000000000000000001462306110000145635ustar00rootroot00000000000000braces-3.0.3/examples/compile.js000066400000000000000000000002621462306110000165510ustar00rootroot00000000000000'use strict'; const compile = require('../lib/compile'); const parse = require('../lib/parse'); console.log(compile(parse('{a,b,c}'))); console.log(compile(parse('{01..09}'))); braces-3.0.3/examples/expand.js000066400000000000000000000015031462306110000163770ustar00rootroot00000000000000 const colors = require('ansi-colors'); const color = (arr, c) => arr.map(s => c(s)).join(', '); const cp = require('child_process'); const braces = input => { return cp.execSync(`echo ${input}`).toString().trim().split(' '); }; // const fixture = '{a,{b,c},d}'; // const fixture = '{a,b}{c,d}{e,f}'; // const fixture = 'a/{b,c{x,y}d,e}/f'; // const fixture = '{{a,b}/i,j,k}'; // const fixture = '{c,d{e,f}g,h}'; // const fixture = '{{c,d{e,f}g,h}/i,j,k}'; // const fixture = '{a,b}/{c,d{e,f}g,h}'; // const fixture = '{{a,b}/{c,d{e,f}g,h}/i,j,k}'; // const fixture = '{x,y,{a,b,c\\}}'; const fixture = 'a{,b}c'; console.log(); console.log(' FIXTURE:', colors.magenta(fixture)); // console.log(' ACTUAL:', color(expand(parse(fixture)), colors.yellow)); console.log('EXPECTED:', color(braces(fixture), colors.blue)); console.log(); braces-3.0.3/examples/option-transform.js000066400000000000000000000010321462306110000204360ustar00rootroot00000000000000'use strict'; const braces = require('..'); const alpha = braces.expand('x/{a..e}/y', { transform(code, index) { // when non-numeric values are passed, "code" is a character code, return 'foo/' + String.fromCharCode(code) + '-' + index; } }); console.log(alpha); //=> [ 'x/foo/a-0/y', 'x/foo/b-1/y', 'x/foo/c-2/y', 'x/foo/d-3/y', 'x/foo/e-4/y' ] const numeric = braces.expand('{1..5}', { transform(value) { return 'foo/' + value * 2; } }); console.log(numeric); //=> [ 'foo/2', 'foo/4', 'foo/6', 'foo/8', 'foo/10' ] braces-3.0.3/examples/parse.js000066400000000000000000000014371462306110000162400ustar00rootroot00000000000000'use strict'; // const input = 'foo/{a,bar/{b,c},d}'; // const input = 'a/{b,c{x,y}}/d'; // const input = '{{x,y},/{b,c{x,y}d,e}/f}'; // const input = '{{a,b}/{b,c{x,y}d,e}/f,x,z}'; // const input = 'a/{b,c}/d'; // const ast = parse(input); // console.log(ast) // console.log(JSON.stringify(ast.queue)); // console.log('EXPECTED:', [ 'a/b/f', 'a/cxd/f', 'a/cyd/f', 'a/e/f' ]); // console.log(JSON.stringify(ast, null, 2)) // console.log(expand(ast)); // expand(ast); // const sets = parse('foo/{a/b,{c,d,{x..z},e},f}/bar'); // const sets = parse('{a,{c,d}'); // console.log(sets.nodes[2]); // console.log(compile(sets)); // const range = parse(']{a..e,z}'); // console.log(range.nodes[2]); // console.log(braces.expand(']{a..e,z}')) // console.log(compile(range)); // console.log(parse('[abc]')) braces-3.0.3/index.js000066400000000000000000000104341462306110000144140ustar00rootroot00000000000000'use strict'; const stringify = require('./lib/stringify'); const compile = require('./lib/compile'); const expand = require('./lib/expand'); const parse = require('./lib/parse'); /** * Expand the given pattern or create a regex-compatible string. * * ```js * const braces = require('braces'); * console.log(braces('{a,b,c}', { compile: true })); //=> ['(a|b|c)'] * console.log(braces('{a,b,c}')); //=> ['a', 'b', 'c'] * ``` * @param {String} `str` * @param {Object} `options` * @return {String} * @api public */ const braces = (input, options = {}) => { let output = []; if (Array.isArray(input)) { for (const pattern of input) { const result = braces.create(pattern, options); if (Array.isArray(result)) { output.push(...result); } else { output.push(result); } } } else { output = [].concat(braces.create(input, options)); } if (options && options.expand === true && options.nodupes === true) { output = [...new Set(output)]; } return output; }; /** * Parse the given `str` with the given `options`. * * ```js * // braces.parse(pattern, [, options]); * const ast = braces.parse('a/{b,c}/d'); * console.log(ast); * ``` * @param {String} pattern Brace pattern to parse * @param {Object} options * @return {Object} Returns an AST * @api public */ braces.parse = (input, options = {}) => parse(input, options); /** * Creates a braces string from an AST, or an AST node. * * ```js * const braces = require('braces'); * let ast = braces.parse('foo/{a,b}/bar'); * console.log(stringify(ast.nodes[2])); //=> '{a,b}' * ``` * @param {String} `input` Brace pattern or AST. * @param {Object} `options` * @return {Array} Returns an array of expanded values. * @api public */ braces.stringify = (input, options = {}) => { if (typeof input === 'string') { return stringify(braces.parse(input, options), options); } return stringify(input, options); }; /** * Compiles a brace pattern into a regex-compatible, optimized string. * This method is called by the main [braces](#braces) function by default. * * ```js * const braces = require('braces'); * console.log(braces.compile('a/{b,c}/d')); * //=> ['a/(b|c)/d'] * ``` * @param {String} `input` Brace pattern or AST. * @param {Object} `options` * @return {Array} Returns an array of expanded values. * @api public */ braces.compile = (input, options = {}) => { if (typeof input === 'string') { input = braces.parse(input, options); } return compile(input, options); }; /** * Expands a brace pattern into an array. This method is called by the * main [braces](#braces) function when `options.expand` is true. Before * using this method it's recommended that you read the [performance notes](#performance)) * and advantages of using [.compile](#compile) instead. * * ```js * const braces = require('braces'); * console.log(braces.expand('a/{b,c}/d')); * //=> ['a/b/d', 'a/c/d']; * ``` * @param {String} `pattern` Brace pattern * @param {Object} `options` * @return {Array} Returns an array of expanded values. * @api public */ braces.expand = (input, options = {}) => { if (typeof input === 'string') { input = braces.parse(input, options); } let result = expand(input, options); // filter out empty strings if specified if (options.noempty === true) { result = result.filter(Boolean); } // filter out duplicates if specified if (options.nodupes === true) { result = [...new Set(result)]; } return result; }; /** * Processes a brace pattern and returns either an expanded array * (if `options.expand` is true), a highly optimized regex-compatible string. * This method is called by the main [braces](#braces) function. * * ```js * const braces = require('braces'); * console.log(braces.create('user-{200..300}/project-{a,b,c}-{1..10}')) * //=> 'user-(20[0-9]|2[1-9][0-9]|300)/project-(a|b|c)-([1-9]|10)' * ``` * @param {String} `pattern` Brace pattern * @param {Object} `options` * @return {Array} Returns an array of expanded values. * @api public */ braces.create = (input, options = {}) => { if (input === '' || input.length < 3) { return [input]; } return options.expand !== true ? braces.compile(input, options) : braces.expand(input, options); }; /** * Expose "braces" */ module.exports = braces; braces-3.0.3/lib/000077500000000000000000000000001462306110000135135ustar00rootroot00000000000000braces-3.0.3/lib/compile.js000066400000000000000000000027351462306110000155100ustar00rootroot00000000000000'use strict'; const fill = require('fill-range'); const utils = require('./utils'); const compile = (ast, options = {}) => { const walk = (node, parent = {}) => { const invalidBlock = utils.isInvalidBrace(parent); const invalidNode = node.invalid === true && options.escapeInvalid === true; const invalid = invalidBlock === true || invalidNode === true; const prefix = options.escapeInvalid === true ? '\\' : ''; let output = ''; if (node.isOpen === true) { return prefix + node.value; } if (node.isClose === true) { console.log('node.isClose', prefix, node.value); return prefix + node.value; } if (node.type === 'open') { return invalid ? prefix + node.value : '('; } if (node.type === 'close') { return invalid ? prefix + node.value : ')'; } if (node.type === 'comma') { return node.prev.type === 'comma' ? '' : invalid ? node.value : '|'; } if (node.value) { return node.value; } if (node.nodes && node.ranges > 0) { const args = utils.reduce(node.nodes); const range = fill(...args, { ...options, wrap: false, toRegex: true, strictZeros: true }); if (range.length !== 0) { return args.length > 1 && range.length > 1 ? `(${range})` : range; } } if (node.nodes) { for (const child of node.nodes) { output += walk(child, node); } } return output; }; return walk(ast); }; module.exports = compile; braces-3.0.3/lib/constants.js000066400000000000000000000030651462306110000160710ustar00rootroot00000000000000'use strict'; module.exports = { MAX_LENGTH: 10000, // Digits CHAR_0: '0', /* 0 */ CHAR_9: '9', /* 9 */ // Alphabet chars. CHAR_UPPERCASE_A: 'A', /* A */ CHAR_LOWERCASE_A: 'a', /* a */ CHAR_UPPERCASE_Z: 'Z', /* Z */ CHAR_LOWERCASE_Z: 'z', /* z */ CHAR_LEFT_PARENTHESES: '(', /* ( */ CHAR_RIGHT_PARENTHESES: ')', /* ) */ CHAR_ASTERISK: '*', /* * */ // Non-alphabetic chars. CHAR_AMPERSAND: '&', /* & */ CHAR_AT: '@', /* @ */ CHAR_BACKSLASH: '\\', /* \ */ CHAR_BACKTICK: '`', /* ` */ CHAR_CARRIAGE_RETURN: '\r', /* \r */ CHAR_CIRCUMFLEX_ACCENT: '^', /* ^ */ CHAR_COLON: ':', /* : */ CHAR_COMMA: ',', /* , */ CHAR_DOLLAR: '$', /* . */ CHAR_DOT: '.', /* . */ CHAR_DOUBLE_QUOTE: '"', /* " */ CHAR_EQUAL: '=', /* = */ CHAR_EXCLAMATION_MARK: '!', /* ! */ CHAR_FORM_FEED: '\f', /* \f */ CHAR_FORWARD_SLASH: '/', /* / */ CHAR_HASH: '#', /* # */ CHAR_HYPHEN_MINUS: '-', /* - */ CHAR_LEFT_ANGLE_BRACKET: '<', /* < */ CHAR_LEFT_CURLY_BRACE: '{', /* { */ CHAR_LEFT_SQUARE_BRACKET: '[', /* [ */ CHAR_LINE_FEED: '\n', /* \n */ CHAR_NO_BREAK_SPACE: '\u00A0', /* \u00A0 */ CHAR_PERCENT: '%', /* % */ CHAR_PLUS: '+', /* + */ CHAR_QUESTION_MARK: '?', /* ? */ CHAR_RIGHT_ANGLE_BRACKET: '>', /* > */ CHAR_RIGHT_CURLY_BRACE: '}', /* } */ CHAR_RIGHT_SQUARE_BRACKET: ']', /* ] */ CHAR_SEMICOLON: ';', /* ; */ CHAR_SINGLE_QUOTE: '\'', /* ' */ CHAR_SPACE: ' ', /* */ CHAR_TAB: '\t', /* \t */ CHAR_UNDERSCORE: '_', /* _ */ CHAR_VERTICAL_LINE: '|', /* | */ CHAR_ZERO_WIDTH_NOBREAK_SPACE: '\uFEFF' /* \uFEFF */ }; braces-3.0.3/lib/expand.js000066400000000000000000000053551462306110000153400ustar00rootroot00000000000000'use strict'; const fill = require('fill-range'); const stringify = require('./stringify'); const utils = require('./utils'); const append = (queue = '', stash = '', enclose = false) => { const result = []; queue = [].concat(queue); stash = [].concat(stash); if (!stash.length) return queue; if (!queue.length) { return enclose ? utils.flatten(stash).map(ele => `{${ele}}`) : stash; } for (const item of queue) { if (Array.isArray(item)) { for (const value of item) { result.push(append(value, stash, enclose)); } } else { for (let ele of stash) { if (enclose === true && typeof ele === 'string') ele = `{${ele}}`; result.push(Array.isArray(ele) ? append(item, ele, enclose) : item + ele); } } } return utils.flatten(result); }; const expand = (ast, options = {}) => { const rangeLimit = options.rangeLimit === undefined ? 1000 : options.rangeLimit; const walk = (node, parent = {}) => { node.queue = []; let p = parent; let q = parent.queue; while (p.type !== 'brace' && p.type !== 'root' && p.parent) { p = p.parent; q = p.queue; } if (node.invalid || node.dollar) { q.push(append(q.pop(), stringify(node, options))); return; } if (node.type === 'brace' && node.invalid !== true && node.nodes.length === 2) { q.push(append(q.pop(), ['{}'])); return; } if (node.nodes && node.ranges > 0) { const args = utils.reduce(node.nodes); if (utils.exceedsLimit(...args, options.step, rangeLimit)) { throw new RangeError('expanded array length exceeds range limit. Use options.rangeLimit to increase or disable the limit.'); } let range = fill(...args, options); if (range.length === 0) { range = stringify(node, options); } q.push(append(q.pop(), range)); node.nodes = []; return; } const enclose = utils.encloseBrace(node); let queue = node.queue; let block = node; while (block.type !== 'brace' && block.type !== 'root' && block.parent) { block = block.parent; queue = block.queue; } for (let i = 0; i < node.nodes.length; i++) { const child = node.nodes[i]; if (child.type === 'comma' && node.type === 'brace') { if (i === 1) queue.push(''); queue.push(''); continue; } if (child.type === 'close') { q.push(append(q.pop(), queue, enclose)); continue; } if (child.value && child.type !== 'open') { queue.push(append(queue.pop(), child.value)); continue; } if (child.nodes) { walk(child, node); } } return queue; }; return utils.flatten(walk(ast)); }; module.exports = expand; braces-3.0.3/lib/parse.js000066400000000000000000000153631462306110000151730ustar00rootroot00000000000000'use strict'; const stringify = require('./stringify'); /** * Constants */ const { MAX_LENGTH, CHAR_BACKSLASH, /* \ */ CHAR_BACKTICK, /* ` */ CHAR_COMMA, /* , */ CHAR_DOT, /* . */ CHAR_LEFT_PARENTHESES, /* ( */ CHAR_RIGHT_PARENTHESES, /* ) */ CHAR_LEFT_CURLY_BRACE, /* { */ CHAR_RIGHT_CURLY_BRACE, /* } */ CHAR_LEFT_SQUARE_BRACKET, /* [ */ CHAR_RIGHT_SQUARE_BRACKET, /* ] */ CHAR_DOUBLE_QUOTE, /* " */ CHAR_SINGLE_QUOTE, /* ' */ CHAR_NO_BREAK_SPACE, CHAR_ZERO_WIDTH_NOBREAK_SPACE } = require('./constants'); /** * parse */ const parse = (input, options = {}) => { if (typeof input !== 'string') { throw new TypeError('Expected a string'); } const opts = options || {}; const max = typeof opts.maxLength === 'number' ? Math.min(MAX_LENGTH, opts.maxLength) : MAX_LENGTH; if (input.length > max) { throw new SyntaxError(`Input length (${input.length}), exceeds max characters (${max})`); } const ast = { type: 'root', input, nodes: [] }; const stack = [ast]; let block = ast; let prev = ast; let brackets = 0; const length = input.length; let index = 0; let depth = 0; let value; /** * Helpers */ const advance = () => input[index++]; const push = node => { if (node.type === 'text' && prev.type === 'dot') { prev.type = 'text'; } if (prev && prev.type === 'text' && node.type === 'text') { prev.value += node.value; return; } block.nodes.push(node); node.parent = block; node.prev = prev; prev = node; return node; }; push({ type: 'bos' }); while (index < length) { block = stack[stack.length - 1]; value = advance(); /** * Invalid chars */ if (value === CHAR_ZERO_WIDTH_NOBREAK_SPACE || value === CHAR_NO_BREAK_SPACE) { continue; } /** * Escaped chars */ if (value === CHAR_BACKSLASH) { push({ type: 'text', value: (options.keepEscaping ? value : '') + advance() }); continue; } /** * Right square bracket (literal): ']' */ if (value === CHAR_RIGHT_SQUARE_BRACKET) { push({ type: 'text', value: '\\' + value }); continue; } /** * Left square bracket: '[' */ if (value === CHAR_LEFT_SQUARE_BRACKET) { brackets++; let next; while (index < length && (next = advance())) { value += next; if (next === CHAR_LEFT_SQUARE_BRACKET) { brackets++; continue; } if (next === CHAR_BACKSLASH) { value += advance(); continue; } if (next === CHAR_RIGHT_SQUARE_BRACKET) { brackets--; if (brackets === 0) { break; } } } push({ type: 'text', value }); continue; } /** * Parentheses */ if (value === CHAR_LEFT_PARENTHESES) { block = push({ type: 'paren', nodes: [] }); stack.push(block); push({ type: 'text', value }); continue; } if (value === CHAR_RIGHT_PARENTHESES) { if (block.type !== 'paren') { push({ type: 'text', value }); continue; } block = stack.pop(); push({ type: 'text', value }); block = stack[stack.length - 1]; continue; } /** * Quotes: '|"|` */ if (value === CHAR_DOUBLE_QUOTE || value === CHAR_SINGLE_QUOTE || value === CHAR_BACKTICK) { const open = value; let next; if (options.keepQuotes !== true) { value = ''; } while (index < length && (next = advance())) { if (next === CHAR_BACKSLASH) { value += next + advance(); continue; } if (next === open) { if (options.keepQuotes === true) value += next; break; } value += next; } push({ type: 'text', value }); continue; } /** * Left curly brace: '{' */ if (value === CHAR_LEFT_CURLY_BRACE) { depth++; const dollar = prev.value && prev.value.slice(-1) === '$' || block.dollar === true; const brace = { type: 'brace', open: true, close: false, dollar, depth, commas: 0, ranges: 0, nodes: [] }; block = push(brace); stack.push(block); push({ type: 'open', value }); continue; } /** * Right curly brace: '}' */ if (value === CHAR_RIGHT_CURLY_BRACE) { if (block.type !== 'brace') { push({ type: 'text', value }); continue; } const type = 'close'; block = stack.pop(); block.close = true; push({ type, value }); depth--; block = stack[stack.length - 1]; continue; } /** * Comma: ',' */ if (value === CHAR_COMMA && depth > 0) { if (block.ranges > 0) { block.ranges = 0; const open = block.nodes.shift(); block.nodes = [open, { type: 'text', value: stringify(block) }]; } push({ type: 'comma', value }); block.commas++; continue; } /** * Dot: '.' */ if (value === CHAR_DOT && depth > 0 && block.commas === 0) { const siblings = block.nodes; if (depth === 0 || siblings.length === 0) { push({ type: 'text', value }); continue; } if (prev.type === 'dot') { block.range = []; prev.value += value; prev.type = 'range'; if (block.nodes.length !== 3 && block.nodes.length !== 5) { block.invalid = true; block.ranges = 0; prev.type = 'text'; continue; } block.ranges++; block.args = []; continue; } if (prev.type === 'range') { siblings.pop(); const before = siblings[siblings.length - 1]; before.value += prev.value + value; prev = before; block.ranges--; continue; } push({ type: 'dot', value }); continue; } /** * Text */ push({ type: 'text', value }); } // Mark imbalanced braces and brackets as invalid do { block = stack.pop(); if (block.type !== 'root') { block.nodes.forEach(node => { if (!node.nodes) { if (node.type === 'open') node.isOpen = true; if (node.type === 'close') node.isClose = true; if (!node.nodes) node.type = 'text'; node.invalid = true; } }); // get the location of the block on parent.nodes (block's siblings) const parent = stack[stack.length - 1]; const index = parent.nodes.indexOf(block); // replace the (invalid) block with it's nodes parent.nodes.splice(index, 1, ...block.nodes); } } while (stack.length > 0); push({ type: 'eos' }); return ast; }; module.exports = parse; braces-3.0.3/lib/stringify.js000066400000000000000000000013041462306110000160650ustar00rootroot00000000000000'use strict'; const utils = require('./utils'); module.exports = (ast, options = {}) => { const stringify = (node, parent = {}) => { const invalidBlock = options.escapeInvalid && utils.isInvalidBrace(parent); const invalidNode = node.invalid === true && options.escapeInvalid === true; let output = ''; if (node.value) { if ((invalidBlock || invalidNode) && utils.isOpenOrClose(node)) { return '\\' + node.value; } return node.value; } if (node.value) { return node.value; } if (node.nodes) { for (const child of node.nodes) { output += stringify(child); } } return output; }; return stringify(ast); }; braces-3.0.3/lib/utils.js000066400000000000000000000047261462306110000152220ustar00rootroot00000000000000'use strict'; exports.isInteger = num => { if (typeof num === 'number') { return Number.isInteger(num); } if (typeof num === 'string' && num.trim() !== '') { return Number.isInteger(Number(num)); } return false; }; /** * Find a node of the given type */ exports.find = (node, type) => node.nodes.find(node => node.type === type); /** * Find a node of the given type */ exports.exceedsLimit = (min, max, step = 1, limit) => { if (limit === false) return false; if (!exports.isInteger(min) || !exports.isInteger(max)) return false; return ((Number(max) - Number(min)) / Number(step)) >= limit; }; /** * Escape the given node with '\\' before node.value */ exports.escapeNode = (block, n = 0, type) => { const node = block.nodes[n]; if (!node) return; if ((type && node.type === type) || node.type === 'open' || node.type === 'close') { if (node.escaped !== true) { node.value = '\\' + node.value; node.escaped = true; } } }; /** * Returns true if the given brace node should be enclosed in literal braces */ exports.encloseBrace = node => { if (node.type !== 'brace') return false; if ((node.commas >> 0 + node.ranges >> 0) === 0) { node.invalid = true; return true; } return false; }; /** * Returns true if a brace node is invalid. */ exports.isInvalidBrace = block => { if (block.type !== 'brace') return false; if (block.invalid === true || block.dollar) return true; if ((block.commas >> 0 + block.ranges >> 0) === 0) { block.invalid = true; return true; } if (block.open !== true || block.close !== true) { block.invalid = true; return true; } return false; }; /** * Returns true if a node is an open or close node */ exports.isOpenOrClose = node => { if (node.type === 'open' || node.type === 'close') { return true; } return node.open === true || node.close === true; }; /** * Reduce an array of text nodes. */ exports.reduce = nodes => nodes.reduce((acc, node) => { if (node.type === 'text') acc.push(node.value); if (node.type === 'range') node.type = 'text'; return acc; }, []); /** * Flatten an array */ exports.flatten = (...args) => { const result = []; const flat = arr => { for (let i = 0; i < arr.length; i++) { const ele = arr[i]; if (Array.isArray(ele)) { flat(ele); continue; } if (ele !== undefined) { result.push(ele); } } return result; }; flat(args); return result; }; braces-3.0.3/package.json000066400000000000000000000031571462306110000152410ustar00rootroot00000000000000{ "name": "braces", "description": "Bash-like brace expansion, implemented in JavaScript. Safer than other brace expansion libs, with complete support for the Bash 4.3 braces specification, without sacrificing speed.", "version": "3.0.3", "homepage": "https://github.com/micromatch/braces", "author": "Jon Schlinkert (https://github.com/jonschlinkert)", "contributors": [ "Brian Woodward (https://twitter.com/doowb)", "Elan Shanker (https://github.com/es128)", "Eugene Sharygin (https://github.com/eush77)", "hemanth.hm (http://h3manth.com)", "Jon Schlinkert (http://twitter.com/jonschlinkert)" ], "repository": "micromatch/braces", "bugs": { "url": "https://github.com/micromatch/braces/issues" }, "license": "MIT", "files": [ "index.js", "lib" ], "main": "index.js", "engines": { "node": ">=8" }, "scripts": { "test": "mocha", "benchmark": "node benchmark" }, "dependencies": { "fill-range": "^7.1.1" }, "devDependencies": { "ansi-colors": "^3.2.4", "bash-path": "^2.0.1", "gulp-format-md": "^2.0.0", "mocha": "^6.1.1" }, "keywords": [ "alpha", "alphabetical", "bash", "brace", "braces", "expand", "expansion", "filepath", "fill", "fs", "glob", "globbing", "letter", "match", "matches", "matching", "number", "numerical", "path", "range", "ranges", "sh" ], "verb": { "toc": false, "layout": "default", "tasks": [ "readme" ], "lint": { "reflinks": true }, "plugins": [ "gulp-format-md" ] } } braces-3.0.3/test/000077500000000000000000000000001462306110000137245ustar00rootroot00000000000000braces-3.0.3/test/bash-compiled-ranges.js000066400000000000000000000165361462306110000202610ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const bashPath = require('bash-path'); const cp = require('child_process'); const braces = require('..'); const bash = input => { return cp.spawnSync(bashPath(), ['-c', `echo ${input}`]) .stdout.toString() .split(/\s+/) .filter(Boolean); }; const equal = (input, expected = bash(input), options) => { assert.deepEqual(braces.compile(input, options), expected); }; /** * Bash 4.3 unit tests with `braces.compile()` */ describe('bash ranges - braces.compile()', () => { const fixtures = [ ['a{b,c{1..100}/{foo,bar}/,h}x/z', {}, 'a(b|c([1-9]|[1-9][0-9]|100)/(foo|bar)/|h)x/z'], ['0{1..9} {10..20}', {}, '0([1-9]) (1[0-9]|20)'], // should not try to expand ranges with decimals ['{1.1..2.1}', {}, '{1.1..2.1}'], ['{1.1..~2.1}', {}, '{1.1..~2.1}'], // should escape invalid ranges ['{1..0f}', {}, '{1..0f}'], ['{1..10..ff}', {}, '{1..10..ff}'], ['{1..10.f}', {}, '{1..10.f}'], ['{1..10f}', {}, '{1..10f}'], ['{1..20..2f}', {}, '{1..20..2f}'], ['{1..20..f2}', {}, '{1..20..f2}'], ['{1..2f..2}', {}, '{1..2f..2}'], ['{1..ff..2}', {}, '{1..ff..2}'], ['{1..ff}', {}, '{1..ff}'], ['{1.20..2}', {}, '{1.20..2}'], // should handle weirdly-formed brace expansions (fixed in post-bash-3.1) ['a-{b{d,e}}-c', {}, 'a-{b(d|e)}-c'], ['a-{bdef-{g,i}-c', {}, 'a-{bdef-(g|i)-c'], // should not expand quoted strings ['{"klklkl"}{1,2,3}', {}, '{klklkl}(1|2|3)'], ['{"x,x"}', {}, '{x,x}'], // should escaped outer braces in nested non-sets ['{a-{b,c,d}}', {}, '{a-(b|c|d)}'], ['{a,{a-{b,c,d}}}', {}, '(a|{a-(b|c|d)})'], // should escape imbalanced braces ['abc{', {}, 'abc{'], ['{abc{', {}, '{abc{'], ['{abc', {}, '{abc'], ['}abc', {}, '}abc'], ['ab{c', {}, 'ab{c'], ['{{a,b}', {}, '{(a|b)'], ['{a,b}}', {}, '(a|b)}'], ['abcd{efgh', {}, 'abcd{efgh'], ['a{b{c{d,e}f}gh', {}, 'a{b{c(d|e)f}gh'], ['a{b{c{d,e}f}g}h', {}, 'a{b{c(d|e)f}g}h'], ['f{x,y{{g,z}}h}', {}, 'f(x|y{(g|z)}h)'], ['z{a,b},c}d', {}, 'z(a|b),c}d'], ['a{b{c{d,e}f{x,y{{g}h', {}, 'a{b{c(d|e)f{x,y{{g}h'], ['f{x,y{{g}h', {}, 'f{x,y{{g}h'], ['f{x,y{{g}}h', {}, 'f{x,y{{g}}h'], ['a{b{c{d,e}f{x,y{}g}h', {}, 'a{b{c(d|e)f(x|y{}g)h'], ['f{x,y{}g}h', {}, 'f(x|y{}g)h'], ['z{a,b{,c}d', {}, 'z{a,b(|c)d'], // should expand numeric ranges ['a{0..3}d', {}, 'a([0-3])d'], ['x{10..1}y', {}, 'x([1-9]|10)y'], ['x{3..3}y', {}, 'x3y'], ['{1..10}', {}, '([1-9]|10)'], ['{1..3}', {}, '([1-3])'], ['{1..9}', {}, '([1-9])'], ['{10..1}', {}, '([1-9]|10)'], ['{10..1}y', {}, '([1-9]|10)y'], ['{3..3}', {}, '3'], ['{5..8}', {}, '([5-8])'], // should expand ranges with negative numbers ['{-10..-1}', {}, '(-[1-9]|-10)'], ['{-20..0}', {}, '(-[1-9]|-1[0-9]|-20|0)'], ['{0..-5}', {}, '(-[1-5]|0)'], ['{9..-4}', {}, '(-[1-4]|[0-9])'], // should expand alphabetical ranges ['0{1..9}/{10..20}', {}, '0([1-9])/(1[0-9]|20)'], ['0{a..d}0', {}, '0([a-d])0'], ['a/{b..d}/e', {}, 'a/([b-d])/e'], ['{1..f}', {}, '([1-f])'], ['{a..A}', {}, '([A-a])'], ['{A..a}', {}, '([A-a])'], ['{a..e}', {}, '([a-e])'], ['{A..E}', {}, '([A-E])'], ['{a..f}', {}, '([a-f])'], ['{a..z}', {}, '([a-z])'], ['{E..A}', {}, '([A-E])'], ['{f..1}', {}, '([1-f])'], ['{f..a}', {}, '([a-f])'], ['{f..f}', {}, 'f'], // should expand multiple ranges ['a/{b..d}/e/{f..h}', {}, 'a/([b-d])/e/([f-h])'], // should expand numerical ranges - positive and negative ['{-10..10}', {}, '(-[1-9]|-?10|[0-9])'], // HEADS UP! If you're using the `--mm` flag minimatch freezes on these // should expand large numbers ['{2147483645..2147483649}', {}, '(214748364[5-9])'], ['{214748364..2147483649}', {}, '(21474836[4-9]|2147483[7-9][0-9]|214748[4-9][0-9]{2}|214749[0-9]{3}|2147[5-9][0-9]{4}|214[89][0-9]{5}|21[5-9][0-9]{6}|2[2-9][0-9]{7}|[3-9][0-9]{8}|1[0-9]{9}|20[0-9]{8}|21[0-3][0-9]{7}|214[0-6][0-9]{6}|2147[0-3][0-9]{5}|21474[0-7][0-9]{4}|214748[0-2][0-9]{3}|2147483[0-5][0-9]{2}|21474836[0-4][0-9])'], // should expand ranges using steps ['{1..10..1}', { bash: false }, '([1-9]|10)'], ['{1..10..2}', { bash: false }, '(1|3|5|7|9)'], ['{1..20..20}', { bash: false }, '1'], ['{1..20..2}', { bash: false }, '(1|3|5|7|9|11|13|15|17|19)'], ['{10..1..2}', { bash: false }, '(2|4|6|8|10)'], ['{100..0..5}', { bash: false }, '(0|5|10|15|20|25|30|35|40|45|50|55|60|65|70|75|80|85|90|95|100)'], ['{2..10..1}', { bash: false }, '([2-9]|10)'], ['{2..10..2}', { bash: false }, '(2|4|6|8|10)'], ['{2..10..3}', { bash: false }, '(2|5|8)'], // should expand negative ranges using steps ['{-1..-10..-2}', { bash: false }, '(-(?:1|3|5|7|9))'], ['{-1..-10..2}', { bash: false }, '(-(?:1|3|5|7|9))'], ['{-10..-2..2}', { bash: false }, '(-(?:2|4|6|8|10))'], ['{-2..-10..1}', { bash: false }, '(-[2-9]|-10)'], ['{-2..-10..2}', { bash: false }, '(-(?:2|4|6|8|10))'], ['{-2..-10..3}', { bash: false }, '(-(?:2|5|8))'], ['{-9..9..3}', { bash: false }, '(0|3|6|9|-(?:3|6|9))'], ['{10..1..-2}', { bash: false }, '(2|4|6|8|10)'], ['{100..0..-5}', { bash: false }, '(0|5|10|15|20|25|30|35|40|45|50|55|60|65|70|75|80|85|90|95|100)'], // should expand alpha ranges with steps ['{a..e..2}', { bash: false }, '(a|c|e)'], ['{E..A..2}', { bash: false }, '(E|C|A)'], ['{a..z..2}', { bash: false }, '(a|c|e|g|i|k|m|o|q|s|u|w|y)'], // should expand alpha ranges with negative steps ['{z..a..-2}', { bash: false }, '(z|x|v|t|r|p|n|l|j|h|f|d|b)'], // unwanted zero-padding (fixed post-bash-4.0) ['{10..0..2}', { bash: false }, '(0|2|4|6|8|10)'], ['{10..0..-2}', { bash: false }, '(0|2|4|6|8|10)'], ['{-50..-0..5}', { bash: false }, '(0|-(?:5|10|15|20|25|30|35|40|45|50))'], // should work with dots in file paths ['../{1..3}/../foo', {}, '../([1-3])/../foo'], ['../{2..10..2}/../foo', {}, '../(2|4|6|8|10)/../foo'], ['../{1..3}/../{a,b,c}/foo', {}, '../([1-3])/../(a|b|c)/foo'], ['./{a..z..3}/', {}, './(a|d|g|j|m|p|s|v|y)/'], ['./{"x,y"}/{a..z..3}/', { keepQuotes: true }, './{"x,y"}/(a|d|g|j|m|p|s|v|y)/'], // should expand a complex combination of ranges and sets ['a/{x,y}/{1..5}c{d,e}f.{md,txt}', {}, 'a/(x|y)/([1-5])c(d|e)f.(md|txt)'], // should expand complex sets and ranges in `bash` mode ['a/{x,{1..5},y}/c{d}e', {}, 'a/(x|([1-5])|y)/c{d}e'], // should treat glob characters as literal ['**/{1..5}/a.js', {}, '**/([1-5])/a.js'], ['x{{0..10},braces}y', {}, 'x(([0-9]|10)|braces)y'], // should handle sets with invalid ranges ['{0..10,braces}', {}, '(0..10|braces)'], ['{1..10,braces}', {}, '(1..10|braces)'], ['./\\{x,y}/{a..z..3}/', {}, './{x,y}/(a|d|g|j|m|p|s|v|y)/'], ['{braces,{0..10}}', {}, '(braces|([0-9]|10))'], ['{{0..10},braces}', {}, '(([0-9]|10)|braces)'], ['{{1..10..2},braces}', { bash: false }, '((1|3|5|7|9)|braces)'], ['{{1..10..2},braces}', {}, '((1|3|5|7|9)|braces)'] ]; fixtures.forEach(arr => { if (typeof arr === 'string') { return; } const options = { ...arr[1] }; const pattern = arr[0]; const expected = arr[2]; if (options.skip === true) { return; } it('should compile: ' + pattern, () => { equal(pattern, expected, options); }); }); }); braces-3.0.3/test/bash-compiled-sets.js000066400000000000000000000157501462306110000177550ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const bashPath = require('bash-path'); const cp = require('child_process'); const braces = require('..'); const bash = input => { return cp.spawnSync(bashPath(), ['-c', `echo ${input}`]) .stdout.toString() .split(/\s+/) .filter(Boolean); }; const equal = (input, expected = bash(input), options) => { assert.deepEqual(braces.compile(input, options), expected); }; /** * Bash 4.3 unit tests with `braces.expand()` */ describe('bash sets - braces.compile()', () => { const fixtures = [ ['{a,b,c,d,e}', {}, '(a|b|c|d|e)'], ['a/\\{b,c,d,{x,y}}{e,f\\}/g', {}, 'a/{b,c,d,(x|y)}{e,f}/g'], ['a/\\{b,c,d\\}\\{e,f\\}/g', {}, 'a/{b,c,d}{e,f}/g'], ['a/\\{b,c,d\\}\\{e,f}/g', {}, 'a/{b,c,d}{e,f}/g'], ['a/\\{b,c,d\\}{e,f}/g', {}, 'a/{b,c,d}(e|f)/g'], ['a/\\{b,c,d{x,y}}{e,f\\}/g', {}, 'a/{b,c,d(x|y)}{e,f}/g'], ['a/\\{b,c,d}{e,f\\}/g', {}, 'a/{b,c,d}{e,f}/g'], ['a/\\{b,c,d}{e,f}/g', {}, 'a/{b,c,d}(e|f)/g'], ['a/\\{{b,c}{e,f}/g', {}, 'a/{(b|c)(e|f)/g'], ['a/\\{{b,c}{e,f}\\}/g', {}, 'a/{(b|c)(e|f)}/g'], ['a/\\{{b,c}{e,f}}/g', {}, 'a/{(b|c)(e|f)}/g'], ['a/b/{b,c,{d,e{f,g},{w,x}/{y,z}}}/h/i', {}, 'a/b/(b|c|(d|e(f|g)|(w|x)/(y|z)))/h/i'], ['a/{b,c}}{e,f}/g', {}, 'a/(b|c)}(e|f)/g'], ['a/{b,c\\,d}{e,f}/g', {}, 'a/(b|c,d)(e|f)/g'], ['a/{b,c\\}}{e,f}/g', {}, 'a/(b|c})(e|f)/g'], ['a/{b,c}', {}, 'a/(b|c)'], ['a/{b,c}d{e,f}/g', {}, 'a/(b|c)d(e|f)/g'], ['a/{b,c}{e,f}/g', {}, 'a/(b|c)(e|f)/g'], ['a/{b,c}{e,f}{g,h,i}/k', {}, 'a/(b|c)(e|f)(g|h|i)/k'], ['a/{b,{c,d},e}/f', {}, 'a/(b|(c|d)|e)/f'], ['a/{b,{c,d}/{e,f},g}/h', {}, 'a/(b|(c|d)/(e|f)|g)/h'], ['a/{b{c,d},e{f,g}h{i,j}}/k', {}, 'a/(b(c|d)|e(f|g)h(i|j))/k'], ['a/{b{c,d},e}/f', {}, 'a/(b(c|d)|e)/f'], ['a/{b{c,d}e{f,g}h{i,j}}/k', {}, 'a/{b(c|d)e(f|g)h(i|j)}/k'], ['a/{b{c,d}e{f,g},h{i,j}}/k', {}, 'a/(b(c|d)e(f|g)|h(i|j))/k'], ['a/{x,z}{b,{c,d}/{e,f},g}/h', {}, 'a/(x|z)(b|(c|d)/(e|f)|g)/h'], ['a/{{a,b}/{c,d}}/z', {}, 'a/{(a|b)/(c|d)}/z'], ['a/{{b,c}/{d,e}}', {}, 'a/{(b|c)/(d|e)}'], ['a/{{b,c}/{d,e}}/f', {}, 'a/{(b|c)/(d|e)}/f'], ['a{b{c{d,e}f{x,y{{g}h', {}, 'a{b{c(d|e)f{x,y{{g}h'], ['{a,b,{c,d},e}', {}, '(a|b|(c|d)|e)'], ['{a,b,{c,d}e}', {}, '(a|b|(c|d)e)'], ['{a,b,{c,d}}', {}, '(a|b|(c|d))'], ['{a,b{c,d}}', {}, '(a|b(c|d))'], ['{a,b}/{c,d}', {}, '(a|b)/(c|d)'], ['{a,b}{c,d}', {}, '(a|b)(c|d)'], ['{{a,b},{c,d}}', {}, '((a|b)|(c|d))'], ['{{a,b}/{c,d}}', {}, '{(a|b)/(c|d)}'], ['{{a,b}/{c,d}}/z', {}, '{(a|b)/(c|d)}/z'], // should not process glob characters ['{generate,{assemble,update,verb}{file,-generate-*},generator}.js', {}, '(generate|(assemble|update|verb)(file|-generate-*)|generator).js'], ['**/{foo,bar}.js', {}, '**/(foo|bar).js'], ['**/{a,b,c}/*.js', {}, '**/(a|b|c)/*.js'], ['**/{a,b,*}/*.js', {}, '**/(a|b|*)/*.js'], ['**/{**,b,*}/*.js', {}, '**/(**|b|*)/*.js'], // should not expand escaped braces ['\\{a,b,c,d,e}', {}, '{a,b,c,d,e}'], ['a/b/c/{x,y\\}', {}, 'a/b/c/{x,y}'], ['a/\\{x,y}/cde', {}, 'a/{x,y}/cde'], ['abcd{efgh', {}, 'abcd{efgh'], ['\\{abc\\}', {}, '{abc}'], ['{x,y,\\{a,b,c\\}}', {}, '(x|y|{a|b|c})'], ['{x,y,{a,b,c\\}}', {}, '{x,y,(a|b|c})'], ['{x,y,{abc},trie}', {}, '(x|y|{abc}|trie)'], ['x,y,{abc},trie', {}, 'x,y,{abc},trie'], ['{b{c,d},e}', {}, '(b(c|d)|e)'], ['{b{c,d},e}/f', {}, '(b(c|d)|e)/f'], ['{abc}', {}, '{abc}'], // should handle empty braces ['{ }', {}, '{ }'], ['{', {}, '{'], ['{}', {}, '{}'], ['}', {}, '}'], // should escape braces when only one value is defined ['a{b}c', {}, 'a{b}c'], ['a/b/c{d}e', {}, 'a/b/c{d}e'], // should escape closing braces when open is not defined ['{a,b}c,d}', {}, '(a|b)c,d}'], ['a,b,c,d}', {}, 'a,b,c,d}'], // should not expand braces in sets with es6/bash-like variables ['abc/${ddd}/xyz', {}, 'abc/${ddd}/xyz'], ['a${b}c', {}, 'a${b}c'], ['a${b{a,b}}c', {}, 'a${b{a,b}}c'], ['a/{${b},c}/d', {}, 'a/(${b}|c)/d'], ['a${b,d}/{foo,bar}c', {}, 'a${b,d}/(foo|bar)c'], // should not expand escaped commas ['a{b\\,c\\,d}e', {}, 'a{b,c,d}e'], ['a{b\\,c}d', {}, 'a{b,c}d'], ['{abc\\,def}', {}, '{abc,def}'], ['{abc\\,def,ghi}', {}, '(abc,def|ghi)'], ['a/{b,c}/{x\\,y}/d/e', {}, 'a/(b|c)/{x,y}/d/e'], // should not expand escaped braces ['{a,b\\}c,d}', {}, '(a|b}c|d)'], ['a/{z,\\{a,b,c,d,e}/d', {}, 'a/(z|{a|b|c|d|e)/d'], ['a/\\{b,c}/{d,e}/f', {}, 'a/{b,c}/(d|e)/f'], // should not expand escaped braces or commas ['{x\\,y,\\{abc\\},trie}', {}, '(x,y|{abc}|trie)'], // should support sequence brace operators ['ff{c,b,a}', {}, 'ff(c|b|a)'], ['f{d,e,f}g', {}, 'f(d|e|f)g'], ['{a,b,c}', {}, '(a|b|c)'], ['{l,n,m}xyz', {}, '(l|n|m)xyz'], // should expand multiple sets ['a/{a,b}/{c,d}/e', {}, 'a/(a|b)/(c|d)/e'], ['a{b,c}d{e,f}g', {}, 'a(b|c)d(e|f)g'], ['a/{x,y}/c{d,e}f.{md,txt}', {}, 'a/(x|y)/c(d|e)f.(md|txt)'], // should expand nested sets ['{a,b}{{a,b},a,b}', {}, '(a|b)((a|b)|a|b)'], ['/usr/{ucb/{ex,edit},lib/{ex,how_ex}}', {}, '/usr/(ucb/(ex|edit)|lib/(ex|how_ex))'], ['a{b,c{d,e}f}g', {}, 'a(b|c(d|e)f)g'], ['a{{x,y},z}b', {}, 'a((x|y)|z)b'], ['f{x,y{g,z}}h', {}, 'f(x|y(g|z))h'], ['a{b,c{d,e},h}x/z', {}, 'a(b|c(d|e)|h)x/z'], ['a{b,c{d,e},h}x{y,z}', {}, 'a(b|c(d|e)|h)x(y|z)'], ['a{b,c{d,e},{f,g}h}x{y,z}', {}, 'a(b|c(d|e)|(f|g)h)x(y|z)'], ['a-{b{d,e}}-c', {}, 'a-{b(d|e)}-c'], // should expand not modify non-brace characters ['a/b/{d,e}/*.js', {}, 'a/b/(d|e)/*.js'], ['a/**/c/{d,e}/f*.js', {}, 'a/**/c/(d|e)/f*.js'], ['a/**/c/{d,e}/f*.{md,txt}', {}, 'a/**/c/(d|e)/f*.(md|txt)'], // should work with leading and trailing commas ['a{b,}c', {}, 'a(b|)c'], ['a{,b}c', {}, 'a(|b)c'], // should handle spaces // Bash 4.3 says the this first one should be equivalent to `foo|(1|2)|bar // That makes sense in Bash, since ' ' is a separator, but not here. ['foo {1,2} bar', {}, 'foo (1|2) bar'], ['a{ ,c{d, },h}x', {}, 'a( |c(d| )|h)x'], ['a{ ,c{d, },h} ', {}, 'a( |c(d| )|h) '], // see https://github.com/jonschlinkert/microequal/issues/66 ['/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.{html,ejs}', {}, '/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.(html|ejs)'] ]; const seen = new Map(); const dupes = []; for (let i = 0; i < fixtures.length; i++) { const fixture = fixtures[i]; const key = fixture[0] + String(fixture[1].bash); if (seen.has(key)) { dupes.push(i + 21, fixture[0]); } else { seen.set(key, i + 21); } } fixtures.forEach(arr => { if (typeof arr === 'string') { return; } const options = { ...arr[1] }; const pattern = arr[0]; const expected = arr[2]; if (options.skip === true) { return; } it('should compile: ' + pattern, () => { equal(pattern, expected, options); }); }); }); braces-3.0.3/test/bash-expanded-ranges.js000066400000000000000000000560571462306110000202570ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const bashPath = require('bash-path'); const cp = require('child_process'); const braces = require('..'); const bash = input => { return cp.spawnSync(bashPath(), ['-c', `echo ${input}`]) .stdout.toString() .split(/\s+/) .filter(Boolean); }; const equal = (input, expected = bash(input), options) => { assert.deepEqual(braces.expand(input, options), expected); }; /** * Bash 4.3 unit tests with `braces.expand()` */ describe('bash - expanded brace ranges', () => { describe('large numbers', () => { it('should expand large numbers', () => { equal('{2147483645..2147483649}', ['2147483645', '2147483646', '2147483647', '2147483648', '2147483649']); }); it('should throw an error when range exceeds rangeLimit', () => { assert.throws(() => braces.expand('{214748364..2147483649}')); }); }); describe('escaping / invalid ranges', () => { it('should not try to expand ranges with decimals', () => { equal('{1.1..2.1}', ['{1.1..2.1}']); equal('{1.1..~2.1}', ['{1.1..~2.1}']); }); it('should escape invalid ranges:', () => { equal('{1..0f}', ['{1..0f}']); equal('{1..10..ff}', ['{1..10..ff}']); equal('{1..10.f}', ['{1..10.f}']); equal('{1..10f}', ['{1..10f}']); equal('{1..20..2f}', ['{1..20..2f}']); equal('{1..20..f2}', ['{1..20..f2}']); equal('{1..2f..2}', ['{1..2f..2}']); equal('{1..ff..2}', ['{1..ff..2}']); equal('{1..ff}', ['{1..ff}']); equal('{1.20..2}', ['{1.20..2}']); }); it('weirdly-formed brace expansions -- fixed in post-bash-3.1', () => { equal('a-{b{d,e}}-c', ['a-{bd}-c', 'a-{be}-c']); equal('a-{bdef-{g,i}-c', ['a-{bdef-g-c', 'a-{bdef-i-c']); }); it('should not expand quoted strings.', () => { equal('{"klklkl"}{1,2,3}', ['{klklkl}1', '{klklkl}2', '{klklkl}3']); equal('{"x,x"}', ['{x,x}']); }); it('should escaped outer braces in nested non-sets', () => { equal('{a-{b,c,d}}', ['{a-b}', '{a-c}', '{a-d}']); equal('{a,{a-{b,c,d}}}', ['a', '{a-b}', '{a-c}', '{a-d}']); }); it('should escape imbalanced braces', () => { equal('a-{bdef-{g,i}-c', ['a-{bdef-g-c', 'a-{bdef-i-c']); equal('abc{', ['abc{']); equal('{abc{', ['{abc{']); equal('{abc', ['{abc']); equal('}abc', ['}abc']); equal('ab{c', ['ab{c']); equal('ab{c', ['ab{c']); equal('{{a,b}', ['{a', '{b']); equal('{a,b}}', ['a}', 'b}']); equal('abcd{efgh', ['abcd{efgh']); equal('a{b{c{d,e}f}g}h', ['a{b{cdf}g}h', 'a{b{cef}g}h']); equal('f{x,y{{g,z}}h}', ['fx', 'fy{g}h', 'fy{z}h']); equal('z{a,b},c}d', ['za,c}d', 'zb,c}d']); equal('a{b{c{d,e}f{x,y{{g}h', ['a{b{cdf{x,y{{g}h', 'a{b{cef{x,y{{g}h']); equal('f{x,y{{g}h', ['f{x,y{{g}h']); equal('f{x,y{{g}}h', ['f{x,y{{g}}h']); equal('a{b{c{d,e}f{x,y{}g}h', ['a{b{cdfxh', 'a{b{cdfy{}gh', 'a{b{cefxh', 'a{b{cefy{}gh']); equal('f{x,y{}g}h', ['fxh', 'fy{}gh']); equal('z{a,b{,c}d', ['z{a,bd', 'z{a,bcd']); }); }); describe('positive numeric ranges', () => { it('should expand numeric ranges', () => { equal('a{0..3}d', ['a0d', 'a1d', 'a2d', 'a3d']); equal('x{10..1}y', ['x10y', 'x9y', 'x8y', 'x7y', 'x6y', 'x5y', 'x4y', 'x3y', 'x2y', 'x1y']); equal('x{3..3}y', ['x3y']); equal('{1..10}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{1..3}', ['1', '2', '3']); equal('{1..9}', ['1', '2', '3', '4', '5', '6', '7', '8', '9']); equal('{10..1}', ['10', '9', '8', '7', '6', '5', '4', '3', '2', '1']); equal('{10..1}y', ['10y', '9y', '8y', '7y', '6y', '5y', '4y', '3y', '2y', '1y']); equal('{3..3}', ['3']); equal('{5..8}', ['5', '6', '7', '8']); }); }); describe('negative ranges', () => { it('should expand ranges with negative numbers', () => { equal('{-10..-1}', ['-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1']); equal('{-20..0}', ['-20', '-19', '-18', '-17', '-16', '-15', '-14', '-13', '-12', '-11', '-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0']); equal('{0..-5}', ['0', '-1', '-2', '-3', '-4', '-5']); equal('{9..-4}', ['9', '8', '7', '6', '5', '4', '3', '2', '1', '0', '-1', '-2', '-3', '-4']); }); }); describe('alphabetical ranges', () => { it('should expand alphabetical ranges', () => { equal('{a..F}', ['a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F']); equal('0{a..d}0', ['0a0', '0b0', '0c0', '0d0']); equal('a/{b..d}/e', ['a/b/e', 'a/c/e', 'a/d/e']); equal('{1..f}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f']); equal('{a..A}', ['a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A']); equal('{A..a}', ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a']); equal('{a..e}', ['a', 'b', 'c', 'd', 'e']); equal('{A..E}', ['A', 'B', 'C', 'D', 'E']); equal('{a..f}', ['a', 'b', 'c', 'd', 'e', 'f']); equal('{a..z}', ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']); equal('{E..A}', ['E', 'D', 'C', 'B', 'A']); equal('{f..1}', ['f', 'e', 'd', 'c', 'b', 'a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A', '@', '?', '>', '=', '<', ';', ':', '9', '8', '7', '6', '5', '4', '3', '2', '1']); equal('{f..a}', ['f', 'e', 'd', 'c', 'b', 'a']); equal('{f..f}', ['f']); }); it('should expand multiple ranges:', () => { equal('a/{b..d}/e/{f..h}', ['a/b/e/f', 'a/b/e/g', 'a/b/e/h', 'a/c/e/f', 'a/c/e/g', 'a/c/e/h', 'a/d/e/f', 'a/d/e/g', 'a/d/e/h']); }); }); describe('combo', () => { it('should expand numerical ranges - positive and negative', () => { equal('a{01..05}b', ['a01b', 'a02b', 'a03b', 'a04b', 'a05b']); equal('0{1..9}/{10..20}', ['01/10', '01/11', '01/12', '01/13', '01/14', '01/15', '01/16', '01/17', '01/18', '01/19', '01/20', '02/10', '02/11', '02/12', '02/13', '02/14', '02/15', '02/16', '02/17', '02/18', '02/19', '02/20', '03/10', '03/11', '03/12', '03/13', '03/14', '03/15', '03/16', '03/17', '03/18', '03/19', '03/20', '04/10', '04/11', '04/12', '04/13', '04/14', '04/15', '04/16', '04/17', '04/18', '04/19', '04/20', '05/10', '05/11', '05/12', '05/13', '05/14', '05/15', '05/16', '05/17', '05/18', '05/19', '05/20', '06/10', '06/11', '06/12', '06/13', '06/14', '06/15', '06/16', '06/17', '06/18', '06/19', '06/20', '07/10', '07/11', '07/12', '07/13', '07/14', '07/15', '07/16', '07/17', '07/18', '07/19', '07/20', '08/10', '08/11', '08/12', '08/13', '08/14', '08/15', '08/16', '08/17', '08/18', '08/19', '08/20', '09/10', '09/11', '09/12', '09/13', '09/14', '09/15', '09/16', '09/17', '09/18', '09/19', '09/20']); equal('{-10..10}', ['-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); }); }); describe('steps > positive ranges', () => { it('should expand ranges using steps:', () => { equal('{1..10..1}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{1..10..2}', ['1', '3', '5', '7', '9']); equal('{1..20..20}', ['1']); equal('{1..20..2}', ['1', '3', '5', '7', '9', '11', '13', '15', '17', '19']); equal('{10..0..2}', ['10', '8', '6', '4', '2', '0']); equal('{10..1..2}', ['10', '8', '6', '4', '2']); equal('{100..0..5}', ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']); equal('{2..10..1}', ['2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{2..10..2}', ['2', '4', '6', '8', '10']); equal('{2..10..3}', ['2', '5', '8']); equal('{a..z..2}', ['a', 'c', 'e', 'g', 'i', 'k', 'm', 'o', 'q', 's', 'u', 'w', 'y']); }); it('should expand positive ranges with negative steps:', () => { equal('{10..0..-2}', ['10', '8', '6', '4', '2', '0']); }); }); describe('steps > negative ranges', () => { it('should expand negative ranges using steps:', () => { equal('{-1..-10..-2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-1..-10..2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-10..-2..2}', ['-10', '-8', '-6', '-4', '-2']); equal('{-2..-10..1}', ['-2', '-3', '-4', '-5', '-6', '-7', '-8', '-9', '-10']); equal('{-2..-10..2}', ['-2', '-4', '-6', '-8', '-10']); equal('{-2..-10..3}', ['-2', '-5', '-8']); equal('{-50..-0..5}', ['-50', '-45', '-40', '-35', '-30', '-25', '-20', '-15', '-10', '-5', '0']); equal('{10..1..-2}', ['10', '8', '6', '4', '2']); equal('{100..0..-5}', ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']); }); }); describe('steps > alphabetical ranges', () => { it('should expand alpha ranges with steps', () => { equal('{a..e..2}', ['a', 'c', 'e']); equal('{E..A..2}', ['E', 'C', 'A']); equal('{a..z}', ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']); equal('{a..z..2}', ['a', 'c', 'e', 'g', 'i', 'k', 'm', 'o', 'q', 's', 'u', 'w', 'y']); equal('{z..a..-2}', ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b']); }); it('should expand alpha ranges with negative steps', () => { equal('{z..a..-2}', ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b']); }); }); describe('padding', () => { it('unwanted zero-padding -- fixed post-bash-4.0', () => { equal('{10..0..2}', ['10', '8', '6', '4', '2', '0']); equal('{10..0..-2}', ['10', '8', '6', '4', '2', '0']); equal('{-50..-0..5}', ['-50', '-45', '-40', '-35', '-30', '-25', '-20', '-15', '-10', '-5', '0']); }); }); describe('ranges', () => { const fixtures = [ 'should expand ranges', ['a{b,c{1..50}/{d,e,f}/,g}h/i', {}, ['abh/i', 'ac1/d/h/i', 'ac1/e/h/i', 'ac1/f/h/i', 'ac2/d/h/i', 'ac2/e/h/i', 'ac2/f/h/i', 'ac3/d/h/i', 'ac3/e/h/i', 'ac3/f/h/i', 'ac4/d/h/i', 'ac4/e/h/i', 'ac4/f/h/i', 'ac5/d/h/i', 'ac5/e/h/i', 'ac5/f/h/i', 'ac6/d/h/i', 'ac6/e/h/i', 'ac6/f/h/i', 'ac7/d/h/i', 'ac7/e/h/i', 'ac7/f/h/i', 'ac8/d/h/i', 'ac8/e/h/i', 'ac8/f/h/i', 'ac9/d/h/i', 'ac9/e/h/i', 'ac9/f/h/i', 'ac10/d/h/i', 'ac10/e/h/i', 'ac10/f/h/i', 'ac11/d/h/i', 'ac11/e/h/i', 'ac11/f/h/i', 'ac12/d/h/i', 'ac12/e/h/i', 'ac12/f/h/i', 'ac13/d/h/i', 'ac13/e/h/i', 'ac13/f/h/i', 'ac14/d/h/i', 'ac14/e/h/i', 'ac14/f/h/i', 'ac15/d/h/i', 'ac15/e/h/i', 'ac15/f/h/i', 'ac16/d/h/i', 'ac16/e/h/i', 'ac16/f/h/i', 'ac17/d/h/i', 'ac17/e/h/i', 'ac17/f/h/i', 'ac18/d/h/i', 'ac18/e/h/i', 'ac18/f/h/i', 'ac19/d/h/i', 'ac19/e/h/i', 'ac19/f/h/i', 'ac20/d/h/i', 'ac20/e/h/i', 'ac20/f/h/i', 'ac21/d/h/i', 'ac21/e/h/i', 'ac21/f/h/i', 'ac22/d/h/i', 'ac22/e/h/i', 'ac22/f/h/i', 'ac23/d/h/i', 'ac23/e/h/i', 'ac23/f/h/i', 'ac24/d/h/i', 'ac24/e/h/i', 'ac24/f/h/i', 'ac25/d/h/i', 'ac25/e/h/i', 'ac25/f/h/i', 'ac26/d/h/i', 'ac26/e/h/i', 'ac26/f/h/i', 'ac27/d/h/i', 'ac27/e/h/i', 'ac27/f/h/i', 'ac28/d/h/i', 'ac28/e/h/i', 'ac28/f/h/i', 'ac29/d/h/i', 'ac29/e/h/i', 'ac29/f/h/i', 'ac30/d/h/i', 'ac30/e/h/i', 'ac30/f/h/i', 'ac31/d/h/i', 'ac31/e/h/i', 'ac31/f/h/i', 'ac32/d/h/i', 'ac32/e/h/i', 'ac32/f/h/i', 'ac33/d/h/i', 'ac33/e/h/i', 'ac33/f/h/i', 'ac34/d/h/i', 'ac34/e/h/i', 'ac34/f/h/i', 'ac35/d/h/i', 'ac35/e/h/i', 'ac35/f/h/i', 'ac36/d/h/i', 'ac36/e/h/i', 'ac36/f/h/i', 'ac37/d/h/i', 'ac37/e/h/i', 'ac37/f/h/i', 'ac38/d/h/i', 'ac38/e/h/i', 'ac38/f/h/i', 'ac39/d/h/i', 'ac39/e/h/i', 'ac39/f/h/i', 'ac40/d/h/i', 'ac40/e/h/i', 'ac40/f/h/i', 'ac41/d/h/i', 'ac41/e/h/i', 'ac41/f/h/i', 'ac42/d/h/i', 'ac42/e/h/i', 'ac42/f/h/i', 'ac43/d/h/i', 'ac43/e/h/i', 'ac43/f/h/i', 'ac44/d/h/i', 'ac44/e/h/i', 'ac44/f/h/i', 'ac45/d/h/i', 'ac45/e/h/i', 'ac45/f/h/i', 'ac46/d/h/i', 'ac46/e/h/i', 'ac46/f/h/i', 'ac47/d/h/i', 'ac47/e/h/i', 'ac47/f/h/i', 'ac48/d/h/i', 'ac48/e/h/i', 'ac48/f/h/i', 'ac49/d/h/i', 'ac49/e/h/i', 'ac49/f/h/i', 'ac50/d/h/i', 'ac50/e/h/i', 'ac50/f/h/i', 'agh/i']], ['0{1..9} {10..20}', {}, ['01 10', '01 11', '01 12', '01 13', '01 14', '01 15', '01 16', '01 17', '01 18', '01 19', '01 20', '02 10', '02 11', '02 12', '02 13', '02 14', '02 15', '02 16', '02 17', '02 18', '02 19', '02 20', '03 10', '03 11', '03 12', '03 13', '03 14', '03 15', '03 16', '03 17', '03 18', '03 19', '03 20', '04 10', '04 11', '04 12', '04 13', '04 14', '04 15', '04 16', '04 17', '04 18', '04 19', '04 20', '05 10', '05 11', '05 12', '05 13', '05 14', '05 15', '05 16', '05 17', '05 18', '05 19', '05 20', '06 10', '06 11', '06 12', '06 13', '06 14', '06 15', '06 16', '06 17', '06 18', '06 19', '06 20', '07 10', '07 11', '07 12', '07 13', '07 14', '07 15', '07 16', '07 17', '07 18', '07 19', '07 20', '08 10', '08 11', '08 12', '08 13', '08 14', '08 15', '08 16', '08 17', '08 18', '08 19', '08 20', '09 10', '09 11', '09 12', '09 13', '09 14', '09 15', '09 16', '09 17', '09 18', '09 19', '09 20']], ['a{0..3}d', {}, ['a0d', 'a1d', 'a2d', 'a3d']], ['x{10..1}y', {}, ['x10y', 'x9y', 'x8y', 'x7y', 'x6y', 'x5y', 'x4y', 'x3y', 'x2y', 'x1y']], ['x{3..3}y', {}, ['x3y']], ['{0..10,braces}', {}, ['0..10', 'braces']], ['{3..3}', {}, ['3']], ['{5..8}', {}, ['5', '6', '7', '8']], ['**/{1..5}/a.js', {}, ['**/1/a.js', '**/2/a.js', '**/3/a.js', '**/4/a.js', '**/5/a.js']], ['{braces,{0..10}}', {}, ['braces', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10']], ['./\\{x,y}/{a..z..3}/', {}, ['./{x,y}/a/', './{x,y}/d/', './{x,y}/g/', './{x,y}/j/', './{x,y}/m/', './{x,y}/p/', './{x,y}/s/', './{x,y}/v/', './{x,y}/y/']], ['x{{0..10},braces}y', {}, ['x0y', 'x1y', 'x2y', 'x3y', 'x4y', 'x5y', 'x6y', 'x7y', 'x8y', 'x9y', 'x10y', 'xbracesy']], ['{braces,{0..10}}', {}, ['braces', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10']], ['{{0..10},braces}', {}, ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'braces']], ['{{1..10..2},braces}', {}, ['1', '3', '5', '7', '9', 'braces']], ['{{1..10},braces}', {}, ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'braces']], ['{1.1..2.1}', {}, ['{1.1..2.1}']], ['{1.1..~2.1}', {}, ['{1.1..~2.1}']], ['{1..0f}', {}, ['{1..0f}']], ['{1..10..ff}', {}, ['{1..10..ff}']], ['{1..10.f}', {}, ['{1..10.f}']], ['{1..10f}', {}, ['{1..10f}']], ['{1..20..2f}', {}, ['{1..20..2f}']], ['{1..20..f2}', {}, ['{1..20..f2}']], ['{1..2f..2}', {}, ['{1..2f..2}']], ['{1..ff..2}', {}, ['{1..ff..2}']], ['{1..ff}', {}, ['{1..ff}']], ['{1.20..2}', {}, ['{1.20..2}']], ['a{0..3}d', {}, ['a0d', 'a1d', 'a2d', 'a3d']], ['x{10..1}y', {}, ['x10y', 'x9y', 'x8y', 'x7y', 'x6y', 'x5y', 'x4y', 'x3y', 'x2y', 'x1y']], ['x{3..3}y', {}, ['x3y']], ['{1..10}', {}, ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']], ['{1..3}', {}, ['1', '2', '3']], ['{1..9}', {}, ['1', '2', '3', '4', '5', '6', '7', '8', '9']], ['{10..1}y', {}, ['10y', '9y', '8y', '7y', '6y', '5y', '4y', '3y', '2y', '1y']], ['{3..3}', {}, ['3']], ['{5..8}', {}, ['5', '6', '7', '8']], ['{-10..-1}', {}, ['-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1']], ['{-20..0}', {}, ['-20', '-19', '-18', '-17', '-16', '-15', '-14', '-13', '-12', '-11', '-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0']], ['{0..-5}', {}, ['0', '-1', '-2', '-3', '-4', '-5']], ['{9..-4}', {}, ['9', '8', '7', '6', '5', '4', '3', '2', '1', '0', '-1', '-2', '-3', '-4']], ['0{1..9}/{10..20}', {}, ['01/10', '01/11', '01/12', '01/13', '01/14', '01/15', '01/16', '01/17', '01/18', '01/19', '01/20', '02/10', '02/11', '02/12', '02/13', '02/14', '02/15', '02/16', '02/17', '02/18', '02/19', '02/20', '03/10', '03/11', '03/12', '03/13', '03/14', '03/15', '03/16', '03/17', '03/18', '03/19', '03/20', '04/10', '04/11', '04/12', '04/13', '04/14', '04/15', '04/16', '04/17', '04/18', '04/19', '04/20', '05/10', '05/11', '05/12', '05/13', '05/14', '05/15', '05/16', '05/17', '05/18', '05/19', '05/20', '06/10', '06/11', '06/12', '06/13', '06/14', '06/15', '06/16', '06/17', '06/18', '06/19', '06/20', '07/10', '07/11', '07/12', '07/13', '07/14', '07/15', '07/16', '07/17', '07/18', '07/19', '07/20', '08/10', '08/11', '08/12', '08/13', '08/14', '08/15', '08/16', '08/17', '08/18', '08/19', '08/20', '09/10', '09/11', '09/12', '09/13', '09/14', '09/15', '09/16', '09/17', '09/18', '09/19', '09/20']], ['0{a..d}0', {}, ['0a0', '0b0', '0c0', '0d0']], ['a/{b..d}/e', {}, ['a/b/e', 'a/c/e', 'a/d/e']], ['{1..f}', { minimatch: false }, ['1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f']], ['{a..A}', {}, ['a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A']], ['{A..a}', {}, ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a']], ['{a..e}', {}, ['a', 'b', 'c', 'd', 'e']], ['{A..E}', {}, ['A', 'B', 'C', 'D', 'E']], ['{a..f}', {}, ['a', 'b', 'c', 'd', 'e', 'f']], ['{a..z}', {}, ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']], ['{E..A}', {}, ['E', 'D', 'C', 'B', 'A']], ['{f..1}', { minimatch: false }, ['f', 'e', 'd', 'c', 'b', 'a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A', '@', '?', '>', '=', '<', ';', ':', '9', '8', '7', '6', '5', '4', '3', '2', '1']], ['{f..a}', {}, ['f', 'e', 'd', 'c', 'b', 'a']], ['{f..f}', {}, ['f']], ['a/{b..d}/e/{f..h}', {}, ['a/b/e/f', 'a/b/e/g', 'a/b/e/h', 'a/c/e/f', 'a/c/e/g', 'a/c/e/h', 'a/d/e/f', 'a/d/e/g', 'a/d/e/h']], ['{-10..10}', {}, ['-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10']], ['{1..10..1}', { optimize: false }, ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']], ['{1..10..2}', { optimize: false }, ['1', '3', '5', '7', '9']], ['{1..20..20}', { optimize: false }, ['1']], ['{1..20..2}', { optimize: false }, ['1', '3', '5', '7', '9', '11', '13', '15', '17', '19']], ['{10..0..2}', { optimize: false }, ['10', '8', '6', '4', '2', '0']], ['{10..1..2}', { optimize: false }, ['10', '8', '6', '4', '2']], ['{100..0..5}', { optimize: false }, ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']], ['{2..10..1}', { optimize: false }, ['2', '3', '4', '5', '6', '7', '8', '9', '10']], ['{2..10..2}', { optimize: false }, ['2', '4', '6', '8', '10']], ['{2..10..3}', { optimize: false }, ['2', '5', '8']], ['{a..z..2}', { optimize: false }, ['a', 'c', 'e', 'g', 'i', 'k', 'm', 'o', 'q', 's', 'u', 'w', 'y']], ['{10..0..-2}', { optimize: false }, ['10', '8', '6', '4', '2', '0']], ['{-1..-10..-2}', { optimize: false }, ['-1', '-3', '-5', '-7', '-9']], ['{-1..-10..2}', { optimize: false }, ['-1', '-3', '-5', '-7', '-9']], ['{-10..-2..2}', { optimize: false }, ['-10', '-8', '-6', '-4', '-2']], ['{-2..-10..1}', { optimize: false }, ['-2', '-3', '-4', '-5', '-6', '-7', '-8', '-9', '-10']], ['{-2..-10..2}', { optimize: false }, ['-2', '-4', '-6', '-8', '-10']], ['{-2..-10..3}', { optimize: false }, ['-2', '-5', '-8']], ['{-50..-0..5}', { optimize: false }, ['-50', '-45', '-40', '-35', '-30', '-25', '-20', '-15', '-10', '-5', '0']], ['{-9..9..3}', { optimize: false }, ['-9', '-6', '-3', '0', '3', '6', '9']], ['{10..1..-2}', { optimize: false }, ['10', '8', '6', '4', '2']], ['{100..0..-5}', { optimize: false }, ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']], ['{a..e..2}', { optimize: false }, ['a', 'c', 'e']], ['{E..A..2}', { optimize: false }, ['E', 'C', 'A']], ['{a..z..2}', { optimize: false }, ['a', 'c', 'e', 'g', 'i', 'k', 'm', 'o', 'q', 's', 'u', 'w', 'y']], ['{z..a..-2}', { optimize: false }, ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b']], ['{z..a..-2}', { optimize: false }, ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b']], ['{10..0..2}', { optimize: false }, ['10', '8', '6', '4', '2', '0']], ['{10..0..-2}', { optimize: false }, ['10', '8', '6', '4', '2', '0']], ['{-50..-0..5}', { optimize: false }, ['-50', '-45', '-40', '-35', '-30', '-25', '-20', '-15', '-10', '-5', '0']], ['../{1..3}/../foo', {}, ['../1/../foo', '../2/../foo', '../3/../foo']], ['../{2..10..2}/../foo', { optimize: false }, ['../2/../foo', '../4/../foo', '../6/../foo', '../8/../foo', '../10/../foo']], ['../{1..3}/../{a,b,c}/foo', {}, ['../1/../a/foo', '../1/../b/foo', '../1/../c/foo', '../2/../a/foo', '../2/../b/foo', '../2/../c/foo', '../3/../a/foo', '../3/../b/foo', '../3/../c/foo']], ['./{a..z..3}/', { optimize: false }, ['./a/', './d/', './g/', './j/', './m/', './p/', './s/', './v/', './y/']], ['./{"x,y"}/{a..z..3}/', { minimatch: false, optimize: false }, ['./{x,y}/a/', './{x,y}/d/', './{x,y}/g/', './{x,y}/j/', './{x,y}/m/', './{x,y}/p/', './{x,y}/s/', './{x,y}/v/', './{x,y}/y/']], ['a/{x,y}/{1..5}c{d,e}f.{md,txt}', {}, ['a/x/1cdf.md', 'a/x/1cdf.txt', 'a/x/1cef.md', 'a/x/1cef.txt', 'a/x/2cdf.md', 'a/x/2cdf.txt', 'a/x/2cef.md', 'a/x/2cef.txt', 'a/x/3cdf.md', 'a/x/3cdf.txt', 'a/x/3cef.md', 'a/x/3cef.txt', 'a/x/4cdf.md', 'a/x/4cdf.txt', 'a/x/4cef.md', 'a/x/4cef.txt', 'a/x/5cdf.md', 'a/x/5cdf.txt', 'a/x/5cef.md', 'a/x/5cef.txt', 'a/y/1cdf.md', 'a/y/1cdf.txt', 'a/y/1cef.md', 'a/y/1cef.txt', 'a/y/2cdf.md', 'a/y/2cdf.txt', 'a/y/2cef.md', 'a/y/2cef.txt', 'a/y/3cdf.md', 'a/y/3cdf.txt', 'a/y/3cef.md', 'a/y/3cef.txt', 'a/y/4cdf.md', 'a/y/4cdf.txt', 'a/y/4cef.md', 'a/y/4cef.txt', 'a/y/5cdf.md', 'a/y/5cdf.txt', 'a/y/5cef.md', 'a/y/5cef.txt']], ['a/{x,{1..5},y}/c{d}e', {}, ['a/x/c{d}e', 'a/1/c{d}e', 'a/2/c{d}e', 'a/3/c{d}e', 'a/4/c{d}e', 'a/5/c{d}e', 'a/y/c{d}e']] ]; fixtures.forEach(arr => { if (typeof arr === 'string') { return; } const options = { ...arr[1] }; const pattern = arr[0]; const expected = arr[2]; if (options.skip !== true) { it('should compile: ' + pattern, () => equal(pattern, expected, options)); } }); }); }); braces-3.0.3/test/bash-expanded-sets.js000066400000000000000000000257021462306110000177470ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const bashPath = require('bash-path'); const cp = require('child_process'); const braces = require('..'); const bash = input => { return cp.spawnSync(bashPath(), ['-c', `echo ${input}`]) .stdout.toString() .split(/\s+/) .filter(Boolean); }; const equal = (input, expected = bash(input), options) => { assert.deepEqual(braces.expand(input, options), expected); }; /** * Bash 4.3 unit tests with `braces.expand()` */ describe('bash - expanded brace sets', () => { const fixtures = [ ['a/\\{b,c,d,{x,y}}{e,f\\}/g', {}, ['a/{b,c,d,x}{e,f}/g', 'a/{b,c,d,y}{e,f}/g']], ['a/\\{b,c,d\\}\\{e,f\\}/g', {}, ['a/{b,c,d}{e,f}/g']], ['a/\\{b,c,d\\}\\{e,f}/g', {}, ['a/{b,c,d}{e,f}/g']], ['a/\\{b,c,d\\}{e,f}/g', {}, ['a/{b,c,d}e/g', 'a/{b,c,d}f/g']], ['a/\\{b,c,d{x,y}}{e,f\\}/g', {}, ['a/{b,c,dx}{e,f}/g', 'a/{b,c,dy}{e,f}/g']], ['a/\\{b,c,d}{e,f\\}/g', {}, ['a/{b,c,d}{e,f}/g']], ['a/\\{b,c,d}{e,f}/g', {}, ['a/{b,c,d}e/g', 'a/{b,c,d}f/g']], ['a/\\{x,y}/cde', {}, ['a/{x,y}/cde']], ['a/\\{{b,c}{e,f}/g', {}, ['a/{be/g', 'a/{bf/g', 'a/{ce/g', 'a/{cf/g']], ['a/\\{{b,c}{e,f}\\}/g', {}, ['a/{be}/g', 'a/{bf}/g', 'a/{ce}/g', 'a/{cf}/g']], ['a/\\{{b,c}{e,f}}/g', {}, ['a/{be}/g', 'a/{bf}/g', 'a/{ce}/g', 'a/{cf}/g']], ['a/b/{b,c,{d,e{f,g},{w,x}/{y,z}}}/h/i', {}, ['a/b/b/h/i', 'a/b/c/h/i', 'a/b/d/h/i', 'a/b/ef/h/i', 'a/b/eg/h/i', 'a/b/w/y/h/i', 'a/b/w/z/h/i', 'a/b/x/y/h/i', 'a/b/x/z/h/i']], ['a/{b,c,d}{e,f}/g', {}, ['a/be/g', 'a/bf/g', 'a/ce/g', 'a/cf/g', 'a/de/g', 'a/df/g']], ['a/{b,c\\,d}{e,f}/g', {}, ['a/be/g', 'a/bf/g', 'a/c,de/g', 'a/c,df/g']], ['a/{b,c\\}}{e,f}/g', {}, ['a/be/g', 'a/bf/g', 'a/c}e/g', 'a/c}f/g']], ['a/{b,c}', {}, ['a/b', 'a/c']], ['a/{b,c}d{e,f}/g', {}, ['a/bde/g', 'a/bdf/g', 'a/cde/g', 'a/cdf/g']], ['a/{b,c}{e,f}/g', {}, ['a/be/g', 'a/bf/g', 'a/ce/g', 'a/cf/g']], ['a/{b,c}{e,f}{g,h,i}/k', {}, ['a/beg/k', 'a/beh/k', 'a/bei/k', 'a/bfg/k', 'a/bfh/k', 'a/bfi/k', 'a/ceg/k', 'a/ceh/k', 'a/cei/k', 'a/cfg/k', 'a/cfh/k', 'a/cfi/k']], ['a/{b,{c,d},e}/f', {}, ['a/b/f', 'a/c/f', 'a/d/f', 'a/e/f']], ['a/{b,{c,d}/{e,f},g}/h', {}, ['a/b/h', 'a/c/e/h', 'a/c/f/h', 'a/d/e/h', 'a/d/f/h', 'a/g/h']], ['a/{b{c,d},e{f,g}h{i,j}}/k', {}, ['a/bc/k', 'a/bd/k', 'a/efhi/k', 'a/efhj/k', 'a/eghi/k', 'a/eghj/k']], ['a/{b{c,d},e}/f', {}, ['a/bc/f', 'a/bd/f', 'a/e/f']], ['a/{b{c,d}e{f,g}h{i,j}}/k', {}, ['a/{bcefhi}/k', 'a/{bcefhj}/k', 'a/{bceghi}/k', 'a/{bceghj}/k', 'a/{bdefhi}/k', 'a/{bdefhj}/k', 'a/{bdeghi}/k', 'a/{bdeghj}/k']], ['a/{b{c,d}e{f,g},h{i,j}}/k', {}, ['a/bcef/k', 'a/bceg/k', 'a/bdef/k', 'a/bdeg/k', 'a/hi/k', 'a/hj/k']], ['a/{x,z}{b,{c,d}/{e,f},g}/h', {}, ['a/xb/h', 'a/xc/e/h', 'a/xc/f/h', 'a/xd/e/h', 'a/xd/f/h', 'a/xg/h', 'a/zb/h', 'a/zc/e/h', 'a/zc/f/h', 'a/zd/e/h', 'a/zd/f/h', 'a/zg/h']], ['a/{{a,b}/{c,d}}/z', {}, ['a/{a/c}/z', 'a/{a/d}/z', 'a/{b/c}/z', 'a/{b/d}/z']], ['a/{{b,c}/{d,e}}', {}, ['a/{b/d}', 'a/{b/e}', 'a/{c/d}', 'a/{c/e}']], ['a/{{b,c}/{d,e}}/f', {}, ['a/{b/d}/f', 'a/{b/e}/f', 'a/{c/d}/f', 'a/{c/e}/f']], ['a{b}c', {}, ['a{b}c']], ['foo {1,2} bar', {}, ['foo 1 bar', 'foo 2 bar']], ['{ }', {}, ['{ }']], ['{', {}, ['{']], ['{a,b,{c,d},e}', {}, ['a', 'b', 'c', 'd', 'e']], ['{a,b,{c,d}e}', {}, ['a', 'b', 'ce', 'de']], ['{a,b,{c,d}}', {}, ['a', 'b', 'c', 'd']], ['{a,b{c,d}}', {}, ['a', 'bc', 'bd']], ['{a,b}/{c,d}', {}, ['a/c', 'a/d', 'b/c', 'b/d']], ['{a,b}c,d\\}', {}, ['ac,d}', 'bc,d}']], ['{a,b\\}c,d}', {}, ['a', 'b}c', 'd']], ['{a,b}{c,d}', {}, ['ac', 'ad', 'bc', 'bd']], ['{abc}', {}, ['{abc}']], ['{b{c,d},e}', {}, ['bc', 'bd', 'e']], ['{b{c,d},e}/f', {}, ['bc/f', 'bd/f', 'e/f']], ['x,y,{abc},trie', {}, ['x,y,{abc},trie']], ['{{a,b},{c,d}}', {}, ['a', 'b', 'c', 'd']], ['{{a,b}/{c,d}}', {}, ['{a/c}', '{a/d}', '{b/c}', '{b/d}']], ['{{a,b}/{c,d}}/z', {}, ['{a/c}/z', '{a/d}/z', '{b/c}/z', '{b/d}/z']], ['{}', {}, ['{}']], // // should ignore globs ['}', {}, ['}']], // 'should ignore globs', ['{generate,{assemble,update,verb}{file,-generate-*},generator}.js', {}, ['generate.js', 'assemblefile.js', 'assemble-generate-*.js', 'updatefile.js', 'update-generate-*.js', 'verbfile.js', 'verb-generate-*.js', 'generator.js']], ['**/{foo,bar}.js', {}, ['**/foo.js', '**/bar.js']], ['**/{a,b,c}/*.js', {}, ['**/a/*.js', '**/b/*.js', '**/c/*.js']], ['**/{a,b,*}/*.js', {}, ['**/a/*.js', '**/b/*.js', '**/*/*.js']], ['**/{**,b,*}/*.js', {}, ['**/**/*.js', '**/b/*.js', '**/*/*.js']], ['/usr/{ucb/{ex,edit},lib/{ex,how_ex}}', {}, ['/usr/ucb/ex', '/usr/ucb/edit', '/usr/lib/ex', '/usr/lib/how_ex']], ['ff{c,b,a}', {}, ['ffc', 'ffb', 'ffa']], ['f{d,e,f}g', {}, ['fdg', 'feg', 'ffg']], ['{a,b,c}', {}, ['a', 'b', 'c']], ['{l,m,n}xyz', {}, ['lxyz', 'mxyz', 'nxyz']], ['a/{a,b}/{c,d}/e', {}, ['a/a/c/e', 'a/a/d/e', 'a/b/c/e', 'a/b/d/e']], ['a{b,c}d{e,f}g', {}, ['abdeg', 'abdfg', 'acdeg', 'acdfg']], ['a/{x,y}/c{d,e}f.{md,txt}', {}, ['a/x/cdf.md', 'a/x/cdf.txt', 'a/x/cef.md', 'a/x/cef.txt', 'a/y/cdf.md', 'a/y/cdf.txt', 'a/y/cef.md', 'a/y/cef.txt']], ['{a,b}{{a,b},a,b}', {}, ['aa', 'ab', 'aa', 'ab', 'ba', 'bb', 'ba', 'bb']], ['a{b,c{d,e}f}g', {}, ['abg', 'acdfg', 'acefg']], ['a{{x,y},z}b', {}, ['axb', 'ayb', 'azb']], ['f{x,y{g,z}}h', {}, ['fxh', 'fygh', 'fyzh']], ['a{b,c{d,e},h}x/z', {}, ['abx/z', 'acdx/z', 'acex/z', 'ahx/z']], ['a{b,c{d,e},h}x{y,z}', {}, ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'ahxy', 'ahxz']], ['a{b,c{d,e},{f,g}h}x{y,z}', {}, ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'afhxy', 'afhxz', 'aghxy', 'aghxz']], // 'should not expand escaped braces', ['\\{a,b,c,d,e}', {}, ['{a,b,c,d,e}']], ['a/\\{b,c}/{d,e}/f', {}, ['a/{b,c}/d/f', 'a/{b,c}/e/f']], ['a/\\{x,y}/cde', {}, ['a/{x,y}/cde']], ['a/b/c/{x,y\\}', {}, ['a/b/c/{x,y}']], ['a/{z,\\{a,b,c,d,e}/d', {}, ['a/z/d', 'a/{a/d', 'a/b/d', 'a/c/d', 'a/d/d', 'a/e/d']], ['abcd{efgh', {}, ['abcd{efgh']], ['{a,b\\}c,d}', {}, ['a', 'b}c', 'd']], ['{abc}', {}, ['{abc}']], ['{x,y,\\{a,b,c\\}}', {}, ['x', 'y', '{a', 'b', 'c}']], ['{x,y,{abc},trie}', {}, ['x', 'y', '{abc}', 'trie']], ['{x,y,{a,b,c\\}}', {}, ['{x,y,a', '{x,y,b', '{x,y,c}']], 'should not expand escaped commas', ['{x\\,y,\\{abc\\},trie}', {}, ['x,y', '{abc}', 'trie']], ['a{b\\,c\\,d}e', {}, ['a{b,c,d}e']], ['a{b\\,c}d', {}, ['a{b,c}d']], ['{abc\\,def}', {}, ['{abc,def}']], ['{abc\\,def,ghi}', {}, ['abc,def', 'ghi']], ['a/{b,c}/{x\\,y}/d/e', {}, ['a/b/{x,y}/d/e', 'a/c/{x,y}/d/e']], 'should handle empty braces', ['{ }', {}, ['{ }']], ['{', {}, ['{']], ['{}', {}, ['{}']], ['}', {}, ['}']], 'should escape braces when only one value is defined', ['a{b}c', {}, ['a{b}c']], ['a/b/c{d}e', {}, ['a/b/c{d}e']], 'should escape closing braces when open is not defined', ['{a,b}c,d}', {}, ['ac,d}', 'bc,d}']], 'should not expand braces in sets with es6/bash-like variables', ['abc/${ddd}/xyz', {}, ['abc/${ddd}/xyz']], ['a${b}c', {}, ['a${b}c']], ['a/{${b},c}/d', {}, ['a/${b}/d', 'a/c/d']], ['a${b,d}/{foo,bar}c', {}, ['a${b,d}/fooc', 'a${b,d}/barc']], 'should support sequence brace operators', ['ff{a,b,c}', {}, ['ffa', 'ffb', 'ffc']], ['f{d,e,f}g', {}, ['fdg', 'feg', 'ffg']], ['{a,b,c}', {}, ['a', 'b', 'c']], ['{l,m,n}xyz', {}, ['lxyz', 'mxyz', 'nxyz']], 'should expand multiple sets', ['a/{a,b}/{c,d}/e', {}, ['a/a/c/e', 'a/a/d/e', 'a/b/c/e', 'a/b/d/e']], ['a{b,c}d{e,f}g', {}, ['abdeg', 'abdfg', 'acdeg', 'acdfg']], ['a/{x,y}/c{d,e}f.{md,txt}', {}, ['a/x/cdf.md', 'a/x/cdf.txt', 'a/x/cef.md', 'a/x/cef.txt', 'a/y/cdf.md', 'a/y/cdf.txt', 'a/y/cef.md', 'a/y/cef.txt']], 'should expand nested sets', ['a{b,c{d,e}f}g', {}, ['abg', 'acdfg', 'acefg']], ['a{{x,y},z}b', {}, ['axb', 'ayb', 'azb']], ['f{x,y{g,z}}h', {}, ['fxh', 'fygh', 'fyzh']], ['a{b,c{d,e},h}x/z', {}, ['abx/z', 'acdx/z', 'acex/z', 'ahx/z']], ['a{b,c{d,e},h}x{y,z}', {}, ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'ahxy', 'ahxz']], ['a{b,c{d,e},{f,g}h}x{y,z}', {}, ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'afhxy', 'afhxz', 'aghxy', 'aghxz']], ['a-{b{d,e}}-c', {}, ['a-{bd}-c', 'a-{be}-c']], 'should do nothing to glob characters', ['a/b/{d,e}/*.js', {}, ['a/b/d/*.js', 'a/b/e/*.js']], ['a/**/c/{d,e}/f*.js', {}, ['a/**/c/d/f*.js', 'a/**/c/e/f*.js']], ['a/**/c/{d,e}/f*.{md,txt}', {}, ['a/**/c/d/f*.md', 'a/**/c/d/f*.txt', 'a/**/c/e/f*.md', 'a/**/c/e/f*.txt']], ['a/b/{d,e,[1-5]}/*.js', {}, ['a/b/d/*.js', 'a/b/e/*.js', 'a/b/[1-5]/*.js']], 'should work with leading and trailing commas', ['a{b,}c', {}, ['abc', 'ac']], ['a{,b}c', {}, ['ac', 'abc']], 'should handle spaces', ['a{ ,c{d, },h}x', {}, ['a x', 'acdx', 'ac x', 'ahx']], ['a{ ,c{d, },h} ', {}, ['a ', 'acd ', 'ac ', 'ah ']], 'see https://github.com/jonschlinkert/microequal/issues/66', ['/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.{html,ejs}', {}, ['/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.html', '/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.ejs']], 'should handle weirdly-formed brace expansions (fixed in post-bash-3.1)', ['a-{b{d,e}}-c', {}, ['a-{bd}-c', 'a-{be}-c']], ['a-{bdef-{g,i}-c', {}, ['a-{bdef-g-c', 'a-{bdef-i-c']], // 'should not expand quoted strings', ['{"foo"}{1,2,3}', {}, ['{foo}1', '{foo}2', '{foo}3']], ['{"foo"}{1,2,3}', { keepQuotes: true }, ['{"foo"}1', '{"foo"}2', '{"foo"}3']], ['{"x,x"}', { keepQuotes: true }, ['{"x,x"}']], ['{\'x,x\'}', { keepQuotes: true }, ['{\'x,x\'}']], 'should escape outer braces in nested non-sets', ['{a-{b,c,d}}', {}, ['{a-b}', '{a-c}', '{a-d}']], ['{a,{a-{b,c,d}}}', {}, ['a', '{a-b}', '{a-c}', '{a-d}']], 'should escape imbalanced braces', ['abc{', {}, ['abc{']], ['{abc{', {}, ['{abc{']], ['{abc', {}, ['{abc']], ['}abc', {}, ['}abc']], ['ab{c', {}, ['ab{c']], ['ab{c', {}, ['ab{c']], ['{{a,b}', {}, ['{a', '{b']], ['{a,b}}', {}, ['a}', 'b}']], ['a{b{c{d,e}f}gh', {}, ['a{b{cdf}gh', 'a{b{cef}gh']], ['a{b{c{d,e}f}g}h', {}, ['a{b{cdf}g}h', 'a{b{cef}g}h']], ['f{x,y{{g,z}}h}', {}, ['fx', 'fy{g}h', 'fy{z}h']], ['z{a,b},c}d', {}, ['za,c}d', 'zb,c}d']], ['a{b{c{d,e}f{x,y{{g}h', {}, ['a{b{cdf{x,y{{g}h', 'a{b{cef{x,y{{g}h']], ['f{x,y{{g}h', {}, ['f{x,y{{g}h']], ['f{x,y{{g}}h', {}, ['f{x,y{{g}}h']], ['a{b{c{d,e}f{x,y{}g}h', {}, ['a{b{cdfxh', 'a{b{cdfy{}gh', 'a{b{cefxh', 'a{b{cefy{}gh']], ['f{x,y{}g}h', {}, ['fxh', 'fy{}gh']], ['z{a,b{,c}d', {}, ['z{a,bd', 'z{a,bcd']] ]; fixtures.forEach(arr => { if (typeof arr === 'string') { return; } const options = { ...arr[1] }; const pattern = arr[0]; const expected = arr[2]; if (options.skip !== true) { it('should compile: ' + pattern, () => equal(pattern, expected, options)); } }); }); braces-3.0.3/test/bash-spec.js000066400000000000000000000321641462306110000161350ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const bashPath = require('bash-path'); const cp = require('child_process'); const braces = require('..'); const bash = input => { return cp.spawnSync(bashPath(), ['-c', `echo ${input}`]) .stdout.toString() .split(/\s+/) .filter(Boolean); }; const equal = (input, expected = bash(input), options) => { assert.deepEqual(braces.expand(input, options), expected); }; /** * Bash 4.3 unit tests */ describe('bash', () => { const fixtures = [ ['{1\\.2}', {}, ['{1.2}']], ['{1\\.2}', { keepEscaping: true }, ['{1\\.2}']], ['{"x,x"}', {}, ['{x,x}']], ['{x","x}', {}, ['{x,x}']], ['\'{x,x}\'', {}, ['{x,x}']], ['{x`,`x}', {}, ['{x,x}']], ['{x`,`x}', { keepQuotes: true }, ['{x`,`x}']], ['\'{a,b}{{a,b},a,b}\'', {}, ['{a,b}{{a,b},a,b}']], ['A{b,{d,e},{f,g}}Z', {}, ['AbZ', 'AdZ', 'AeZ', 'AfZ', 'AgZ']], ['PRE-{a,b}{{a,b},a,b}-POST', {}, ['PRE-aa-POST', 'PRE-ab-POST', 'PRE-aa-POST', 'PRE-ab-POST', 'PRE-ba-POST', 'PRE-bb-POST', 'PRE-ba-POST', 'PRE-bb-POST']], ['\\{a,b}{{a,b},a,b}', {}, ['{a,b}a', '{a,b}b', '{a,b}a', '{a,b}b']], ['{{a,b}', {}, ['{a', '{b']], ['{a,b}}', {}, ['a}', 'b}']], ['{,}', {}, ['', '']], ['a{,}', {}, ['a', 'a']], ['{,}b', {}, ['b', 'b']], ['a{,}b', {}, ['ab', 'ab']], ['a{b}c', {}, ['a{b}c']], ['a{1..5}b', {}, ['a1b', 'a2b', 'a3b', 'a4b', 'a5b']], ['a{01..5}b', {}, ['a01b', 'a02b', 'a03b', 'a04b', 'a05b']], ['a{-01..5}b', {}, ['a-01b', 'a000b', 'a001b', 'a002b', 'a003b', 'a004b', 'a005b']], ['a{-01..5..3}b', {}, ['a-01b', 'a002b', 'a005b']], ['a{001..9}b', {}, ['a001b', 'a002b', 'a003b', 'a004b', 'a005b', 'a006b', 'a007b', 'a008b', 'a009b']], ['a{b,c{d,e},{f,g}h}x{y,z', {}, ['abx{y,z', 'acdx{y,z', 'acex{y,z', 'afhx{y,z', 'aghx{y,z']], ['a{b,c{d,e},{f,g}h}x{y,z\\}', {}, ['abx{y,z}', 'acdx{y,z}', 'acex{y,z}', 'afhx{y,z}', 'aghx{y,z}']], ['a{b,c{d,e},{f,g}h}x{y,z}', {}, ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'afhxy', 'afhxz', 'aghxy', 'aghxz']], ['a{b{c{d,e}f{x,y{{g}h', {}, ['a{b{cdf{x,y{{g}h', 'a{b{cef{x,y{{g}h']], ['a{b{c{d,e}f{x,y{}g}h', {}, ['a{b{cdfxh', 'a{b{cdfy{}gh', 'a{b{cefxh', 'a{b{cefy{}gh']], ['a{b{c{d,e}f{x,y}}g}h', {}, ['a{b{cdfx}g}h', 'a{b{cdfy}g}h', 'a{b{cefx}g}h', 'a{b{cefy}g}h']], ['a{b{c{d,e}f}g}h', {}, ['a{b{cdf}g}h', 'a{b{cef}g}h']], ['a{{x,y},z}b', {}, ['axb', 'ayb', 'azb']], ['f{x,y{g,z}}h', {}, ['fxh', 'fygh', 'fyzh']], ['f{x,y{{g,z}}h', {}, ['f{x,y{g}h', 'f{x,y{z}h']], ['f{x,y{{g,z}}h}', {}, ['fx', 'fy{g}h', 'fy{z}h']], ['f{x,y{{g}h', {}, ['f{x,y{{g}h']], ['f{x,y{{g}}h', {}, ['f{x,y{{g}}h']], ['f{x,y{}g}h', {}, ['fxh', 'fy{}gh']], ['z{a,b{,c}d', {}, ['z{a,bd', 'z{a,bcd']], ['z{a,b},c}d', {}, ['za,c}d', 'zb,c}d']], ['{-01..5}', {}, ['-01', '000', '001', '002', '003', '004', '005']], ['{-05..100..5}', {}, ['-05', '000', '005', '010', '015', '020', '025', '030', '035', '040', '045', '050', '055', '060', '065', '070', '075', '080', '085', '090', '095', '100']], ['{-05..100}', {}, ['-05', '-04', '-03', '-02', '-01', '000', '001', '002', '003', '004', '005', '006', '007', '008', '009', '010', '011', '012', '013', '014', '015', '016', '017', '018', '019', '020', '021', '022', '023', '024', '025', '026', '027', '028', '029', '030', '031', '032', '033', '034', '035', '036', '037', '038', '039', '040', '041', '042', '043', '044', '045', '046', '047', '048', '049', '050', '051', '052', '053', '054', '055', '056', '057', '058', '059', '060', '061', '062', '063', '064', '065', '066', '067', '068', '069', '070', '071', '072', '073', '074', '075', '076', '077', '078', '079', '080', '081', '082', '083', '084', '085', '086', '087', '088', '089', '090', '091', '092', '093', '094', '095', '096', '097', '098', '099', '100']], ['{0..5..2}', {}, ['0', '2', '4']], ['{0001..05..2}', {}, ['0001', '0003', '0005']], ['{0001..-5..2}', {}, ['0001', '-001', '-003', '-005']], ['{0001..-5..-2}', {}, ['0001', '-001', '-003', '-005']], ['{0001..5..-2}', {}, ['0001', '0003', '0005']], ['{01..5}', {}, ['01', '02', '03', '04', '05']], ['{1..05}', {}, ['01', '02', '03', '04', '05']], ['{1..05..3}', {}, ['01', '04']], ['{05..100}', {}, ['005', '006', '007', '008', '009', '010', '011', '012', '013', '014', '015', '016', '017', '018', '019', '020', '021', '022', '023', '024', '025', '026', '027', '028', '029', '030', '031', '032', '033', '034', '035', '036', '037', '038', '039', '040', '041', '042', '043', '044', '045', '046', '047', '048', '049', '050', '051', '052', '053', '054', '055', '056', '057', '058', '059', '060', '061', '062', '063', '064', '065', '066', '067', '068', '069', '070', '071', '072', '073', '074', '075', '076', '077', '078', '079', '080', '081', '082', '083', '084', '085', '086', '087', '088', '089', '090', '091', '092', '093', '094', '095', '096', '097', '098', '099', '100']], ['{0a..0z}', {}, ['{0a..0z}']], ['{a,b\\}c,d}', {}, ['a', 'b}c', 'd']], ['{a,b{c,d}', {}, ['{a,bc', '{a,bd']], ['{a,b}c,d}', {}, ['ac,d}', 'bc,d}']], ['{a..F}', {}, ['a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F']], ['{A..f}', {}, ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f']], ['{a..Z}', {}, ['a', '`', '_', '^', ']', '\\', '[', 'Z']], ['{A..z}', {}, ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']], ['{z..A}', {}, ['z', 'y', 'x', 'w', 'v', 'u', 't', 's', 'r', 'q', 'p', 'o', 'n', 'm', 'l', 'k', 'j', 'i', 'h', 'g', 'f', 'e', 'd', 'c', 'b', 'a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A']], ['{Z..a}', {}, ['Z', '[', '\\', ']', '^', '_', '`', 'a']], ['{a..F..2}', {}, ['a', '_', ']', '[', 'Y', 'W', 'U', 'S', 'Q', 'O', 'M', 'K', 'I', 'G']], ['{A..f..02}', {}, ['A', 'C', 'E', 'G', 'I', 'K', 'M', 'O', 'Q', 'S', 'U', 'W', 'Y', '[', ']', '_', 'a', 'c', 'e']], ['{a..Z..5}', {}, ['a', '\\']], ['d{a..Z..5}b', {}, ['dab', 'd\\b']], ['{A..z..10}', {}, ['A', 'K', 'U', '_', 'i', 's']], ['{z..A..-2}', {}, ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b', '`', '^', '\\', 'Z', 'X', 'V', 'T', 'R', 'P', 'N', 'L', 'J', 'H', 'F', 'D', 'B']], ['{Z..a..20}', {}, ['Z']], ['{a{,b}', {}, ['{a', '{ab']], ['{a\\},b}', {}, ['a}', 'b']], ['{x,y{,}g}', {}, ['x', 'yg', 'yg']], ['{x,y{}g}', {}, ['x', 'y{}g']], ['{{a,b}', {}, ['{a', '{b']], ['{{a,b},c}', {}, ['a', 'b', 'c']], ['{{a,b}c}', {}, ['{ac}', '{bc}']], ['{{a,b},}', {}, ['a', 'b', '']], ['X{{a,b},}X', {}, ['XaX', 'XbX', 'XX']], ['{{a,b},}c', {}, ['ac', 'bc', 'c']], ['{{a,b}.}', {}, ['{a.}', '{b.}']], ['{{a,b}}', {}, ['{a}', '{b}']], ['X{a..#}X', {}, ['XaX', 'X`X', 'X_X', 'X^X', 'X]X', 'X\\X', 'X[X', 'XZX', 'XYX', 'XXX', 'XWX', 'XVX', 'XUX', 'XTX', 'XSX', 'XRX', 'XQX', 'XPX', 'XOX', 'XNX', 'XMX', 'XLX', 'XKX', 'XJX', 'XIX', 'XHX', 'XGX', 'XFX', 'XEX', 'XDX', 'XCX', 'XBX', 'XAX', 'X@X', 'X?X', 'X>X', 'X=X', 'X { if (typeof arr === 'string') { return; } const options = { ...arr[1] }; const pattern = arr[0]; const expected = arr[2]; if (options.skip === true) { return; } it('should compile: ' + pattern, () => { equal(pattern, expected, options); }); }); }); braces-3.0.3/test/braces.compile.js000066400000000000000000000051311462306110000171500ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const compile = require('../lib/compile'); const parse = require('../lib/parse'); describe('braces.compile()', () => { describe('errors', () => { it('should throw an error when invalid args are passed', () => { assert.throws(() => compile()); }); }); describe('invalid characters', () => { it('should escape invalid bracket characters', () => { assert.equal(compile(parse(']{a,b,c}')), '\\](a|b|c)'); }); }); describe('sets', () => { it('should support empty sets', () => { assert.equal(compile(parse('{a,}')), '(a|)'); assert.equal(compile(parse('{a,,}')), '(a|)'); assert.equal(compile(parse('{a,,,}')), '(a|)'); assert.equal(compile(parse('{a,,,,}')), '(a|)'); assert.equal(compile(parse('{a,,,,,}')), '(a|)'); }); }); describe('ranges', () => { it('should escape braces with invalid ranges', () => { assert.equal(compile(parse('{a...b}')), '{a...b}'); assert.equal(compile(parse('{a...b}'), { escapeInvalid: true }), '\\{a...b\\}'); }); it('should expand brace patterns with both sets and ranges', () => { assert.equal(compile(parse('{a..e,z}')), '(a..e|z)'); assert.equal(compile(parse('{a..e,a..z}')), '(a..e|a..z)'); }); it('should escape braces with too many range expressions', () => { assert.equal(compile(parse('{a..e..x..z}')), '{a..e..x..z}'); assert.equal(compile(parse('{a..e..x..z}'), { escapeInvalid: true }), '\\{a..e..x..z\\}'); }); it('should compile very simple numeric ranges', () => { assert.equal(compile(parse('{1..5}')), '([1-5])'); }); it('should compile numeric ranges with increments', () => { assert.equal(compile(parse('{1..5..2}')), '(1|3|5)'); }); it('should compile zero-padded numeric ranges', () => { assert.equal(compile(parse('{01..05}')), '(0[1-5])'); }); it('should compile zero-padded numeric ranges with increments', () => { assert.equal(compile(parse('{01..05..2}')), '(01|03|05)'); assert.equal(compile(parse('{01..05..3}')), '(01|04)'); }); }); describe('invalid', () => { it('should escape incomplete brace patterns', () => { assert.equal(compile(parse(']{a/b')), '\\]{a/b'); assert.equal(compile(parse(']{a/b'), { escapeInvalid: true }), '\\]\\{a/b'); }); it('should escape non-brace patterns (no sets or ranges)', () => { assert.equal(compile(parse(']{a/b}')), '\\]{a/b}'); assert.equal(compile(parse(']{a/b}'), { escapeInvalid: true }), '\\]\\{a/b\\}'); }); }); }); braces-3.0.3/test/braces.expand.js000066400000000000000000000154651462306110000170120ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const expand = require('../lib/expand'); const parse = require('../lib/parse'); const bashPath = require('bash-path'); const cp = require('child_process'); const braces = require('..'); const bash = input => { return cp .spawnSync(bashPath(), ['-c', `echo ${input}`]) .stdout.toString() .split(/\s+/) .filter(Boolean); }; const equal = (input, expected = bash(input), options) => { assert.deepEqual(braces.expand(input, options), expected); }; describe('unit tests from brace-expand', () => { describe('extglobs', () => { it('should split on commas when braces are inside extglobs', () => { equal('*(a|{b|c,d})', ['*(a|b|c)', '*(a|d)']); }); it('should not split on commas in extglobs when inside braces', () => { equal('{a,@(b,c)}', ['a', '@(b,c)']); equal('{a,*(b|c,d)}', ['a', '*(b|c,d)']); }); }); describe('expand', () => { it('should expand an AST', () => { assert.deepEqual(expand(parse('a/{b,c}/d')), ['a/b/d', 'a/c/d']); }); it('should support expanded nested empty sets', () => { equal('{`foo,bar`}', ['{`foo,bar`}'], { keepQuotes: true }); equal('{\\`foo,bar\\`}', ['`foo', 'bar`'], { keepQuotes: true }); equal('{`foo,bar`}', ['{`foo,bar`}'], { keepQuotes: true }); equal('{`foo\\,bar`}', ['{`foo\\,bar`}'], { keepQuotes: true }); equal('{`foo,bar`}', ['{foo,bar}']); equal('{\\`foo,bar\\`}', ['`foo', 'bar`']); equal('{`foo,bar`}', ['{foo,bar}']); equal('{`foo\\,bar`}', ['{foo\\,bar}']); equal('{a,\\\\{a,b}c}', ['a', '\\ac', '\\bc']); equal('{a,\\{a,b}c}', ['ac}', '{ac}', 'bc}']); equal('{,eno,thro,ro}ugh', ['ugh', 'enough', 'through', 'rough']); equal('{,{,eno,thro,ro}ugh}{,out}', [ '', 'out', 'ugh', 'ughout', 'enough', 'enoughout', 'through', 'throughout', 'rough', 'roughout' ]); equal('{{,eno,thro,ro}ugh,}{,out}', [ 'ugh', 'ughout', 'enough', 'enoughout', 'through', 'throughout', 'rough', 'roughout', '', 'out' ]); equal('{,{,a,b}z}{,c}', ['', 'c', 'z', 'zc', 'az', 'azc', 'bz', 'bzc']); equal('{,{,a,b}z}{c,}', ['c', '', 'zc', 'z', 'azc', 'az', 'bzc', 'bz']); equal('{,{,a,b}z}{,c,}', ['', 'c', '', 'z', 'zc', 'z', 'az', 'azc', 'az', 'bz', 'bzc', 'bz']); equal('{,{,a,b}z}{c,d}', ['c', 'd', 'zc', 'zd', 'azc', 'azd', 'bzc', 'bzd']); equal('{{,a,b}z,}{,c}', ['z', 'zc', 'az', 'azc', 'bz', 'bzc', '', 'c']); equal('{,a{,b}z,}{,c}', ['', 'c', 'az', 'azc', 'abz', 'abzc', '', 'c']); equal('{,a{,b},}{,c}', ['', 'c', 'a', 'ac', 'ab', 'abc', '', 'c']); equal('{,a{,b}}{,c}', ['', 'c', 'a', 'ac', 'ab', 'abc']); equal('{,b}{,d}', ['', 'd', 'b', 'bd']); equal('{a,b}{,d}', ['a', 'ad', 'b', 'bd']); equal('{,a}{z,c}', ['z', 'c', 'az', 'ac']); equal('{,{a,}}{z,c}', ['z', 'c', 'az', 'ac', 'z', 'c']); equal('{,{,a}}{z,c}', ['z', 'c', 'z', 'c', 'az', 'ac']); equal('{,{,a},}{z,c}', ['z', 'c', 'z', 'c', 'az', 'ac', 'z', 'c']); equal('{{,,a}}{z,c}', ['{}z', '{}c', '{}z', '{}c', '{a}z', '{a}c']); equal('{{,a},}{z,c}', ['z', 'c', 'az', 'ac', 'z', 'c']); equal('{,,a}{z,c}', ['z', 'c', 'z', 'c', 'az', 'ac']); equal('{,{,}}{z,c}', ['z', 'c', 'z', 'c', 'z', 'c']); equal('{,{a,b}}{,c}', ['', 'c', 'a', 'ac', 'b', 'bc']); equal('{,{a,}}{,c}', ['', 'c', 'a', 'ac', '', 'c']); equal('{,{,b}}{,c}', ['', 'c', '', 'c', 'b', 'bc']); equal('{,{,}}{,c}', ['', 'c', '', 'c', '', 'c']); equal('{,a}{,c}', ['', 'c', 'a', 'ac']); equal('{,{,a}b}', ['', 'b', 'ab']); equal('{,b}', ['', 'b']); equal('{,b{,a}}', ['', 'b', 'ba']); equal('{b,{,a}}', ['b', '', 'a']); equal('{,b}{,d}', ['', 'd', 'b', 'bd']); equal('{a,b}{,d}', ['a', 'ad', 'b', 'bd']); }); }); /** * The following unit tests are from brace-expansion v1.1.6 * https://github.com/juliangruber/brace-expansion */ describe('brace expansion unit tests from brace-expand', () => { describe('sequences', () => { it('numeric sequences', () => { equal('a{1..2}b{2..3}c', ['a1b2c', 'a1b3c', 'a2b2c', 'a2b3c']); equal('{1..2}{2..3}', ['12', '13', '22', '23']); }); it('numeric sequences with step count', () => { equal('{0..8..2}', ['0', '2', '4', '6', '8']); equal('{1..8..2}', ['1', '3', '5', '7']); }); it('numeric sequence with negative x / y', () => { equal('{3..-2}', ['3', '2', '1', '0', '-1', '-2']); }); it('alphabetic sequences', () => { equal('1{a..b}2{b..c}3', ['1a2b3', '1a2c3', '1b2b3', '1b2c3']); equal('{a..b}{b..c}', ['ab', 'ac', 'bb', 'bc']); }); it('alphabetic sequences with step count', () => { equal('{a..k..2}', ['a', 'c', 'e', 'g', 'i', 'k']); equal('{b..k..2}', ['b', 'd', 'f', 'h', 'j']); }); }); describe('dollar', () => { it('ignores ${', () => { equal('${1..3}', ['${1..3}']); equal('${a,b}${c,d}', ['${a,b}${c,d}']); equal('x${a,b}x${c,d}x', ['x${a,b}x${c,d}x']); }); }); describe('empty option', () => { it('should support empty sets', () => { equal('-v{,,,,}', ['-v', '-v', '-v', '-v', '-v']); }); }); describe('negative increments', () => { it('should support negative steps', () => { equal('{3..1}', ['3', '2', '1']); equal('{10..8}', ['10', '9', '8']); equal('{10..08}', ['10', '09', '08']); equal('{c..a}', ['c', 'b', 'a']); equal('{4..0..2}', ['4', '2', '0']); equal('{4..0..-2}', ['4', '2', '0']); equal('{e..a..2}', ['e', 'c', 'a']); }); }); describe('nested', () => { it('should support nested sets', () => { equal('{a,b{1..3},c}', ['a', 'b1', 'b2', 'b3', 'c']); equal('{{A..E},{a..e}}', ['A', 'B', 'C', 'D', 'E', 'a', 'b', 'c', 'd', 'e']); equal('ppp{,config,oe{,conf}}', ['ppp', 'pppconfig', 'pppoe', 'pppoeconf']); }); }); describe('order', () => { it('should expand in given order', () => { equal('a{d,c,b}e', ['ade', 'ace', 'abe']); }); }); describe('pad', () => { it('should support padding', () => { equal('{9..11}', ['9', '10', '11']); equal('{09..11}', ['09', '10', '11']); }); }); }); describe('additional brace expansion test', () => { describe('sequences', () => { it('zero-padded numeric sequences', () => { equal('{008..012}', ['008', '009', '010', '011', '012']); }); it('zero-padded numeric sequences with increments', () => { equal('{008..012..2}', ['008', '010', '012']); }); }); }); }); braces-3.0.3/test/braces.parse.js000066400000000000000000000026731462306110000166420ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const parse = require('../lib/parse'); describe('braces.parse()', () => { describe('errors', () => { it('should throw an error when string exceeds max safe length', () => { const MAX_LENGTH = 1024 * 64; assert.throws(() => parse('.'.repeat(MAX_LENGTH + 2))); }); }); describe('valid', () => { it('should return an AST', () => { const ast = parse('a/{b,c}/d'); const brace = ast.nodes.find(node => node.type === 'brace'); assert(brace); assert.equal(brace.nodes.length, 5); }); it('should ignore braces inside brackets', () => { const ast = parse('a/[{b,c}]/d'); assert.equal(ast.nodes[1].type, 'text'); assert.equal(ast.nodes[1].value, 'a/[{b,c}]/d'); }); it('should parse braces with brackets inside', () => { const ast = parse('a/{a,b,[{c,d}]}/e'); const brace = ast.nodes[2]; const bracket = brace.nodes.find(node => node.value[0] === '['); assert(bracket); assert.equal(bracket.value, '[{c,d}]'); }); }); describe('invalid', () => { it('should escape standalone closing braces', () => { const one = parse('}'); assert.equal(one.nodes[1].type, 'text'); assert.equal(one.nodes[1].value, '}'); const two = parse('a}b'); assert.equal(two.nodes[1].type, 'text'); assert.equal(two.nodes[1].value, 'a}b'); }); }); }); braces-3.0.3/test/minimatch.js000066400000000000000000000017251462306110000162400ustar00rootroot00000000000000'use strict'; const assert = require('assert').strict; const braces = require('..'); /** * minimatch v3.0.3 unit tests */ describe('brace expansion', () => { const units = [ ['a{b,c{d,e},{f,g}h}x{y,z}', ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'afhxy', 'afhxz', 'aghxy', 'aghxz']], ['a{1..5}b', ['a1b', 'a2b', 'a3b', 'a4b', 'a5b']], ['a{b}c', ['a{b}c']], ['a{00..05}b', ['a00b', 'a01b', 'a02b', 'a03b', 'a04b', 'a05b']], ['z{a,b},c}d', ['za,c}d', 'zb,c}d']], ['z{a,b{,c}d', ['z{a,bd', 'z{a,bcd']], ['a{b{c{d,e}f}g}h', ['a{b{cdf}g}h', 'a{b{cef}g}h']], ['a{b{c{d,e}f{x,y}}g}h', ['a{b{cdfx}g}h', 'a{b{cdfy}g}h', 'a{b{cefx}g}h', 'a{b{cefy}g}h']], ['a{b{c{d,e}f{x,y{}g}h', ['a{b{cdfxh', 'a{b{cdfy{}gh', 'a{b{cefxh', 'a{b{cefy{}gh']] ]; units.forEach(unit => { it('should expand: ' + unit[0], () => { assert.deepEqual(braces.expand(unit[0]), unit[1], unit[0]); }); }); }); braces-3.0.3/test/multiples.js000066400000000000000000000160031462306110000163000ustar00rootroot00000000000000'use strict'; const assert = require('assert').strict; const braces = require('..'); const equal = (input, expected, options) => { assert.deepEqual(braces.expand(input, options), expected); }; describe('multiples', () => { const patterns = [ ['-v{,,,,}', ['-v', '-v', '-v', '-v', '-v']], ['-v{,,,,}{,}', ['-v', '-v', '-v', '-v', '-v', '-v', '-v', '-v', '-v', '-v']], ['a/b{,}', ['a/b', 'a/b']], ['a/{,}/b', ['a//b', 'a//b']], ['a/{,}{c,d}/e', ['a/c/e', 'a/d/e', 'a/c/e', 'a/d/e']], ['a/{a,b,{,}{,}{,},c}/b', ['a/a/b', 'a/b/b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a/c/b']], ['a/{a,b,{,},c}/b', ['a/a/b', 'a/b/b', 'a//b', 'a//b', 'a/c/b']], ['a/{a,b,{,}{,}{,}}/b', ['a/a/b', 'a/b/b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b', 'a//b']], ['a/{b,cz{,}}/{d{,},ef}{,}', ['a/b/d', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/ef', 'a/b/ef', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/ef', 'a/cz/ef', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/ef', 'a/cz/ef']], ['a/{b,cz}{,}/{d{,},ef}{,}', ['a/b/d', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/ef', 'a/b/ef', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/ef', 'a/b/ef', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/ef', 'a/cz/ef', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/d', 'a/cz/ef', 'a/cz/ef']], ['a/{b,c{,}}', ['a/b', 'a/c', 'a/c']], ['a/{b,c{,}}/{,}', ['a/b/', 'a/b/', 'a/c/', 'a/c/', 'a/c/', 'a/c/']], ['a/{b,c}/{,}', ['a/b/', 'a/b/', 'a/c/', 'a/c/']], ['a/{b,c}{,}/d{,}', ['a/b/d', 'a/b/d', 'a/b/d', 'a/b/d', 'a/c/d', 'a/c/d', 'a/c/d', 'a/c/d']], ['a/{b,c}{,}/{d,e{,}}', ['a/b/d', 'a/b/e', 'a/b/e', 'a/b/d', 'a/b/e', 'a/b/e', 'a/c/d', 'a/c/e', 'a/c/e', 'a/c/d', 'a/c/e', 'a/c/e']], ['a/{b,c}{,}/{d,e}{,}', ['a/b/d', 'a/b/d', 'a/b/e', 'a/b/e', 'a/b/d', 'a/b/d', 'a/b/e', 'a/b/e', 'a/c/d', 'a/c/d', 'a/c/e', 'a/c/e', 'a/c/d', 'a/c/d', 'a/c/e', 'a/c/e']], ['a/{b,c}{,}/{d{,},e}{,}', ['a/b/d', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/e', 'a/b/e', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/d', 'a/b/e', 'a/b/e', 'a/c/d', 'a/c/d', 'a/c/d', 'a/c/d', 'a/c/e', 'a/c/e', 'a/c/d', 'a/c/d', 'a/c/d', 'a/c/d', 'a/c/e', 'a/c/e']], ['a/{c,d}/{x,y{,}}/e', ['a/c/x/e', 'a/c/y/e', 'a/c/y/e', 'a/d/x/e', 'a/d/y/e', 'a/d/y/e']], ['a/{c,d}{,}/e', ['a/c/e', 'a/c/e', 'a/d/e', 'a/d/e']], ['a{,,,,,}', ['a', 'a', 'a', 'a', 'a', 'a']], ['a{,,,,,}{,}', ['a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a']], ['a{,,,,,}{,,}', ['a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a']], ['a{,,,,,}{,,}{,}', ['a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a']], ['a{,,,,}', ['a', 'a', 'a', 'a', 'a']], ['a{,,,}', ['a', 'a', 'a', 'a']], ['a{,,}', ['a', 'a', 'a']], ['a{,,}{,,}{,,}{,}/b', ['a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b', 'a/b']], ['a{,,}{,}', ['a', 'a', 'a', 'a', 'a', 'a']], ['a{,}', ['a', 'a']], ['a{,}/{c,d}/e', ['a/c/e', 'a/d/e', 'a/c/e', 'a/d/e']], ['a{,}b', ['ab', 'ab']], ['a{,}{,}', ['a', 'a', 'a', 'a']], ['a{,}{,}{,}', ['a', 'a', 'a', 'a', 'a', 'a', 'a', 'a']], ['a{,}{,}{,}{,}', ['a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a', 'a']], ['one/{a{,}{,}}/{b/c{,,}{,}{,,}{,}}/two', ['one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two', 'one/{a}/{b/c}/two']], ['{,}', ['', '']], ['{,}a/{,}', ['a/', 'a/', 'a/', 'a/']], ['{,}{,}', ['', '', '', '']], ['{a,b{,}{,}{,},c}d', ['ad', 'bd', 'bd', 'bd', 'bd', 'bd', 'bd', 'bd', 'bd', 'cd']], ['{a,b{,}{,}{,}}', ['a', 'b', 'b', 'b', 'b', 'b', 'b', 'b', 'b']], ['{a{,,}b{,}}', ['{ab}', '{ab}', '{ab}', '{ab}', '{ab}', '{ab}']] ]; patterns.forEach(pattern => { it('should expand: ' + pattern[0], () => equal(pattern[0], pattern[1])); }); }); braces-3.0.3/test/readme.js000066400000000000000000000026251462306110000155240ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const braces = require('..'); describe('Examples from README.md', () => { describe('Brace Expansion vs. Compilation', () => { it('Compiled', () => { assert.deepEqual(braces('a/{x,y,z}/b'), ['a/(x|y|z)/b']); assert.deepEqual(braces(['a/{01..20}/b', 'a/{1..5}/b']), [ 'a/(0[1-9]|1[0-9]|20)/b', 'a/([1-5])/b' ]); }); it('Expanded', () => { assert.deepEqual(braces('a/{x,y,z}/b', { expand: true }), ['a/x/b', 'a/y/b', 'a/z/b']); assert.deepEqual(braces.expand('{01..10}'), [ '01', '02', '03', '04', '05', '06', '07', '08', '09', '10' ]); }); }); describe('Sequences', () => { it('first set of examples', () => { assert.deepEqual(braces.expand('{1..3}'), ['1', '2', '3']); assert.deepEqual(braces.expand('a/{1..3}/b'), ['a/1/b', 'a/2/b', 'a/3/b']); assert.deepEqual(braces('{a..c}', { expand: true }), ['a', 'b', 'c']); assert.deepEqual(braces('foo/{a..c}', { expand: true }), ['foo/a', 'foo/b', 'foo/c']); }); it('zero-padding examples', () => { // supports zero-padded ranges assert.deepEqual(braces('a/{01..03}/b'), ['a/(0[1-3])/b']); assert.deepEqual(braces('a/{001..300}/b'), ['a/(00[1-9]|0[1-9][0-9]|[12][0-9]{2}|300)/b']); }); }); }); braces-3.0.3/test/regression.js000066400000000000000000000507161462306110000164530ustar00rootroot00000000000000'use strict'; require('mocha'); const assert = require('assert').strict; const braces = require('..'); const equal = (input, expected, options) => { assert.deepEqual(braces.expand(input, options), expected); }; describe('braces tests from 1.8.5', () => { it('braces', () => { equal('ff{c,b,a}', ['ffc', 'ffb', 'ffa']); equal('f{d,e,f}g', ['fdg', 'feg', 'ffg']); equal('{l,n,m}xyz', ['lxyz', 'nxyz', 'mxyz']); equal('{abc\\,d,ef}', ['abc,d', 'ef']); equal('{abc}', ['{abc}']); equal('\\{a,b,c,d,e}', ['{a,b,c,d,e}']); equal('{x,y,\\{a,b,c}}', ['x}', 'y}', '{a}', 'b}', 'c}']); equal('{x\\,y,\\{abc\\},trie}', ['x,y', '{abc}', 'trie']); equal('/usr/{ucb/{ex,edit},lib/{ex,how_ex}}', ['/usr/ucb/ex', '/usr/ucb/edit', '/usr/lib/ex', '/usr/lib/how_ex']); equal('{}', ['{}']); equal('{ }', ['{ }']); equal('}', ['}']); equal('{', ['{']); equal('abcd{efgh', ['abcd{efgh']); equal('foo {1,2} bar', ['foo 1 bar', 'foo 2 bar']); }); it('new sequence brace operators', () => { equal('{1..10}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{0..10,braces}', ['0..10', 'braces']); equal('{braces,{0..10}}', ['braces', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{{0..10},braces}', ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'braces']); equal('x{{0..10},braces}y', ['x0y', 'x1y', 'x2y', 'x3y', 'x4y', 'x5y', 'x6y', 'x7y', 'x8y', 'x9y', 'x10y', 'xbracesy']); }); it('ranges', () => { equal('{3..3}', ['3']); equal('x{3..3}y', ['x3y']); equal('{10..1}', ['10', '9', '8', '7', '6', '5', '4', '3', '2', '1']); equal('{10..1}y', ['10y', '9y', '8y', '7y', '6y', '5y', '4y', '3y', '2y', '1y']); equal('x{10..1}y', ['x10y', 'x9y', 'x8y', 'x7y', 'x6y', 'x5y', 'x4y', 'x3y', 'x2y', 'x1y']); equal('{a..f}', ['a', 'b', 'c', 'd', 'e', 'f']); equal('{f..a}', ['f', 'e', 'd', 'c', 'b', 'a']); equal('{a..A}', ['a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A']); equal('{A..a}', ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a']); equal('{f..f}', ['f']); equal('0{1..9} {10..20}', ['01 10', '01 11', '01 12', '01 13', '01 14', '01 15', '01 16', '01 17', '01 18', '01 19', '01 20', '02 10', '02 11', '02 12', '02 13', '02 14', '02 15', '02 16', '02 17', '02 18', '02 19', '02 20', '03 10', '03 11', '03 12', '03 13', '03 14', '03 15', '03 16', '03 17', '03 18', '03 19', '03 20', '04 10', '04 11', '04 12', '04 13', '04 14', '04 15', '04 16', '04 17', '04 18', '04 19', '04 20', '05 10', '05 11', '05 12', '05 13', '05 14', '05 15', '05 16', '05 17', '05 18', '05 19', '05 20', '06 10', '06 11', '06 12', '06 13', '06 14', '06 15', '06 16', '06 17', '06 18', '06 19', '06 20', '07 10', '07 11', '07 12', '07 13', '07 14', '07 15', '07 16', '07 17', '07 18', '07 19', '07 20', '08 10', '08 11', '08 12', '08 13', '08 14', '08 15', '08 16', '08 17', '08 18', '08 19', '08 20', '09 10', '09 11', '09 12', '09 13', '09 14', '09 15', '09 16', '09 17', '09 18', '09 19', '09 20']); }); it('mixes are incorrectly-formed brace expansions', () => { // the first one is valid, but Bash fails on it equal('{1..f}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f']); equal('{f..1}', ['f', 'e', 'd', 'c', 'b', 'a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A', '@', '?', '>', '=', '<', ';', ':', '9', '8', '7', '6', '5', '4', '3', '2', '1']); }); it('do negative numbers work?', () => { equal('{-1..-10}', ['-1', '-2', '-3', '-4', '-5', '-6', '-7', '-8', '-9', '-10']); equal('{-20..0}', ['-20', '-19', '-18', '-17', '-16', '-15', '-14', '-13', '-12', '-11', '-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0']); }); it('weirdly-formed brace expansions -- fixed in post-bash-3.1', () => { equal('{-1..-10}', ['-1', '-2', '-3', '-4', '-5', '-6', '-7', '-8', '-9', '-10']); equal('{-20..0}', ['-20', '-19', '-18', '-17', '-16', '-15', '-14', '-13', '-12', '-11', '-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0']); equal('a-{b{d,e}}-c', ['a-{bd}-c', 'a-{be}-c']); equal('a-{bdef-{g,i}-c', ['a-{bdef-g-c', 'a-{bdef-i-c']); equal('{"klklkl"}{1,2,3}', ['{klklkl}1', '{klklkl}2', '{klklkl}3']); equal('{"x,x"}', ['{x,x}']); }); it('numerical ranges with steps', () => { equal('{1..10..2}', ['1', '3', '5', '7', '9']); equal('{-1..-10..2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-1..-10..-2}', ['-1', '-3', '-5', '-7', '-9']); equal('{10..1..-2}', ['10', '8', '6', '4', '2']); equal('{10..1..2}', ['10', '8', '6', '4', '2']); equal('{1..20..2}', ['1', '3', '5', '7', '9', '11', '13', '15', '17', '19']); equal('{1..20..20}', ['1']); equal('{100..0..5}', ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']); equal('{100..0..-5}', ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']); }); it('alpha ranges with steps', () => { equal('{a..z}', ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']); equal('{a..z..2}', ['a', 'c', 'e', 'g', 'i', 'k', 'm', 'o', 'q', 's', 'u', 'w', 'y']); equal('{z..a..-2}', ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b']); }); it('make sure brace expansion handles ints > 2**31 - 1 using intmax_t', () => { equal('{2147483645..2147483649}', ['2147483645', '2147483646', '2147483647', '2147483648', '2147483649']); }); it('unwanted zero-padding -- fixed post-bash-4.0', () => { equal('{10..0..2}', ['10', '8', '6', '4', '2', '0']); equal('{10..0..-2}', ['10', '8', '6', '4', '2', '0']); equal('{-50..-0..5}', ['-50', '-45', '-40', '-35', '-30', '-25', '-20', '-15', '-10', '-5', '0']); }); it('bad', () => { equal('{1..10.f}', ['{1..10.f}']); equal('{1..ff}', ['{1..ff}']); equal('{1..10..ff}', ['{1..10..ff}']); equal('{1.20..2}', ['{1.20..2}']); equal('{1..20..f2}', ['{1..20..f2}']); equal('{1..20..2f}', ['{1..20..2f}']); equal('{1..2f..2}', ['{1..2f..2}']); equal('{1..ff..2}', ['{1..ff..2}']); equal('{1..ff}', ['{1..ff}']); equal('{1..0f}', ['{1..0f}']); equal('{1..10f}', ['{1..10f}']); equal('{1..10.f}', ['{1..10.f}']); equal('{1..10.f}', ['{1..10.f}']); }); }); describe('bash tests', () => { describe('brace expansion', () => { it('should return an empty array when no braces are found', () => { equal('', []); }); it('should expand emty sets', () => { equal('a{,}', ['a', 'a']); equal('{,}b', ['b', 'b']); equal('a{,}b', ['ab', 'ab']); equal('a{,}', ['a', 'a']); equal('a{,}{,}', ['a', 'a', 'a', 'a']); equal('a{,}{,}{,}', ['a', 'a', 'a', 'a', 'a', 'a', 'a', 'a']); equal('{a,b{,}{,}{,}}', ['a', 'b', 'b', 'b', 'b', 'b', 'b', 'b', 'b']); equal('a{,}/{c,d}/e', ['a/c/e', 'a/d/e', 'a/c/e', 'a/d/e']); equal('{a,b{,}{,}{,},c}d', ['ad', 'bd', 'bd', 'bd', 'bd', 'bd', 'bd', 'bd', 'bd', 'cd']); }); it('should eliminate dupes in repeated strings', () => { equal('a{,}', ['a'], { nodupes: true }); equal('a{,}{,}', ['a'], { nodupes: true }); equal('a{,}{,}{,}', ['a'], { nodupes: true }); equal('{a,b{,}{,}{,}}', ['a', 'b'], { nodupes: true }); equal('{a,b{,}{,}{,},c}d', ['ad', 'bd', 'cd'], { nodupes: true }); equal('{a,b{,}{,}{,},c}d', ['ad', 'bd', 'cd'], { nodupes: true }); }); it('should work with no braces', () => { equal('abc', ['abc']); }); it('should work with no commas', () => { equal('a{b}c', ['a{b}c']); }); it('should work with no commas in `bash` mode', () => { equal('a{b}c', ['a{b}c']); }); it('should handle spaces', () => { equal('a{ ,c{d, },h}x', ['a x', 'acdx', 'ac x', 'ahx']); equal('a{ ,c{d, },h} ', ['a ', 'acd ', 'ac ', 'ah ']); // see https://github.com/jonschlinkert/micromatch/issues/66 equal('/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.{html,ejs}', [ '/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.html', '/Users/tobiasreich/Sites/aaa/bbb/ccc 2016/src/**/[^_]*.ejs' ]); }); it('should handle empty braces', () => { equal('{ }', ['{ }']); equal('{}', ['{}']); equal('}', ['}']); equal('{', ['{']); equal('{,}', ['', '']); }); it('should handle imbalanced braces', () => { equal('a-{bdef-{g,i}-c', ['a-{bdef-g-c', 'a-{bdef-i-c']); equal('abc{', ['abc{']); equal('{abc{', ['{abc{']); equal('{abc', ['{abc']); equal('}abc', ['}abc']); equal('ab{c', ['ab{c']); equal('ab{c', ['ab{c']); equal('{{a,b}', ['{a', '{b']); equal('{a,b}}', ['a}', 'b}']); equal('abcd{efgh', ['abcd{efgh']); equal('a{b{c{d,e}f}g}h', ['a{b{cdf}g}h', 'a{b{cef}g}h']); equal('f{x,y{{g,z}}h}', ['fx', 'fy{g}h', 'fy{z}h']); equal('z{a,b},c}d', ['za,c}d', 'zb,c}d']); equal('a{b{c{d,e}f{x,y{{g}h', ['a{b{cdf{x,y{{g}h', 'a{b{cef{x,y{{g}h']); equal('f{x,y{{g}h', ['f{x,y{{g}h']); equal('f{x,y{{g}}h', ['f{x,y{{g}}h']); equal('a{b{c{d,e}f{x,y{}g}h', ['a{b{cdfxh', 'a{b{cdfy{}gh', 'a{b{cefxh', 'a{b{cefy{}gh']); equal('f{x,y{}g}h', ['fxh', 'fy{}gh']); equal('z{a,b{,c}d', ['z{a,bd', 'z{a,bcd']); }); it('should handle invalid braces in `bash mode`:', () => { equal('a{b{c{d,e}f}g}h', ['a{b{cdf}g}h', 'a{b{cef}g}h']); equal('f{x,y{{g,z}}h}', ['fx', 'fy{g}h', 'fy{z}h']); equal('z{a,b},c}d', ['za,c}d', 'zb,c}d']); equal('a{b{c{d,e}f{x,y{{g}h', ['a{b{cdf{x,y{{g}h', 'a{b{cef{x,y{{g}h']); equal('f{x,y{{g}h', ['f{x,y{{g}h']); equal('f{x,y{{g}}h', ['f{x,y{{g}}h']); }); it('should return invalid braces:', () => { equal('{0..10,braces}', ['0..10', 'braces']); }); it('should not expand quoted strings.', () => { equal('{"x,x"}', ['{x,x}']); equal('{"klklkl"}{1,2,3}', ['{klklkl}1', '{klklkl}2', '{klklkl}3']); }); it('should work with one value', () => { equal('a{b}c', ['a{b}c']); equal('a/b/c{d}e', ['a/b/c{d}e']); }); it('should work with one value in `bash` mode', () => { equal('a{b}c', ['a{b}c']); equal('a/b/c{d}e', ['a/b/c{d}e']); }); it('should work with nested non-sets', () => { equal('foo {1,2} bar', ['foo 1 bar', 'foo 2 bar']); equal('{a-{b,c,d}}', ['{a-b}', '{a-c}', '{a-d}']); equal('{a,{a-{b,c,d}}}', ['a', '{a-b}', '{a-c}', '{a-d}']); }); it('should work with nested non-sets in `bash` mode', () => { equal('{a-{b,c,d}}', ['{a-b}', '{a-c}', '{a-d}']); equal('{a,{a-{b,c,d}}}', ['a', '{a-b}', '{a-c}', '{a-d}']); }); it('should not expand dots with leading slashes (escaped or paths).', () => { equal('a{b,c/*/../d}e', ['abe', 'ac/*/../de']); equal('a{b,b,c/../b}d', ['abd', 'abd', 'ac/../bd']); }); it('should work with commas.', () => { equal('a{b,}c', ['abc', 'ac']); equal('a{,b}c', ['ac', 'abc']); }); it('should expand sets', () => { equal('a/{x,y}/cde', ['a/x/cde', 'a/y/cde']); equal('a/b/c/{x,y}', ['a/b/c/x', 'a/b/c/y']); equal('ff{c,b,a}', ['ffc', 'ffb', 'ffa']); equal('f{d,e,f}g', ['fdg', 'feg', 'ffg']); equal('{l,n,m}xyz', ['lxyz', 'nxyz', 'mxyz']); equal('{x,y,{abc},trie}', ['x', 'y', '{abc}', 'trie']); }); it('should expand multiple sets', () => { equal('a/{a,b}/{c,d}/e', ['a/a/c/e', 'a/a/d/e', 'a/b/c/e', 'a/b/d/e']); equal('a{b,c}d{e,f}g', ['abdeg', 'abdfg', 'acdeg', 'acdfg']); equal('a/{x,y}/c{d,e}f.{md,txt}', ['a/x/cdf.md', 'a/x/cdf.txt', 'a/x/cef.md', 'a/x/cef.txt', 'a/y/cdf.md', 'a/y/cdf.txt', 'a/y/cef.md', 'a/y/cef.txt']); }); it('should expand nested sets', () => { equal('a/{b,c,{d,e}}/g', ['a/b/g', 'a/c/g', 'a/d/g', 'a/e/g']); equal('a/{a,b}/{c,d}/e', ['a/a/c/e', 'a/a/d/e', 'a/b/c/e', 'a/b/d/e']); equal('{a,b}{{a,b},a,b}', ['aa', 'ab', 'aa', 'ab', 'ba', 'bb', 'ba', 'bb']); equal('/usr/{ucb/{ex,edit},lib/{ex,how_ex}}', ['/usr/ucb/ex', '/usr/ucb/edit', '/usr/lib/ex', '/usr/lib/how_ex']); equal('a{b,c{d,e}f}g', ['abg', 'acdfg', 'acefg']); equal('a{{x,y},z}b', ['axb', 'ayb', 'azb']); equal('f{x,y{g,z}}h', ['fxh', 'fygh', 'fyzh']); equal('a{b,c{d,e},h}x/z', ['abx/z', 'acdx/z', 'acex/z', 'ahx/z']); equal('a{b,c{d,e},h}x{y,z}', ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'ahxy', 'ahxz']); equal('a{b,c{d,e},{f,g}h}x{y,z}', ['abxy', 'abxz', 'acdxy', 'acdxz', 'acexy', 'acexz', 'afhxy', 'afhxz', 'aghxy', 'aghxz']); equal('a-{b{d,e}}-c', ['a-{bd}-c', 'a-{be}-c']); }); it('should expand with globs.', () => { equal('a/b/{d,e}/*.js', ['a/b/d/*.js', 'a/b/e/*.js']); equal('a/**/c/{d,e}/f*.js', ['a/**/c/d/f*.js', 'a/**/c/e/f*.js']); equal('a/**/c/{d,e}/f*.{md,txt}', ['a/**/c/d/f*.md', 'a/**/c/d/f*.txt', 'a/**/c/e/f*.md', 'a/**/c/e/f*.txt']); }); it('should expand with brackets.', () => { equal('a/b/{d,e,[1-5]}/*.js', ['a/b/d/*.js', 'a/b/e/*.js', 'a/b/[1-5]/*.js']); }); }); describe('escaping:', () => { it('should not expand strings with es6/bash-like variables.', () => { equal('abc/${ddd}/xyz', ['abc/${ddd}/xyz']); equal('a${b}c', ['a${b}c']); equal('a/{${b},c}/d', ['a/${b}/d', 'a/c/d']); equal('a${b,d}/{foo,bar}c', ['a${b,d}/fooc', 'a${b,d}/barc']); }); it('should not expand escaped commas.', () => { equal('a{b\\,c}d', ['a{b,c}d']); equal('a{b\\,c\\,d}e', ['a{b,c,d}e']); equal('{abc\\,def}', ['{abc,def}']); equal('{abc\\,def,ghi}', ['abc,def', 'ghi']); equal('a/{b,c}/{x\\,y}/d/e', ['a/b/{x,y}/d/e', 'a/c/{x,y}/d/e']); }); it('should return sets with escaped commas in `bash` mode.', () => { equal('a/{b,c}/{x\\,y}/d/e', ['a/b/{x,y}/d/e', 'a/c/{x,y}/d/e']); }); it('should not expand escaped braces.', () => { equal('{a,b\\}c,d}', ['a', 'b}c', 'd']); equal('\\{a,b,c,d,e}', ['{a,b,c,d,e}']); equal('a/{b,\\{a,b,c,d,e}/d', ['a/b/d', 'a/{a/d', 'a/b/d', 'a/c/d', 'a/d/d', 'a/e/d']); equal('a/\\{b,c}/{d,e}/f', ['a/{b,c}/d/f', 'a/{b,c}/e/f']); }); it('should not expand escaped braces or commas.', () => { equal('{x\\,y,\\{abc\\},trie}', ['x,y', '{abc}', 'trie']); }); }); }); describe('range expansion', () => { it('should expand numerical ranges', () => { equal('a{0..3}d', ['a0d', 'a1d', 'a2d', 'a3d']); equal('x{10..1}y', ['x10y', 'x9y', 'x8y', 'x7y', 'x6y', 'x5y', 'x4y', 'x3y', 'x2y', 'x1y']); equal('x{3..3}y', ['x3y']); equal('{-1..-10}', ['-1', '-2', '-3', '-4', '-5', '-6', '-7', '-8', '-9', '-10']); equal('{-20..0}', ['-20', '-19', '-18', '-17', '-16', '-15', '-14', '-13', '-12', '-11', '-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1', '0']); equal('{1..10}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{1..3}', ['1', '2', '3']); equal('{1..9}', ['1', '2', '3', '4', '5', '6', '7', '8', '9']); equal('{3..3}', ['3']); equal('{5..8}', ['5', '6', '7', '8']); }); it('should expand alphabetical ranges', () => { equal('0{a..d}0', ['0a0', '0b0', '0c0', '0d0']); equal('a/{b..d}/e', ['a/b/e', 'a/c/e', 'a/d/e']); equal('{a..A}', ['a', '`', '_', '^', ']', '\\', '[', 'Z', 'Y', 'X', 'W', 'V', 'U', 'T', 'S', 'R', 'Q', 'P', 'O', 'N', 'M', 'L', 'K', 'J', 'I', 'H', 'G', 'F', 'E', 'D', 'C', 'B', 'A']); equal('{A..a}', ['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a']); equal('{a..e}', ['a', 'b', 'c', 'd', 'e']); equal('{A..E}', ['A', 'B', 'C', 'D', 'E']); equal('{a..f}', ['a', 'b', 'c', 'd', 'e', 'f']); equal('{a..z}', ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z']); equal('{E..A}', ['E', 'D', 'C', 'B', 'A']); equal('{f..a}', ['f', 'e', 'd', 'c', 'b', 'a']); equal('{f..f}', ['f']); }); it('should use steps with alphabetical ranges', () => { equal('{a..e..2}', ['a', 'c', 'e']); equal('{E..A..2}', ['E', 'C', 'A']); }); it('should not try to expand ranges with decimals', () => { equal('{1.1..2.1}', ['{1.1..2.1}']); }); it('should expand negative ranges', () => { equal('{z..a..-2}', ['z', 'x', 'v', 't', 'r', 'p', 'n', 'l', 'j', 'h', 'f', 'd', 'b']); equal('{-10..-1}', ['-10', '-9', '-8', '-7', '-6', '-5', '-4', '-3', '-2', '-1']); equal('{0..-5}', ['0', '-1', '-2', '-3', '-4', '-5']); equal('{9..-4}', ['9', '8', '7', '6', '5', '4', '3', '2', '1', '0', '-1', '-2', '-3', '-4']); }); it('should expand multiple ranges:', () => { equal('a/{b..d}/e/{f..h}', ['a/b/e/f', 'a/b/e/g', 'a/b/e/h', 'a/c/e/f', 'a/c/e/g', 'a/c/e/h', 'a/d/e/f', 'a/d/e/g', 'a/d/e/h']); }); it('should work with dots in file paths', () => { equal('../{1..3}/../foo', ['../1/../foo', '../2/../foo', '../3/../foo']); }); it('should expand ranges using steps:', () => { equal('{-1..-10..-2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-1..-10..2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-50..-0..5}', ['-50', '-45', '-40', '-35', '-30', '-25', '-20', '-15', '-10', '-5', '0']); equal('{1..10..2}', ['1', '3', '5', '7', '9']); equal('{1..20..20}', ['1']); equal('{1..20..2}', ['1', '3', '5', '7', '9', '11', '13', '15', '17', '19']); equal('{10..0..-2}', ['10', '8', '6', '4', '2', '0']); equal('{10..0..2}', ['10', '8', '6', '4', '2', '0']); equal('{10..1..-2}', ['10', '8', '6', '4', '2']); equal('{10..1..2}', ['10', '8', '6', '4', '2']); equal('{10..1}', ['10', '9', '8', '7', '6', '5', '4', '3', '2', '1']); equal('{10..1}y', ['10y', '9y', '8y', '7y', '6y', '5y', '4y', '3y', '2y', '1y']); equal('{100..0..-5}', ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']); equal('{100..0..5}', ['100', '95', '90', '85', '80', '75', '70', '65', '60', '55', '50', '45', '40', '35', '30', '25', '20', '15', '10', '5', '0']); equal('{a..z..2}', ['a', 'c', 'e', 'g', 'i', 'k', 'm', 'o', 'q', 's', 'u', 'w', 'y']); equal('{1..10..1}', ['1', '2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{1..10..2}', ['1', '3', '5', '7', '9']); equal('{1..20..20}', ['1']); equal('{1..20..2}', ['1', '3', '5', '7', '9', '11', '13', '15', '17', '19']); equal('{10..1..-2}', ['10', '8', '6', '4', '2']); equal('{10..1..2}', ['10', '8', '6', '4', '2']); equal('{2..10..1}', ['2', '3', '4', '5', '6', '7', '8', '9', '10']); equal('{2..10..2}', ['2', '4', '6', '8', '10']); equal('{2..10..3}', ['2', '5', '8']); }); it('should expand negative ranges using steps:', () => { equal('{-1..-10..-2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-1..-10..2}', ['-1', '-3', '-5', '-7', '-9']); equal('{-10..-2..2}', ['-10', '-8', '-6', '-4', '-2']); equal('{-2..-10..1}', ['-2', '-3', '-4', '-5', '-6', '-7', '-8', '-9', '-10']); equal('{-2..-10..2}', ['-2', '-4', '-6', '-8', '-10']); equal('{-2..-10..3}', ['-2', '-5', '-8']); equal('{-9..9..3}', ['-9', '-6', '-3', '0', '3', '6', '9']); }); it('should expand mixed ranges and sets:', () => { equal('x{{0..10},braces}y', ['x0y', 'x1y', 'x2y', 'x3y', 'x4y', 'x5y', 'x6y', 'x7y', 'x8y', 'x9y', 'x10y', 'xbracesy']); equal('{{0..10},braces}', ['0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'braces']); equal('{2147483645..2147483649}', ['2147483645', '2147483646', '2147483647', '2147483648', '2147483649']); }); it('should return invalid ranges:', () => { equal('{1.20..2}', ['{1.20..2}']); equal('{1..0f}', ['{1..0f}']); equal('{1..10..ff}', ['{1..10..ff}']); equal('{1..10.f}', ['{1..10.f}']); equal('{1..10f}', ['{1..10f}']); equal('{1..20..2f}', ['{1..20..2f}']); equal('{1..20..f2}', ['{1..20..f2}']); equal('{1..2f..2}', ['{1..2f..2}']); equal('{1..ff..2}', ['{1..ff..2}']); equal('{1..ff}', ['{1..ff}']); }); });