babashka.fs — babashka/fs 0.2.13

absolute? clj

(absolute? f)

Returns true if f represents an absolute path.

absolutize clj

(absolutize f)

Converts f into an absolute path via Path#toAbsolutePath.

canonicalize clj

(canonicalize f)

(canonicalize f {:keys [:nofollow-links]})

Returns the canonical path via java.io.File#getCanonicalPath. If :nofollow-links is set, then it will fall back on absolutize + normalize. This function can be used as an alternative to real-path which requires files to exist.

components clj

(components f)

Returns a seq of all components of f as paths, i.e. split on the file separator.

copy clj

(copy src dest)

(copy src dest {:keys [:replace-existing :copy-attributes :nofollow-links]})

Copies src file to dest dir or file. Options:

• :replace-existing
• :copy-attributes
• :nofollow-links (used to determine to copy symbolic link itself or not).

copy-tree clj

(copy-tree src dest)

(copy-tree src
           dest
           {:keys [:replace-existing :copy-attributes :nofollow-links]
            :as opts})

Copies entire file tree from src to dest. Creates dest if needed using create-dirs, passing it the :posix-file-permissions option. Supports same options as copy.

create-dir clj

(create-dir path)

(create-dir path {:keys [:posix-file-permissions]})

Creates dir using Files#createDirectory. Does not create parents.

create-dirs clj

(create-dirs path)

(create-dirs path {:keys [:posix-file-permissions]})

Creates directories using Files#createDirectories. Also creates parents if needed. Doesn't throw an exception if the the dirs exist already. Similar to mkdir -p

create-file clj

(create-file path)

(create-file path {:keys [:posix-file-permissions]})

Creates empty file using Files#createFile.

create-link clj

(create-link path target)

Create a hard link from path to target.

create-sym-link clj

(create-sym-link path target)

Create a soft link from path to target.

create-temp-dir clj

(create-temp-dir)

(create-temp-dir {:keys [:prefix :path :posix-file-permissions]})

Creates a temporary directory using Files#createDirectories.

(create-temp-dir): creates temp dir with random prefix. (create-temp-dir {:keys [:prefix :path :posix-file-permissions]}):

create temp dir in path with prefix. If prefix is not provided, a random one is generated. If path is not provided, the directory is created as if called with (create-temp-dir). The :posix-file-permissions option is a string like "rwx------".

create-temp-file clj

(create-temp-file)

(create-temp-file {:keys [:path :prefix :suffix :posix-file-permissions]})

Creates an empty temporary file using Files#createTempFile.

• (create-temp-file): creates temp file with random prefix and suffix.
• (create-temp-dir {:keys [:prefix :suffix :path :posix-file-permissions]}): create temp file in path with prefix. If prefix and suffix are not provided, random ones are generated. The :posix-file-permissions option is a string like "rwx------".

creation-time clj

(creation-time f)

(creation-time f {:keys [nofollow-links] :as opts})

Returns creation time as FileTime.

cwd clj

(cwd)

Returns current working directory as path

delete clj

(delete f)

Deletes f. Returns nil if the delete was successful, throws otherwise. Does not follow symlinks.

delete-if-exists clj

(delete-if-exists f)

Deletes f if it exists. Returns true if the delete was successful, false if f didn't exist. Does not follow symlinks.

delete-on-exit clj

(delete-on-exit f)

Requests delete on exit via File#deleteOnExit. Returns f.

delete-tree clj

(delete-tree root)

Deletes a file tree using walk-file-tree. Similar to rm -rf. Does not follow symlinks.

directory? clj

(directory? f)

(directory? f {:keys [:nofollow-links]})

Returns true if f is a directory, using Files/isDirectory.

ends-with? clj

(ends-with? this other)

Returns true if path this ends with path other.

exec-paths clj

(exec-paths)

Returns executable paths (using the PATH environment variable). Same as (split-paths (System/getenv "PATH")).

executable? clj

(executable? f)

Returns true if f is executable.

exists? clj

(exists? f)

(exists? f {:keys [:nofollow-links]})

Returns true if f exists.

expand-home clj

(expand-home f)

If path begins with a tilde (~), expand the tilde to the value of the user.home system property. If the path begins with a tilde immediately followed by some characters, they are assumed to be a username. This is expanded to the path to that user's home directory. This is (naively) assumed to be a directory with the same name as the user relative to the parent of the current value of user.home.

extension clj

(extension path)

Returns the extension of a file via split-ext.

file clj

(file f)

(file f & fs)

Coerces f into a File. Multiple-arg versions treat the first argument as parent and subsequent args as children relative to the parent.

file-name clj

(file-name x)

Returns the name of the file or directory. E.g. (file-name "foo/bar/baz") returns "baz".

file-separator clj

file-time->instant clj

(file-time->instant ft)

Converts a java.nio.file.attribute.FileTime to a java.time.Instant.

