| File::Fu - file and directory objects |
File::Fu - file and directory objects
The directory constructor:
use File::Fu;
my $dir = File::Fu->dir("bar"); print "$dir\n"; # 'bar/'
my $file = $dir + 'bar.txt'; print "$file\n"; # 'bar/bar.txt'
my $d2 = $dir % 'baz'; # 'barbaz/' my $d3 = $dir / 'bat'; # 'bar/bat/'
my $file2 = $dir / 'bat' + 'foo.txt'; # 'bar/bat/foo.txt'
The file constructor:
my $file = File::Fu->file("foo"); $file->e and warn "$file exists"; $file->l and warn "$file is a link"; warn "file is in ", $file->dir;
This class provides the toplevel interface to File::Fu directory and file objects, with operator overloading which allows precise path composition and support for most builtin methods, as well as creation of temporary files/directories, finding files, and more.
The interface and style are quite different than the perl builtins or File::Spec. The syntax is concise. Errors are thrown with croak(), so you never need to check a return code.
The actual objects are in the 'Dir' and 'File' sub-namespaces.
my $dir = File::Fu->dir($path);
See new in the File::Fu::Dir manpage
my $file = File::Fu->file($path);
See new in the File::Fu::File manpage
Your system's '/tmp/' directory (or equivalent of that.)
my $dir = File::Fu->tmp;
User's $HOME directory.
my $dir = File::Fu->home;
The absolute name of your program. This will be relative from the time File::Fu was loaded. It dies if the name is '-e'.
my $prog = File::Fu->program_name;
If File::Fu was loaded after a chdir and the $0 was relative, calling
program_name() throws an error. (Unless you set $0 correctly before
requiring File::Fu.)
Returns what typically corresponds to program_name()->dirname, but
just the compile-time cwd() when $0 is -e/-E.
my $dir = File::Fu->program_dir;
A nicer way to say __FILE__.
my $file = File::Fu->THIS_FILE;
The current working directory.
my $dir = File::Fu->cwd;
Returns File::Fu::File objects of ordered candidates for $name found in the path.
my @prog = File::Fu->which($name) or die "cannot find $name";
If called in scalar context, returns a single File::Fu::File object or throws an error if no candidates were found.
my $prog = File::Fu->which($name);
These class methods call the corresponding File::Fu::Dir methods on the value of tmp(). That is, you get a temporary file/dir in the '/tmp/' directory.
my $dir = File::Fu->temp_dir;
my $handle = File::Fu->temp_file;
You may wish to subclass File:Fu and override the dir_class() and/or
file_class() class methods to point to your own Dir/File subclasses.
my $class = 'My::FileFu'; my $dir = $class->dir("foo");
See the File::Fu::File manpage and the File::Fu::Dir manpage for more info.
the File::Fu::why manpage if I need to explain my motivations.
the Path::Class manpage, from which many an idea was taken.
the File::stat manpage, the IO::File manpage, the File::Spec manpage, the File::Find manpage, the File::Temp manpage, the File::Path manpage, the File::Basename manpage, perlfunc, perlopentut.
Eric Wilhelm @ <ewilhelm at cpan dot org>
If you found this module on CPAN, please report any bugs or feature requests through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
If you pulled this development version from my /svn/, please contact me directly.
Copyright (C) 2008 Eric L. Wilhelm, All Rights Reserved.
Absolutely, positively NO WARRANTY, neither express or implied, is offered with this software. You use this software at your own risk. In case of loss, no person or entity owes you anything whatsoever. You have been warned.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
| File::Fu - file and directory objects |