NAME

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

FUNCTIONS

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:

dir_make(PATH[, OPTIONS])

make the given directory; this is a safe thin wrapper on top of mkdir(); supported options:

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

AUTHOR

Copyright (C) CERN 2012-2019