No::Worries::Dir(3) User Contributed Perl Documentation No::Worries::Dir(3)NAMENo::Worries::Dir - directory handling without worries
SYNOPSIS
use No::Worries::Dir
qw(dir_change dir_ensure dir_make dir_parent dir_read dir_remove);
# change directory
dir_change("/tmp");
# make sure a directory exists (not an error if it exists already)
dir_ensure("/tmp/some/path", mode => oct(770));
# make a directory (an error if it exists already)
dir_make("/tmp/some/path", mode => oct(770));
# find out the parent directory of some path
$parent = dir_parent($path);
dir_ensure($parent);
# read a directory
foreach $name (dir_read("/etc")) {
...
}
# remove a directory
dir_remove("/tmp/some/path");
DESCRIPTION
This module eases directory handling by providing convenient wrappers
around standard directory functions. All the functions die() on error.
FUNCTIONS
This module provides the following functions (none of them being
exported by default):
dir_change(PATH)
change the working directory to the given path; this is a safe thin
wrapper on top of chdir()
dir_ensure(PATH[, OPTIONS])
make sure the given path is an existing directory, creating it
(including its parents) if needed; supported options:
· "mode": numerical mode to use for mkdir() (default: oct(777))
dir_make(PATH[, OPTIONS])
make the given directory; this is a safe thin wrapper on top of
mkdir(); supported options:
· "mode": numerical mode to use for mkdir() (default: oct(777))
dir_parent(PATH)
return the parent directory of the given path
dir_read(PATH)
read the given directory and return its list of entries except "."
and ".."
dir_remove(PATH)
remove the given directory (that must exist and be empty); this is
a safe thin wrapper on top of rmdir()SEE ALSO
No::Worries.
AUTHOR
Lionel Cons <http://cern.ch/lionel.cons>
Copyright CERN 2012
perl v5.14.3 2012-12-19 No::Worries::Dir(3)
