babashka.fsabsolute?- Returns true if f represents an absolute path.absolutize- Converts f into an absolute path via Path#toAbsolutePath.canonicalize- Returns the canonical path via java.io.File#getCanonicalPath.components- Returns a seq of all components of f as paths, i.e.copy- Copies src file to dest dir or file.copy-tree- Copies entire file tree from src to dest.create-dir- Creates dir usingFiles#createDirectory.create-dirs- Creates directories usingFiles#createDirectories.create-file- Creates empty file usingFiles#createFile.create-link- Create a hard link from path to target.create-sym-link- Create a soft link from path to target.create-temp-dir- Creates a temporary directory using Files#createDirectories.create-temp-file- Creates an empty temporary file using Files#createTempFile.creation-time- Returns creation time as FileTime.cwd- Returns current working directory as path.delete- Deletes f.delete-if-exists- Deletes f if it exists.delete-on-exit- Requests delete on exit viaFile#deleteOnExit.delete-tree- Deletes a file tree usingwalk-file-tree.directory?- Returns true if f is a directory, using Files/isDirectory.ends-with?- Returns true if path this ends with path other.exec-paths- Returns executable paths (using the PATH environment variable).executable?- Returns true if f is executable.exists?- Returns true if f exists.expand-home- Ifpathbegins with a tilde (~), expand the tilde to the value of theuser.homesystem property.extension- Returns the extension of a file viasplit-ext.file- Coerces f into a File.file-name- Returns the name of the file or directory.file-separatorfile-time->instant- Converts a java.nio.file.attribute.FileTime to a java.time.Instant.file-time->millis- Converts a java.nio.file.attribute.FileTime to epoch millis (long).get-attributeglob- Given a file and glob pattern, returns matches as vector of paths.gunzip- Extractsgz-filetodestdirectory (default".").gzip- Gzipssource-fileand writes the output todir/out-file.hidden?- Returns true if f is hidden.home- With no arguments, returns the current value of theuser.homesystem property.instant->file-time- Converts a java.time.Instant to a java.nio.file.attribute.FileTime.last-modified-time- Returns last modified time as a java.nio.file.attribute.FileTime.list-dir- Returns all paths in dir as vector.list-dirs- Similar to list-dir but accepts multiple roots and returns the concatenated results.match- Given a file and match pattern, returns matches as vector of paths.millis->file-time- Converts epoch millis (long) to a java.nio.file.attribute.FileTime.modified-since- Returns seq of regular files (non-directories, non-symlinks) from file-set that were modified since the anchor path.move- Move or rename a file to a target dir or file viaFiles/move.normalize- Normalizes f via Path#normalize.owner- Returns the owner of a file.parent- Returns parent of f.path- Coerces f into a Path.path-separatorposix->str- Converts a set of PosixFilePermission to a string.posix-file-permissionsread-all-bytes- Returns contents of file as byte array.read-all-lines- Read all lines from a file.read-attributes- Same asread-attributes*but turns attributes into a map and keywordizes keys.read-attributes*- Reads attributes via Files/readAttributes.read-link- Reads the target of a symbolic link.readable?- Returns true if f is readable.real-path- Converts f into real path via Path#toRealPath.regular-file?- Returns true if f is a regular file, using Files/isRegularFile.relative?- Returns true if f represents a relative path.relativize- Returns relative path by comparing this with other.same-file?- Returns true if this is the same file as other.set-attributeset-creation-time- Sets creation time of f to time (millis, java.time.Instant or java.nio.file.attribute.FileTime).set-last-modified-time- Sets last modified time of f to time (millis, java.time.Instant or java.nio.file.attribute.FileTime).set-posix-file-permissionssize- Returns the size of a file (in bytes).split-ext- Splits path on extension If provided, a specific extensionext, the extension (without dot), will be used for splitting.split-paths- Splits a path list given as a string joined by the OS-specific path-separator into a vec of paths.starts-with?- Returns true if path this starts with path other.str->posix- Converts a string to a set of PosixFilePermission.strip-ext- Strips extension viasplit-ext.sym-link?- Determines iffis a symbolic link viajava.nio.file.Files/isSymbolicLink.temp-dir- Returnsjava.io.tmpdirproperty as path.unixify- Returns path as string with Unix-style file separators (/).unzip- Unzipszip-filetodestdirectory (default".").update-file- Updates the contents of text filepathusingfapplied to old contents andxs.walk-file-tree- Walks f using Files/walkFileTree.which- Returns Path to first executableprogramfound in:pathsopt, similar to the which Unix command.which-all- Returns every Path toprogramfound in (exec-paths).windows?- Returns true if OS is Windows.with-temp-dir- Evaluate body with binding-name bound to a temporary directory.writable?- Returns true if f is writable.write-bytes- Writesbytestopathviajava.nio.file.Files/write.write-lines- Writeslines, a seqable of strings topathviajava.nio.file.Files/write.xdg-cache-home- Path representing the base directory relative to which user-specific non-essential data files should be stored as described in the XDG Base Directory Specification.xdg-config-home- Path representing the base directory relative to which user-specific configuration files should be stored as described in the XDG Base Directory Specification.xdg-data-home- Path representing the base directory relative to which user-specific data files should be stored as described in the XDG Base Directory Specification.xdg-state-home- Path representing the base directory relative to which user-specific state files should be stored as described in the XDG Base Directory Specification.zip- Zips entry or entries into zip-file.
(absolute? f)Returns true if f represents an absolute path.
(absolutize f)Converts f into an absolute path via Path#toAbsolutePath.
(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 f)Returns a seq of all components of f as paths, i.e. split on the file separator.
(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 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 path)
(create-dir path {:keys [:posix-file-permissions]})Creates dir using Files#createDirectory. Does not create parents.
(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 dirs exist already. Similar to mkdir -p
(create-file path)
(create-file path {:keys [:posix-file-permissions]})Creates empty file using Files#createFile.
File permissions can be specified with an :posix-file-permissions option.
String format for posix file permissions is described in the str->posix docstring.
(create-link path target)Create a hard link from path to target.
(create-sym-link path target)Create a soft link from path to target.
(create-temp-dir)
(create-temp-dir {:keys [:dir :prefix :posix-file-permissions], :as opts})Creates a temporary directory using Files#createDirectories.
-
(create-temp-dir): creates temp dir with random prefix. -
(create-temp-dir {:keys [:dir :prefix :posix-file-permissions]}): create temp dir in dir 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). File permissions can be specified with an:posix-file-permissionsoption. String format for posix file permissions is described in thestr->posixdocstring.
(create-temp-file)
(create-temp-file {:keys [:dir :prefix :suffix :posix-file-permissions], :as opts})Creates an empty temporary file using Files#createTempFile.
-
(create-temp-file): creates temp file with random prefix and suffix. -
(create-temp-file {:keys [:dir :prefix :suffix :posix-file-permissions]}): create temp file in dir with prefix. If prefix and suffix are not provided, random ones are generated. File permissions can be specified with an:posix-file-permissionsoption. String format for posix file permissions is described in thestr->posixdocstring.
(creation-time f)
(creation-time f {:keys [nofollow-links], :as opts})Returns creation time as FileTime.
(cwd)Returns current working directory as path
(delete f)Deletes f. Returns nil if the delete was successful, throws otherwise. Does not follow symlinks.
(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 f)Requests delete on exit via File#deleteOnExit. Returns f.
(delete-tree root)
(delete-tree root {:keys [force]})Deletes a file tree using walk-file-tree. Similar to rm -rf. Does not follow symlinks.
force ensures read-only directories/files are deleted. Similar to chmod -R +wx + rm -rf
(directory? f)
(directory? f {:keys [:nofollow-links]})Returns true if f is a directory, using Files/isDirectory.
(ends-with? this other)Returns true if path this ends with path other.
(exec-paths)Returns executable paths (using the PATH environment variable). Same
as (split-paths (System/getenv "PATH")).
(executable? f)Returns true if f is executable.
(exists? f)
(exists? f {:keys [:nofollow-links]})Returns true if f exists.
(expand-home f)If [path](#babashka.fs/path) begins with a tilde (~), expand the tilde to the value
of the user.home system property. If the [path](#babashka.fs/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 path)Returns the extension of a file via split-ext.
(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 x)Returns the name of the file or directory. E.g. (file-name "foo/bar/baz") returns "baz".
(file-time->instant ft)Converts a java.nio.file.attribute.FileTime to a java.time.Instant.
(file-time->millis ft)Converts a java.nio.file.attribute.FileTime to epoch millis (long).
(get-attribute path attribute)
(get-attribute path attribute {:keys [:nofollow-links]})(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. Similarly: :hidden will be enabled (when not set)
when pattern starts with a dot.
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. Implied whenpatternstarts with a dot. 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. Implied whenpatterncontains**or/.:max-depth- max depth to descend into directory structure.
Examples:
(fs/glob "." "**.clj")
(gunzip gz-file)
(gunzip gz-file dest)
(gunzip gz-file dest {:keys [replace-existing]})Extracts gz-file to dest directory (default ".").
Options:
:replace-existing-true/false: overwrite existing files
(gzip source-file)
(gzip source-file {:keys [dir out-file], :or {dir "."}})Gzips source-file and writes the output to dir/out-file.
If out-file is not provided, the source-file name with .gz appended is used.
If dir is not provided, the current directory is used.
Returns the created gzip file.
(hidden? f)Returns true if f is hidden.
(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 instant)Converts a java.time.Instant to a java.nio.file.attribute.FileTime.
(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 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 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 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 millis)Converts epoch millis (long) to a java.nio.file.attribute.FileTime.
(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 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 f)Normalizes f via Path#normalize.
(owner f)
(owner f {:keys [:nofollow-links]})Returns the owner of a file. Call str on it to get the owner name
as a string.
(parent f)Returns parent of f. Akin to dirname in bash.
(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.
(posix->str p)Converts a set of PosixFilePermission to a string.
(read-all-bytes f)Returns contents of file as byte array.
(read-all-lines f)
(read-all-lines f {:keys [charset], :or {charset "utf-8"}})Read all lines from a file.
(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* path attributes)
(read-attributes* path attributes {:keys [:nofollow-links]})Reads attributes via Files/readAttributes.
(read-link path)Reads the target of a symbolic link. The target need not exist.
(readable? f)Returns true if f is readable
(real-path f)
(real-path f {:keys [:nofollow-links]})Converts f into real path via Path#toRealPath.
(regular-file? f)
(regular-file? f {:keys [:nofollow-links]})Returns true if f is a regular file, using Files/isRegularFile.
(relative? f)Returns true if f represents a relative path.
(relativize this other)Returns relative path by comparing this with other.
(same-file? this other)Returns true if this is the same file as other.
(set-attribute path attribute value)
(set-attribute path attribute value {:keys [:nofollow-links]})(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 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).
(size f)Returns the size of a file (in bytes).
(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 joined-paths)Splits a path list given as a string joined by the OS-specific path-separator into a vec of paths. On UNIX systems, the separator is ':', on Microsoft Windows systems it is ';'.
(starts-with? this other)Returns true if path this starts with path other.
(str->posix s)Converts a string to a set of PosixFilePermission.
s is a string like "rwx------".
(strip-ext path)
(strip-ext path {:keys [ext], :as opts})Strips extension via split-ext.
(sym-link? f)Determines if f is a symbolic link via java.nio.file.Files/isSymbolicLink.
(temp-dir)Returns java.io.tmpdir property as path.
(unixify f)Returns path as string with Unix-style file separators (/).
(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 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 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 program)
(which program opts)Returns Path to first executable program found in :paths opt, similar to the which Unix command.
Default for :paths is (exec-paths).
On Windows, 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.
When program is a relative or absolute path, :paths is not consulted. On Windows, the :win-exts
variants are still searched. On other OSes, the path for program will be returned if executable,
else nil.
(which-all program)
(which-all program opts)Returns every Path to program found in (exec-paths). See which.
(windows?)Returns true if OS is Windows.
(with-temp-dir [binding-name options] & body)Function.
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? f)Returns true if f is writable
(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(defaulttrue):truncate-existing(defaulttrue):write(defaulttrue):append(defaultfalse)- 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 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(defaulttrue):truncate-existing(defaulttrue):write(defaulttrue):append(defaultfalse)- or any
java.nio.file.StandardOption.
(xdg-cache-home)
(xdg-cache-home app)Path representing the base directory relative to which user-specific non-essential data files should be stored as described in the XDG Base Directory Specification.
Returns path based on the value of env-var XDG_CACHE_HOME (if set and representing an absolute path), else (fs/path (fs/home) ".cache").
When provided, appends app to the path.
(xdg-config-home)
(xdg-config-home app)Path representing the base directory relative to which user-specific configuration files should be stored as described in the XDG Base Directory Specification.
Returns path based on the value of env-var XDG_CONFIG_HOME (if set and representing an absolute path), else (fs/path (fs/home) ".config").
When provided, appends app to the path.
(xdg-data-home)
(xdg-data-home app)Path representing the base directory relative to which user-specific data files should be stored as described in the XDG Base Directory Specification.
Returns path based on the value of env-var XDG_DATA_HOME (if set and representing an absolute path), else (fs/path (fs/home) ".local" "share").
When provided, appends app to the path.
(xdg-state-home)
(xdg-state-home app)Path representing the base directory relative to which user-specific state files should be stored as described in the XDG Base Directory Specification.
Returns path based on the value of env-var XDG_STATE_HOME (if set and representing an absolute path), else (fs/path (fs/home) ".local" "state").
When provided, appends app to the path.
(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.
Options:
:root: directory which will be elided in zip. E.g.:(fs/zip ["src"] {:root "src"}):path-fn: a single-arg function from file system path to zip entry path.