NAME¶
Arch::TempFiles - help to manage temporary files/dirs
SYNOPSIS¶
use Arch::TempFiles qw(temp_file_name temp_file temp_dir);
# all will be removed automatically on the script completion
my $file_name1 = temp_file();
my $file_name2 = temp_file_name("status");
my $dir_name = temp_dir("arch-tree");
use Arch::TempFiles;
my $tmp = new Arch::TempFiles;
$tmp->root($tmp->dir);
my $file_name = $tmp->name;
open OUT, ">$file_name";
close OUT;
DESCRIPTION¶
This module deals with temporary file names. It is similar to File::Temp, but
simplier and more focused. Also, File::Temp is relatively new and was not
shipped with older perl versions.
Both function interface and object oriented interface are supported.
FUNCTIONS/METHODS¶
The following functions are available:
temp_root,
temp_name,
temp_file_name,
temp_dir_name,
temp_file,
temp_dir.
The corresponding class methods are available too:
root,
name,
file_name,
dir_name,
file,
dir.
- temp_root [dir]
- $tmp->root [dir]
- Change or return the root of the temporary files and dirs.
The default is either $ENV{TMP_DIR} or "/tmp".
- temp_name [label]
- $tmp->name [label]
- Return the unused temporary file name. The default file
name is "/tmp/,,arch-XXXXXX" where XXXXXX is a random number. To
change this name use "temp_root" and/or provide label
that replaces "arch".
Please note, that the operation of acquiring the file name using this
function/method and actual creating of this file is not atomic. So you may
need to call this method again if the creation is failed, for example if
some other process created the same file in the middle.
- temp_file_name [label]
- $tmp->file_name [label]
- Like "temp_name", but stores the name in the file
list that will be removed on the end (on object destruction).
- temp_dir_name [label]
- $tmp->dir_name [label]
- Like "temp_name", but stores the name in the dir
list that will be removed on the end (on object destruction).
- temp_file [label]
- $tmp->file [label]
- Like "temp_file_name", but also creates the
file.
- temp_dir [label]
- $tmp->dir [label]
- Like "temp_dir_name", but also creates the
dir.
BUGS¶
Awaiting for your reports.
AUTHORS¶
Mikhael Goikhman (migo@homemail.com--Perl-GPL/arch-perl--devel).
SEE ALSO¶
For a different interface, see File::Temp.