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 &amp; 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(&#39;some_file_name.csv&#39;);

    # Read content of some other file.
    # Retry for up to 2.5 seconds if it is already locked.
    my @content2 = grab(&#39;some_other_file_name.log&#39; , patience =&gt; 2.5);

    # Append some data to that other file.
    append(&#39;some_other_file_name.log&#39;)-&gt;(@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 )