NAME

Path::Extended::Entity

SYNOPSIS

  use Path::Extended::File;
  my $file = Path::Extended::File->new('path/to/some.file');

DESCRIPTION

This is a base class for Path::Extended::File and Path::Extended::Dir.

METHODS

new

creates an appropriate object. Note that this base class itself doesn't hold anything.

may take an optional hash, and returns an absolute path of the file/directory. Note that back slashes in the path will be converted to forward slashes unless you explicitly set a "native" option to true.

relative

may take an optional hash, and returns a relative path of the file/directory (compared to the current directory (Cwd::cwd) by default, but you may change this bahavior by passing a "base" option). Note that back slashes in the path will be converted to forward slashes unless you explicitly set a "native" option to true.

is_absolute

returns if the path you passed to the constructor was absolute or not (note that the path stored in an object is always absolute).

is_dir

returns if the object represents directory or not.

resolve

does a physical cleanup of the path with Cwd::realpath, that means, resolves a symbolic link if necessary. Note that this method may croak (when the path does not exist).

copy_to

copies the file/directory to the destination by "File::Copy::copy".

move_to

moves the file/directory to the destination by "File::Copy::move". If the file/directory is open, it'll automatically close.

rename_to

renames the file/directory. If the file/directory is open, it'll automatically close. If your OS allows rename of an open file, you may want to use built-in "rename" function for better atomicity.

unlink

unlinks the file/directory. The same thing can be said as for the "rename_to" method.

exists

returns true if the file/directory exists.

is_readable, is_writable

returns true if the file/directory is readable/writable.

is_open

returns true if the file/directory is open.

stat, lstat

returns a File::stat object for the file/directory.

parent

returns a Path::Extended::Dir object that points to the parent directory of the file/directory.

path, stringify

explicitly returns a path string.

log, logger, logfile, logfilter

You may optionally pass a logger object with "log" method that accepts "( label => @log_messages )" array arguments to notifty when some (usually unfavorable) thing occurs. By default, a built-in Carp logger will be used. If you want to disable logging, set a false value to "logger". See Log::Dump for details, and for how to use "logfile" and "logfilter" methods.

AUTHOR

Kenichi Ishigaki, <ishigaki@cpan.org>

COPYRIGHT AND LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.