file-time->millis clj

(file-time->millis ft)

Converts a java.nio.file.attribute.FileTime to epoch millis (long).

get-attribute clj

(get-attribute path attribute)

(get-attribute path attribute {:keys [:nofollow-links]})

glob clj

(glob root pattern)

(glob root pattern opts)

Given a file and glob pattern, returns matches as vector of paths. Patterns containing ** or / will cause a recursive walk over path, unless overriden with :recursive. Glob interpretation is done using the rules described in https://docs.oracle.com/javase/7/docs/api/java/nio/file/FileSystem.html#getPathMatcher(java.lang.String).

Options:

• :hidden: match hidden paths. Note: on Windows files starting with a dot are not hidden, unless their hidden attribute is set.
• :follow-links: follow symlinks.
• :recursive: force recursive search.

Examples: (fs/glob "." "**.clj")

hidden? clj

(hidden? f)

Returns true if f is hidden.

home clj

(home)

(home user)

With no arguments, returns the current value of the user.home system property. If a user is passed, returns that user's home directory as found in the parent of home with no args.

instant->file-time clj

(instant->file-time instant)

Converts a java.time.Instant to a java.nio.file.attribute.FileTime.

last-modified-time clj

(last-modified-time f)

(last-modified-time f {:keys [nofollow-links] :as opts})

Returns last modified time as a java.nio.file.attribute.FileTime.

list-dir clj

(list-dir dir)

(list-dir dir glob-or-accept)

Returns all paths in dir as vector. For descending into subdirectories use glob.

• glob-or-accept - a glob string such as "*.edn" or a (fn accept [^java.nio.file.Path p]) -> truthy

list-dirs clj

(list-dirs dirs glob-or-accept)

Similar to list-dir but accepts multiple roots and returns the concatenated results.

• glob-or-accept - a glob string such as "*.edn" or a (fn accept [^java.nio.file.Path p]) -> truthy

match clj

(match root pattern)

(match root pattern {:keys [hidden follow-links max-depth recursive]})

Given a file and match pattern, returns matches as vector of paths. Pattern interpretation is done using the rules described in https://docs.oracle.com/javase/7/docs/api/java/nio/file/FileSystem.html#getPathMatcher(java.lang.String).

Options:

• :hidden: match hidden paths - note: on Windows paths starting with a dot are not hidden, unless their hidden attribute is set.
• :follow-links: - follow symlinks
• :recursive: - match recursively.
• :max-depth: - max depth to descend into directory structure.

Examples: (fs/match "." "regex:.*\\.clj" {:recursive true})

millis->file-time clj

(millis->file-time millis)

Converts epoch millis (long) to a java.nio.file.attribute.FileTime.

modified-since clj

(modified-since anchor file-set)

Returns seq of regular files (non-directories, non-symlinks) from file-set that were modified since the anchor path. The anchor path can be a regular file or directory, in which case the recursive max last modified time stamp is used as the timestamp to compare with. The file-set may be a regular file, directory or collection of files (e.g. returned by glob). Directories are searched recursively.

move clj

(move source target)

(move source target {:keys [:replace-existing :atomic-move :nofollow-links]})

Move or rename a file to a target dir or file via Files/move.

normalize clj

(normalize f)

Normalizes f via Path#normalize.

parent clj

(parent f)

Returns parent of f, is it exists. Akin to dirname in bash.

path clj

(path f)

(path parent child)

(path parent child & more)

Coerces f into a Path. Multiple-arg versions treat the first argument as parent and subsequent args as children relative to the parent.

path-separator clj

posix->str clj

(posix->str p)

Converts a set of PosixFilePermission to a string.

posix-file-permissions clj

(posix-file-permissions f)

(posix-file-permissions f {:keys [:nofollow-links]})

Gets f's posix file permissions. Use posix->str to view as a string.

read-all-bytes clj

(read-all-bytes f)

Returns contents of file as byte array.

read-all-lines clj

(read-all-lines f)

(read-all-lines f {:keys [charset] :or {charset "utf-8"}})

Read all lines from a file.

read-attributes clj

(read-attributes path attributes)

(read-attributes path attributes {:keys [:nofollow-links :key-fn] :as opts})

Same as read-attributes* but turns attributes into a map and keywordizes keys. Keywordizing can be changed by passing a :key-fn in the options map.

read-attributes* clj

(read-attributes* path attributes)

(read-attributes* path attributes {:keys [:nofollow-links]})

Reads attributes via Files/readAttributes.

readable? clj

(readable? f)

Returns true if f is readable

real-path clj

(real-path f)

(real-path f {:keys [:nofollow-links]})

Converts f into real path via Path#toRealPath.

regular-file? clj

(regular-file? f)

(regular-file? f {:keys [:nofollow-links]})

Returns true if f is a regular file, using Files/isRegularFile.

