/ 
Pinto-0.065_05
River stage one • 3 direct dependents • 5 total dependents
/ Pinto::Role::FileFetcher

NAME

Pinto::Role::FileFetcher - Something that fetches remote files

VERSION

version 0.065_05

METHODS

fetch(from => 'http://someplace' to => 'some/path')

Fetches the file located at from to the file located at to, if the file at from is newer than the file at to. If the intervening directories do not exist, they will be created for you. Returns a true value if the file has changed, returns false if it has not changed. Throws and exception if anything goes wrong.

The to argument can be either a URI or Path::Class::File object, or a string that represents either of those. The from attribute can be a Path::Class::File object or a string that represents one.

fetch_temporary(url => 'http://someplace')

Fetches the file located at the url to a file in a temporary directory. The file will have the same basename as the url. Returns a Path::Class::File that points to the new file. Throws and exception if anything goes wrong. Note the temporary directory and all its contents will be deleted when the process terminates.

AUTHOR

Jeffrey Ryan Thalhammer <jeff@stratopan.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Imaginative Software Systems.

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