Filesystem¶

pwd() → String¶: Get the current working directory.

cd(dir::String)¶: Set the current working directory.

cd(f[, dir]): Temporarily changes the current working directory (HOME if not specified) and applies function f before returning.

mkdir(path[, mode])¶: Make a new directory with name path and permissions mode. mode defaults to 0o777, modified by the current file creation mask.

mkpath(path[, mode])¶: Create all directories in the given path, with permissions mode. mode defaults to 0o777, modified by the current file creation mask.

symlink(target, link)¶: Creates a symbolic link to target with the name link.
Note
This function raises an error under operating systems that do not support soft symbolic links, such as Windows XP.

chmod(path, mode)¶: Change the permissions mode of path to mode. Only integer modes (e.g. 0o777) are currently supported.

stat(file)¶

Returns a structure whose fields contain information about the file. The fields of the structure are:

size	The size (in bytes) of the file
device	ID of the device that contains the file
inode	The inode number of the file
mode	The protection mode of the file
nlink	The number of hard links to the file
uid	The user id of the owner of the file
gid	The group id of the file owner
rdev	If this file refers to a device, the ID of the device it refers to
blksize	The file-system preffered block size for the file
blocks	The number of such blocks allocated
mtime	Unix timestamp of when the file was last modified
ctime	Unix timestamp of when the file was created

lstat(file)¶: Like stat, but for symbolic links gets the info for the link itself rather than the file it refers to. This function must be called on a file path rather than a file object or a file descriptor.

ctime(file)¶: Equivalent to stat(file).ctime

mtime(file)¶: Equivalent to stat(file).mtime

filemode(file)¶: Equivalent to stat(file).mode

filesize(path...)¶: Equivalent to stat(file).size

uperm(file)¶

Gets the permissions of the owner of the file as a bitfield of

01	Execute Permission
02	Write Permission
04	Read Permission

For allowed arguments, see stat.

gperm(file)¶: Like uperm but gets the permissions of the group owning the file

operm(file)¶: Like uperm but gets the permissions for people who neither own the file nor are a member of the group owning the file

cp(src::String, dst::String)¶: Copy a file from src to dest.

download(url[, localfile])¶: Download a file from the given url, optionally renaming it to the given local file name. Note that this function relies on the availability of external tools such as curl, wget or fetch to download the file and is provided for convenience. For production use or situations in which more options are need, please use a package that provides the desired functionality instead.

mv(src::String, dst::String)¶: Move a file from src to dst.

rm(path::String; recursive=false)¶: Delete the file, link, or empty directory at the given path. If recursive=true is passed and the path is a directory, then all contents are removed recursively.

touch(path::String)¶: Update the last-modified timestamp on a file to the current time.

tempname()¶: Generate a unique temporary file path.

tempdir()¶: Obtain the path of a temporary directory (possibly shared with other processes).

mktemp()¶: Returns (path,io), where path is the path of a new temporary file and io is an open file object for this path.

mktempdir()¶: Create a temporary directory and return its path.

isblockdev(path) → Bool¶: Returns true if path is a block device, false otherwise.

ischardev(path) → Bool¶: Returns true if path is a character device, false otherwise.

isdir(path) → Bool¶: Returns true if path is a directory, false otherwise.

isexecutable(path) → Bool¶: Returns true if the current user has permission to execute path, false otherwise.

isfifo(path) → Bool¶: Returns true if path is a FIFO, false otherwise.

isfile(path) → Bool¶: Returns true if path is a regular file, false otherwise.

islink(path) → Bool¶: Returns true if path is a symbolic link, false otherwise.

ispath(path) → Bool¶: Returns true if path is a valid filesystem path, false otherwise.

isreadable(path) → Bool¶: Returns true if the current user has permission to read path, false otherwise.

issetgid(path) → Bool¶: Returns true if path has the setgid flag set, false otherwise.

issetuid(path) → Bool¶: Returns true if path has the setuid flag set, false otherwise.

issocket(path) → Bool¶: Returns true if path is a socket, false otherwise.

issticky(path) → Bool¶: Returns true if path has the sticky bit set, false otherwise.

iswritable(path) → Bool¶: Returns true if the current user has permission to write to path, false otherwise.

homedir() → String¶: Return the current user’s home directory.

dirname(path::String) → String¶: Get the directory part of a path.

basename(path::String) → String¶: Get the file name part of a path.

@__FILE__() → String¶: @__FILE__ expands to a string with the absolute path and file name of the script being run. Returns nothing if run from a REPL or an empty string if evaluated by julia-e<expr>.

isabspath(path::String) → Bool¶: Determines whether a path is absolute (begins at the root directory).

isdirpath(path::String) → Bool¶: Determines whether a path refers to a directory (for example, ends with a path separator).

joinpath(parts...) → String¶: Join path components into a full path. If some argument is an absolute path, then prior components are dropped.

abspath(path::String) → String¶: Convert a path to an absolute path by adding the current directory if necessary.

normpath(path::String) → String¶: Normalize a path, removing ”.” and ”..” entries.

realpath(path::String) → String¶: Canonicalize a path by expanding symbolic links and removing ”.” and ”..” entries.

expanduser(path::String) → String¶: On Unix systems, replace a tilde character at the start of a path with the current user’s home directory.

splitdir(path::String) -> (String, String)¶: Split a path into a tuple of the directory name and file name.

splitdrive(path::String) -> (String, String)¶: On Windows, split a path into the drive letter part and the path part. On Unix systems, the first component is always the empty string.

splitext(path::String) -> (String, String)¶: If the last component of a path contains a dot, split the path into everything before the dot and everything including and after the dot. Otherwise, return a tuple of the argument unmodified and the empty string.