Path::Extended::Entity
use Path::Extended::File; my $file = Path::Extended::File->new('path/to/some.file');
This is a base class for Path::Extended::File and Path::Extended::Dir.
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.
native
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.
base
returns if the path you passed to the constructor was absolute or not (note that the path stored in an object is always absolute).
returns if the object represents directory or not.
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).
copies the file/directory to the destination by File::Copy::copy.
File::Copy::copy
moves the file/directory to the destination by File::Copy::move. If the file/directory is open, it'll automatically close.
File::Copy::move
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.
rename
unlinks the file/directory. The same thing can be said as for the rename_to method.
rename_to
returns true if the file/directory exists.
returns true if the file/directory is readable/writable.
returns true if the file/directory is open.
returns a File::stat object for the file/directory.
returns a Path::Extended::Dir object that points to the parent directory of the file/directory.
explicitly returns a path string.
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.
log
( label => @log_messages )
logger
logfile
logfilter
Path::Extended, Path::Extended::File, Path::Extended::Dir, Log::Dump
Kenichi Ishigaki, <ishigaki@cpan.org>
Copyright (C) 2008 by Kenichi Ishigaki.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Path::Extended, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Path::Extended
CPAN shell
perl -MCPAN -e shell install Path::Extended
For more information on module installation, please visit the detailed CPAN module installation guide.