Why not adopt me?
NAME
FileCache::Appender - cache file handles opened for appending
VERSION
This document describes FileCache::Appender version 0.03
SYNOPSIS
use FileCache::Appender;
# returns cached file handle, or opens file for appending
my $fh = FileCache::Appender->file($path);
DESCRIPTION
Caches file handles opened for appending. Helps to reduce number of I/O operations if you are appending data to many files.
METHODS
$class->new(%args)
Creates a new object. The following parameters are allowed:
- max_open
-
maximum number of file handles to cache. If cache reaches this size, each time you requesting a new file handle, one of the existing will be removed from the cache.
- mkpath
-
if directory in which file should be opened doesn't exist, create it
$self->file($path)
returns file handle for the file specified by $path. If file handle for the file is not in the cache, will open file for appending and cache file handle.
$self->clear
clear the cache
CAVEATS
If you need to append data to a big number of files, perhaps you should use a database.
Module does not perform any checks if file handle is still actual. If you closed file handle that you have got from cache, you still may get this handle next time you call file. If file was renamed, you still may get the handle pointing to it when requesting file using the old name.
BUGS
Please report any bugs or feature requests via GitHub bug tracker at http://github.com/trinitum/perl-FileCache-Appender/issues.
AUTHOR
Pavel Shaydo <zwon at cpan.org>
LICENSE AND COPYRIGHT
Copyright (C) 2014 Pavel Shaydo
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.