When a command has an argument with a type of
Globber for a file path, that means you can use file globbing patterns to affect more than one file at a time. Globbing patterns are common in Bash as well as places like your
.gitignore file. They use common wildcard patterns to provide a partial path that can match zero or hundreds of files all at the same time.
If a globbing pattern contains a question mark, that will match any single character. So a pattern of
ca?.txt would match
cat.txt, but not
cart.txt. You can use a wildcard more than once.
p?p?.cf? would match files named
If a globbing pattern contains a single asterisks, that will match zero or more characters inside a filename or folder name. So
dao, and just
do. The wildcard only counts inside a file or folder name, so
models/*.cfc will only match cfc files in the root of the models folder.
To extend the previous example, if we did
models/**.cfc that would match any cfc file in any subdirectory, no matter how deep.
Here's some examples of what file globbing might look like:
CommandBox> rm temp*.txtCommandBox> cp *.cfm backup/CommandBox> touch build/*.properties
Here's some more examples of how the wildcards work
// Match any file or folder starting with "foo"foo*// Match any file or folder starting with "foo" and ending with .txtfoo*.txt// Match any file or folder ending with "foo"*foo// Match a/b/z but not a/b/c/za/*/z// Match a/z and a/b/z and a/b/c/za/**/z// Matches hat but not ham or h/t/h?t
Since the Globber library can handle more than one globbing pattern, any command that uses a Globber type can accept a comma-delimited list of patterns. The following will list any .cfm AND .md files in the directory.