murex Shell Docs

Command Reference: g

Glob pattern matching for file system objects (eg *.txt)

Description

Returns a list of files and directories that match a glob pattern.

Output is a JSON list.

Usage

g: pattern -> <stdout>

Examples

# inline globbing
cat: @{ g: *.txt }

# writing a JSON array of files to disk
g: *.txt -> > filelist.json

# writing a list of files to disk
g: *.txt -> format str -> > filelist.txt

# checking if a file exists
if { g: somefile.txt } then {
    # file exists
}

# checking if a file does not exist
!if { g: somefile.txt } then {
    # file does not exist
}

Detail

Pattern reference

Auto-globbing

Any command prefixed with @g will be auto-globbed. For example, the two following commands will produce the same output:

» ls @{g: *.go}
benchmarks_test.go  defaults_test.go  flags.go  godoc.go  main.go  murex_test.go

» @g ls *.go
benchmarks_test.go  defaults_test.go  flags.go  godoc.go  main.go  murex_test.go

The rational behind the ugly @g syntax is simply to make one-liners a bit less painful when coming from more traditional POSIX-like shells (eg Bash) where wildcards are automatically expanded. So if you type ls * (for example) then realise you've forgotten to subshell, you can just recall the last command with auto-globbing enabled:

@g ^!!

Synonyms

See Also

This site's content is rebuilt automatically from murex's source code after each merge to the master branch. Downloadable murex binaries are also built with the website.

Last built on Tue Jun 22 08:18:17 UTC 2021 against commit 2235c7b2235c7b18f86f1cf214e246b88b0ea193d87fe80.

Current version is 2.2.1100 BETA which has been verified against tests.