relative? clj

(relative? f)

Returns true if f represents a relative path.

relativize clj

(relativize this other)

Returns relative path by comparing this with other.

same-file? clj

(same-file? this other)

Returns true if this is the same file as other.

set-attribute clj

(set-attribute path attribute value)

(set-attribute path attribute value {:keys [:nofollow-links]})

set-creation-time clj

(set-creation-time f time)

(set-creation-time f time {:keys [nofollow-links] :as opts})

Sets creation time of f to time (millis, java.time.Instant or java.nio.file.attribute.FileTime).

set-last-modified-time clj

(set-last-modified-time f time)

(set-last-modified-time f time {:keys [nofollow-links] :as opts})

Sets last modified time of f to time (millis, java.time.Instant or java.nio.file.attribute.FileTime).

set-posix-file-permissions clj

(set-posix-file-permissions f posix-file-permissions)

Sets posix file permissions on f. Accepts a string like "rwx------" or a set of PosixFilePermission.

size clj

(size f)

Returns the size of a file (in bytes).

split-ext clj

(split-ext path)

(split-ext path {:keys [ext]})

Splits path on extension If provided, a specific extension ext, the extension (without dot), will be used for splitting. Directories are not processed.

split-paths clj

(split-paths joined-paths)

Splits a string joined by the OS-specific path-seperator into a vec of paths.

starts-with? clj

(starts-with? this other)

Returns true if path this starts with path other.

str->posix clj

(str->posix s)

Converts a string to a set of PosixFilePermission.

strip-ext clj

(strip-ext path)

(strip-ext path {:keys [ext] :as opts})

Strips extension via split-ext.

sym-link? clj

(sym-link? f)

Determines if f is a symbolic link via java.nio.file.Files/isSymbolicLink.

temp-dir clj

(temp-dir)

Returns java.io.tmpdir property as path.

unixy clj

(unixy f)

Returns path as string with Unix-style file separators (/). Returns argument unchanged on non-Windows systems.

unzip clj

(unzip zip-file)

(unzip zip-file dest)

(unzip zip-file dest {:keys [replace-existing]})

Unzips zip-file to dest directory (default ".").

Options:

• :replace-existing - true / false: overwrite existing files

update-file clj

(update-file file f & xs)

(update-file file opts f & xs)

Updates the contents of text file path using f applied to old contents and xs. Returns the new contents.

Options:

• :charset - charset of file, default to "utf-8"

walk-file-tree clj

(walk-file-tree f
                {:keys [:pre-visit-dir :post-visit-dir :visit-file
                        :visit-file-failed :follow-links :max-depth]})

Walks f using Files/walkFileTree. Visitor functions: :pre-visit-dir, :post-visit-dir, :visit-file, :visit-file-failed. All visitor functions default to (constantly :continue). Supported return values: :continue, :skip-subtree, :skip-siblings, :terminate. A different return value will throw.

which clj

(which program)

(which program opts)

Returns Path to first program found in (exec-paths), similar to the which Unix command.

On Windows, also searches for program with filename extensions specified in :win-exts opt. Default is ["com" "exe" "bat" "cmd"]. If program already includes an extension from :win-exts, it will be searched as-is first.

which-all clj

(which-all program)

(which-all program opts)

Returns every Path to program found in (exec-paths). See which.

windows? clj

(windows?)

Returns true if OS is Windows.

with-temp-dir clj macro

(with-temp-dir [binding-name options] & body)

Evaluate body with binding-name bound to a temporary directory.

The directory is created by passing options to create-temp-dir, and will be removed with delete-tree on exit from the scope.

options is a map with the keys as for create-temp-dir.

writable? clj

(writable? f)

Returns true if f is writable

write-bytes clj

(write-bytes path bytes)

(write-bytes path
             bytes
             {:keys [append create truncate-existing write] :as opts})

Writes bytes to path via java.nio.file.Files/write. Supported options:

• :create (default true)
• :truncate-existing (default true)
• :write (default true)
• :append (default false)
• or any java.nio.file.StandardOption.

Examples:

(fs/write-bytes f (.getBytes (String. "foo"))) ;; overwrites + truncates or creates new file
(fs/write-bytes f (.getBytes (String. "foo")) {:append true})

write-lines clj

(write-lines path lines)

(write-lines path lines {:keys [charset] :or {charset "utf-8"} :as opts})

Writes lines, a seqable of strings to path via java.nio.file.Files/write.

Supported options:

• :charset (default "utf-8")

Supported open options:

• :create (default true)
• :truncate-existing (default true)
• :write (default true)
• :append (default false)
• or any java.nio.file.StandardOption.

zip clj

(zip zip-file entries)

(zip zip-file entries _opts)

Zips entry or entries into zip-file. An entry may be a file or directory. Directories are included recursively and their names are preserved in the zip file. Currently only accepts relative entries.