Skip to content

Latest commit

 

History

History
228 lines (165 loc) · 4.81 KB

README.md

File metadata and controls

228 lines (165 loc) · 4.81 KB
Raw

bracer

CRAN Status Badge R-CMD-check Coverage Status

Table of Contents

Overview

{bracer} provides support for performing brace expansions on strings in R.

Examples

library("bracer")
options(bracer.engine = "r")
expand_braces("Foo{A..F}")
## [1] "FooA" "FooB" "FooC" "FooD" "FooE" "FooF"

expand_braces("Foo{01..10}")
##  [1] "Foo01" "Foo02" "Foo03" "Foo04" "Foo05" "Foo06" "Foo07" "Foo08" "Foo09"
## [10] "Foo10"

expand_braces("Foo{A..E..2}{1..5..2}")
## [1] "FooA1" "FooA3" "FooA5" "FooC1" "FooC3" "FooC5" "FooE1" "FooE3" "FooE5"

expand_braces("Foo{-01..1}")
## [1] "Foo-01" "Foo000" "Foo001"

expand_braces("Foo{{d..d},{bar,biz}}.{py,bash}")
## [1] "Food.py"     "Food.bash"   "Foobar.py"   "Foobar.bash" "Foobiz.py"  
## [6] "Foobiz.bash"

expand_braces() is vectorized and returns one big character vector of all the brace expansions. str_expand_braces() is an alternative that returns a list of character vectors.

expand_braces(c("Foo{A..F}", "Bar.{py,bash}", "{{Biz}}"))
## [1] "FooA"     "FooB"     "FooC"     "FooD"     "FooE"     "FooF"     "Bar.py"  
## [8] "Bar.bash" "{{Biz}}"

str_expand_braces(c("Foo{A..F}", "Bar.{py,bash}", "{{Biz}}"))
## [[1]]
## [1] "FooA" "FooB" "FooC" "FooD" "FooE" "FooF"
## 
## [[2]]
## [1] "Bar.py"   "Bar.bash"
## 
## [[3]]
## [1] "{{Biz}}"

glob() is a wrapper around Sys.glob() that uses expand_braces() to support both brace and wildcard expansion on file paths.

glob("R/*.{R,r,S,s}")
## [1] "R/engine-r.R"      "R/engine-v8.R"     "R/expand_braces.R"
## [4] "R/glob.R"

Installation

To install the release version on CRAN use the following command in R:

install.packages("bracer")

To install the developmental version use the following command in R:

remotes::install_github("trevorld/bracer")

Installing the suggested {V8} package will enable use of the javascript alternative parser:

install.packages("V8")

Limitations of pure R parser and alternative javascript parser

The {bracer} pure R parser currently does not properly support the "correct" (Bash-style) brace expansion under several edge conditions such as:

  1. Unbalanced braces e.g. {{a,d} (but you could use an escaped brace instead \\{{a,d})
  2. Using surrounding quotes to escape terms e.g. {'a,b','c'} (but you could use an escaped comma instead {a\\,b,c})
  3. Escaped braces within comma-separated lists e.g. {a,b\\}c,d}
  4. (Non-escaping) backslashes before braces e.g. {a,\\\\{a,b}c}
  5. Sequences from letters to non-letter ASCII characters e.g. X{a..#}X
options(bracer.engine = "r")
expand_braces("{{a,d}")
## [1] "{{a,d}"

expand_braces("{'a,b','c'}")
## [1] "'a"  "b'"  "'c'"

expand_braces("{a,b\\}c,d}")
## [1] "a,b}c" "d"

expand_braces("{a,\\\\{a,b}c}")
## [1] "ac}"  "{ac}" "bc}"

expand_braces("X{a..#}X")
## [1] "X{a..#}X"

However if the {V8} suggested R package is installed we can instead use an embedded version of the braces Javascript library which can correctly handle these edge cases. To do so we need to set the bracer "engine" to "v8".

options(bracer.engine = "v8")
expand_braces("{{a,d}")
## [1] "{a" "{d"

expand_braces("{'a,b','c'}")
## [1] "a,b" "c"

expand_braces("{a,b\\}c,d}")
## [1] "a"   "b}c" "d"

expand_braces("{a,\\\\{a,b}c}")
## [1] "a"    "\\ac" "\\bc"

expand_braces("X{a..#}X")
##  [1] "XaX"  "X`X"  "X_X"  "X^X"  "X]X"  "X\\X" "X[X"  "XZX"  "XYX"  "XXX" 
## [11] "XWX"  "XVX"  "XUX"  "XTX"  "XSX"  "XRX"  "XQX"  "XPX"  "XOX"  "XNX" 
## [21] "XMX"  "XLX"  "XKX"  "XJX"  "XIX"  "XHX"  "XGX"  "XFX"  "XEX"  "XDX" 
## [31] "XCX"  "XBX"  "XAX"  "X@X"  "X?X"  "X>X"  "X=X"  "X<X"  "X;X"  "X:X" 
## [41] "X9X"  "X8X"  "X7X"  "X6X"  "X5X"  "X4X"  "X3X"  "X2X"  "X1X"  "X0X" 
## [51] "X/X"  "X.X"  "X-X"  "X,X"  "X+X"  "X*X"  "X)X"  "X(X"  "X'X"  "X&X" 
## [61] "X%X"  "X$X"  "X#X"