NAME

File::Butler - Handy collection of file-related tools.

VERSION

Version 4.0.0

SYNOPSIS

A collection of basic file manipulation tools.

As of version 4.0.0, File::Butler is built around Moose.

    use File::Butler;

    my $fb = File::Butler->new( 'filename' => 'myfile.txt' );
    my $contents = $fb->read();
    my $retval = $fb->append( "Text to be appended." );
    my $retval = $fb->prepend( "Text to be prepended to the beginning of the file." );

Please note that "filename" is a required element during invocation. In cases where file contents are to be returned, contents are returned either as an array or an array reference, depending upon how the method is called.

SUBROUTINES/METHODS

dir

read

write

append

prepend

srm

wc

AUTHOR

Kurt Kincaid, <kurt.kincaid at gmail.com>

BUGS

Please report any bugs or feature requests to bug-file-butler at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=File-Butler. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc File::Butler

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=File-Butler

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/File-Butler

• CPAN Ratings

  http://cpanratings.perl.org/d/File-Butler

• Search CPAN

  http://search.cpan.org/dist/File-Butler/

LICENSE AND COPYRIGHT

Copyright 2010 Kurt Kincaid.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.