aerial.fs — aerial.fs 1.1.6

abspath clj

(abspath path)

Return absolute path.

assert-files? clj multimethod

(assert-files? coll)

(assert-files? regex)

(assert-files? file-glob)

Assert that the files (including directories) designated by DESIGNATOR exist. If not, collect all those that do not and raise an ex-info exeception :type :no-such-files :files <set of names>.

DESIGNATOR can be a collection, regex or string. If a collection, each element is taken as a full path of a file; if regex, uses re-directory-files to obtain a collection of paths; if string, treat as file glob and use fs/glob to obtain collection of paths. Check all elements of resulting collection with fs/exists?

basename clj

(basename path)

Return basename (file part) of path. (basename "/a/b/c") -> "c"

cd clj

(cd dir)

Change working directory to DIR and return previous working directory. If DIR does not exist do nothing and return nil

copy clj

(copy from to)

cpfiles clj

(cpfiles dirdir outdir regex file-type)

Copy a set of files from a set of dirs DIRDIR to an output dir OUTDIR.

FILE-TYPE is the type of files in each dir in DIRDIR that are candidates to be copied. REGEX is a regular expression to filter the set of candidates

EX: (cpfiles "/data2/Bio/Training/MoStos2" "/home/jsa/TMP/X" #"firm" ".sto")

delete clj

(delete path)

Delete path.

dir-stack clj

directory-files clj

(directory-files directory file-type)

Return full path qualified file specifications for all files in directory whose suffix matches file-type. Typically file-type would be the type suffix (e.g., .txt or .sto or .fna or .clj or whatever), but could include any part of the file name's suffix. So, giving -new.sto for example, works as well.

directory? clj

(directory? path)

Return true if path is a directory.

dirname clj

(dirname path)

Return directory name of path. (dirname "a/b/c") -> "/a/b"

dirstack clj

(dirstack)

Return current directory stack

dodir clj

(dodir dir filterf actionf & args)

Map ACTIONF over application of FILTERF to DIR.

FILTERF is a function that operates on a directory returning a result set (typically a set of files). ACTIONF is a function that takes an element of the set and any ancillary supplied arguments ARGS and returns an appropriate result.

Returns the seq of results of ACTIONF minus any nils

empty? clj

(empty? path)

executable? clj

(executable? path)

Return true if path is executable.

exists? clj

(exists? path)

Return true if path exists.

file clj deprecated

(file arg)

(file parent child)

(file parent child & more)

Returns a java.io.File from string or file args.

file? clj

(file? path)

Return true if path is a file.

ftype clj

(ftype path)

Return the file type suffix of PATH. File type suffix is the last substring element following a '.' in (basename PATH). If no such element is in the basename, returns empty string""

Ex: (ftype "/home/fred/Bio/test.sto") ==> "sto"

fullpath clj

(fullpath filespec-str)

Canonicalize FILESPEC, a string, to a fully qualified file path for the native system. ~ in position one is translated to the users home directory path, / and \ are translated to the file separator for the native system.

glob clj

(glob pattern)

glob->regex clj

(glob->regex s)

Takes a glob-format string and returns a regex.

homedir clj

(homedir)

Return user home directory path

join clj

(join & parts)

Join parts of path. (join ["a" "b"]) -> "a/b"

listdir clj

(listdir path)

List files under path.

mkdir clj

(mkdir path)

Create a directory.

mkdirs clj

(mkdirs path)

Make directory tree.

move clj multimethod

(move coll newdir)

(move regex newdir)

(move file-glob newdir)

Move the files (including directories) designated by DESIGNATOR to the directory NEWDIR. DESIGNATOR can be collection, regex or string. If a collection, each element is taken as a full path of a file; if regex, uses re-directory-files to obtain a collection of paths; if string, treat as file glob and use fs/glob to obtain collection of paths. Move all elements of resulting collection to newdir.

mtime clj

(mtime path)

Return file modification time.

normpath clj

(normpath path)

Return nomralized (canonical) path.

pop clj

(pop)

Pop current top saved directory from directory stack, make it the current working directory, and return prior working directory. If directory stack is empty, do nothing and return nil.

push clj

(push dir)

Push current working directory on directory stack, cd to DIR, and return previous (saved) working directory. If DIR does not exist do nothing and return nil.

pwd clj

(pwd)

Return current working directory path

re-directory-files clj

(re-directory-files directory re)

Return full path qualified file specifications for all files in directory whose name ends with a string matched by re. RE is a regexp (#"regex def" literal or a string that defines a regexp (which will be turned into a pattern).

readable? clj

(readable? path)

Return true if path is readable.

rename clj

(rename old-path new-path)

Rename old-path to new-path.

replace-type clj

(replace-type filespec ext)

Replace the file extension type of FILESPEC to be EXT. The type for FILESPEC is the last part dotted extension. Formally, matches regexp '.[^.]*$'. If EXT is a seq/vec replace extensions in last/first pairings. Last extension replace by (first EXT), then last of that result is replaced by (second EXT), etc.

rm clj

(rm file)

Remove a file. Will throw an exception if the file cannot be deleted.

rm-f clj

(rm-f file)

Remove a file, ignoring any errors.

rm-r clj

(rm-r path & [silently])

Remove a directory. The directory must be empty; will throw an exception if it is not or if the file cannot be deleted.

rm-rf clj

(rm-rf path)

Remove a directory, ignoring any errors.

separator clj

size clj

(size path)

Return size (in bytes) if file.

split clj

(split path)

Split path to componenets. (split "a/b/c") -> ("a" "b" "c")

symbolic-link? clj

(symbolic-link? path)

Return true if path denotes a symbolic link, false otherwise

tempdir clj

(tempdir)

(tempdir root)

Create a temporary directory

tempfile clj

(tempfile)

(tempfile prefix)

(tempfile prefix suffix)

(tempfile prefix suffix directory)

Create a temporary file.

writeable? clj

(writeable? path)

Return true if path is writeable.