lambdaisland.shellutils — com.lambdaisland/shellutils 0.3.20

Globbing and other shell-like filename handling, and subshell handling

Extracted from https://github.com/lambdaisland/open-source and further improved

*cwd* clj

Current working directory

Relative paths are resolved starting from this location, and it is used for subshells. Defaults to the CWD of the JVM, as exposed through the 'user.dir' property.

absolute? clj

(absolute? f)

The File contains an absolute path

basename clj

(basename path)

Get the name of the file without any directory components

bash clj

(bash & args)

Interpret the command as a bash script, allows using redirects, pipes and other bash features.

canonicalize clj

(canonicalize path)

Return a canonical path

Resolves symlinks and makes relative paths absolute

cli-opts clj

(cli-opts)

Options map from lambdaisland.cli, if it is used. We auto-detect certain flags, like --dry-run.

dirname clj

extension clj

(extension file)

Get the extension of the file without the dot

This function does not have special handling for files that start with a dot (hidden files on Unix-family systems).

fatal clj

(fatal & msg)

file clj

(file path)

java.io.File constructor

Resolves relative paths relative to *cwd*

filter-files clj

(filter-files files re)

Filter list of files for names matching pattern re

glob clj

(glob pattern)

Returns a seq of java.io.File instances that match the given glob pattern. Ignores dot files unless explicitly included.

Examples: (glob ".{jpg,gif}") (glob ".") (glob "/usr//se")

Based on https://github.com/jkk/clj-glob/blob/b1df67efb003f0e372c914346209d41c6df78e20/src/org/satta/glob.clj

but with some improvements.

Joinable clj protocol

join clj

(join this that)

Join Strings, Paths, and Files into a single Path.

ls clj

(ls dir)

List directory contents

mkdir-p clj

(mkdir-p dir)

Make directory including parents

parent-file clj

(parent-file dir)

process-builder clj

(process-builder args)

relative? clj

(relative? f)

The File contains a relative path

relativize clj

(relativize base path)

Turn an absolute path and a base path into a relative path

shellquote clj

(shellquote a)

slurp-cwd clj

(slurp-cwd f)

spawn clj

(spawn & args)

Like [[clojure.java.shell/sh]], but inherit IO stream from the parent process, and prints out the invocation. By default terminates when a command fails (non-zero exit code).

If the last argument is a map, it is used for options

• :dir Directory to execute in
• :continue-on-error? Should a non-zero exit code be ignored.
• :fail-message Error message to show when the command returns a non-zero exit code

spit-cwd clj

(spit-cwd f c)

strip-ext clj

(strip-ext file)

Remove the extension from the file

temp-dir clj

(temp-dir)

(temp-dir path)

with-cwd clj macro

(with-cwd cwd & body)

Execute body with *cwd* set to cwd.

with-temp-cwd clj macro

(with-temp-cwd & body)

Same as with-cwd except that it creates a temp dir in cwd and evals the body inside it.

It cleans up the temp dir afterwards also removing any temp files created within it.