NAME

File::Fu - file and directory objects

SYNOPSIS

Constructors

The actual objects are in the 'Dir' and 'File' sub-namespaces.

dir

my $dir = File::Fu->dir($path);

See "new" in File::Fu::Dir

file

my $file = File::Fu->file($path);

See "new" in File::Fu::File

Class Constants

tmp

Your system's '/tmp/' directory (or equivelant of that.)

my $dir = File::Fu->tmp;

Temporary Directories and Files

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.

temp_dir

my $dir = File::Fu->temp_dir;

temp_file

my $handle = File::Fu->temp_file;

Subclassing

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 File::Fu::File and File::Fu::Dir for more info.

See Also

File::Fu::why if I need to explain my motivations.

Path::Class, from which many an idea was taken.

File::stat, IO::File, File::Spec, File::Find, File::Temp, File::Path, File::Basename, perlfunc, perlopentut.

AUTHOR

Eric Wilhelm @ <ewilhelm at cpan dot org>

http://scratchcomputing.com/

BUGS

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

Copyright (C) 2008 Eric L. Wilhelm, All Rights Reserved.

NO WARRANTY

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.

LICENSE

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