checks whether a file is a directory

(directory? “src”) => true

(directory? “project.clj”) => false

checks if a directory is empty, returns true if both are true

(empty-directory? “.”) => false

checks whether a file is executable

(executable? “project.clj”) => boolean?

(executable? “/usr/bin/whoami”) => true

checks whether a file exists

(exists? “project.clj”) => true

(exists? “NON.EXISTENT”) => false

returns the input as a file

(file “project.clj”) => java.io.File

returns the last section of the path

(str (file-name “src/hara”)) => “hara”

encodes the type of file as a keyword

(file-suffix “hello.clj”) => :clj

(file-suffix “hello.java”) => :java

returns the filesystem governing the path

(file-system “.”) ;; #object[sun.nio.fs.MacOSXFileSystem 0x512a9870 “sun.nio.fs.MacOSXFileSystem@512a9870”] => java.nio.file.FileSystem

checks whether a file is not a link or directory

(file? “project.clj”) => true

(file? “src”) => false

checks whether a file is hidden

(hidden? “.gitignore”) => true

(hidden? “project.clj”) => false

opens a file as an input-stream

(input-stream “project.clj”)

returns the last modified time as a long

(last-modified “project.clj”) => integer?

checks whether a file is a link

(link? “project.clj”) => false

(link? (api/create-symlink “project.lnk” “project.clj”)) => true (api/delete “project.lnk”)

creates a string that takes notice of the user home

(normalise “.”) => (str common/cwd “/” “.”)

(normalise “~/hello/world.txt”) => (str common/home “/hello/world.txt”)

(normalise “/usr/home”) => “/usr/home”

returns the nth segment of a given path

(str (nth-segment “/usr/local/bin” 1)) => “local”

opens a file as an output-stream

(output-stream “project.clj”)

returns the parent of the given path

(str (parent “/usr/local/bin”)) => “/usr/local”

creates a `java.nio.file.Path object

checks to see if the object is of type Path

(path? (path “/home”)) => true

returns the permissions for a given file

(permissions “src”) => “rwxr-xr-x”

opens a file and reads the contents as a byte array

(read-all-bytes “project.clj”)

opens a file and reads the contents as an array of lines

(read-all-lines “project.clj”)

checks whether a file is readable

(readable? “project.clj”) => true

returns one path relative to another

(str (relativize “test” “src/hara”)) => “../src/hara”

returns the root path

(str (root “/usr/local/bin”)) => “/”

path object without normalisation

(str (section “project.clj”)) => “project.clj”

(str (section “src” “hara/time.clj”)) => “src/hara/time.clj”

returns the number of segments of a given path

(segment-count “/usr/local/bin”) => 3

sets a file to be executable

returns the subpath of a given path

(str (subpath “/usr/local/bin/hello” 1 3)) => “local/bin”

creates a java.io.File object

(to-file (section “project.clj”)) => (all java.io.File #(-> % str (= “project.clj”)))

returns the shorthand string for a given entry

(typestring “src”) => “d”

(typestring “project.clj”) => “-”

checks whether a file is writable

(writable? “project.clj”) => true

writes a byte-array to file

(write-all-bytes “hello.txt” (.getBytes “Hello World”))

writes a stream to a path

(write-into “project.clj” (java.io.FileInputStream. “project.clj”) {:options #{:replace-existing}})