File-Takeput
view release on metacpan or search on metacpan
README.html view on Meta::CPAN
<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>File::Takeput - Slurp style file IO with locking.</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body>
<ul id="index">
<li><a href="#NAME">NAME</a></li>
<li><a href="#VERSION">VERSION</a></li>
<li><a href="#SYNOPSIS">SYNOPSIS</a></li>
<li><a href="#DESCRIPTION">DESCRIPTION</a></li>
<li><a href="#SUBROUTINES-AND-VARIABLES">SUBROUTINES AND VARIABLES</a></li>
<li><a href="#CONFIGURATION">CONFIGURATION</a>
<ul>
<li><a href="#CONFIGURATION-OPTIONS">CONFIGURATION OPTIONS</a>
<ul>
<li><a href="#OPTIONAL-NAMED-PARAMETERS">1. OPTIONAL NAMED PARAMETERS</a></li>
<li><a href="#SET-AND-RESET-SUBROUTINES">2. SET AND RESET SUBROUTINES</a></li>
<li><a href="#USE-STATEMENT">3. USE STATEMENT</a></li>
<li><a href="#DEFAULT-CONFIGURATION">4. DEFAULT CONFIGURATION</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="#ERROR-HANDLING">ERROR HANDLING</a></li>
<li><a href="#DEPENDENCIES">DEPENDENCIES</a></li>
<li><a href="#KNOWN-ISSUES">KNOWN ISSUES</a></li>
<li><a href="#TODO">TODO</a></li>
<li><a href="#SEE-ALSO">SEE ALSO</a></li>
<li><a href="#LICENSE-COPYRIGHT">LICENSE & COPYRIGHT</a></li>
</ul>
<h1 id="NAME">NAME</h1>
<p>File::Takeput - Slurp style file IO with locking.</p>
<h1 id="VERSION">VERSION</h1>
<p>0.30</p>
<h1 id="SYNOPSIS">SYNOPSIS</h1>
<pre><code> use File::Takeput;
# Lock some file and read its content.
my @content1 = take('some_file_name.csv');
# Read content of some other file.
# Retry for up to 2.5 seconds if it is already locked.
my @content2 = grab('some_other_file_name.log' , patience => 2.5);
# Append some data to that other file.
append('some_other_file_name.log')->(@some_data);
# Read content of some third file as a single string.
( run in 2.101 seconds using v1.01-cache-2.11-cpan-119454b85a5 )