Test::TempDir.3pm

Langue: en

Version: 2009-08-11 (fedora - 01/12/10)

Section: 3 (Bibliothèques de fonctions)

NAME

Test::TempDir - Temporary files support for testing.

SYNOPSIS

         use Test::TempDir;
 
         my $test_tempdir = temp_root();
 
         my ( $fh, $file ) = tempfile();
 
         my $directory_scratch_obj = scratch();
 
 

DESCRIPTION

Test::TempDir provides temporary directory creation with testing in mind.

The differences between using this and using File::Temp are:

*
If "t/tmp" is available (writable, creatable, etc) it's preferred over $ENV{TMPDIR} etc. Otherwise a temporary directory will be used.

This is "temp_root"

*
Lockfiles are used on "t/tmp", to prevent race conditions when running under a parallel test harness.
*
The "temp_root" is cleaned at the end of a test run, but not if tests failed.
*
"temp_root" is emptied at the begining of a test run unconditionally.
*
The default policy is not to clean the individual "tempfiles" and "tempdirs" within "temp_root", in order to aid in debugging of failed tests.

EXPORTS

temp_root
The root of the temporary stuff.
tempfile
tempdir
Wrappers for the File::Temp functions of the same name.

The default options are changed to use "temp_root" for "DIR" and disable "CLEANUP", but these are overridable.

scrach
Loads Directory::Scratch and instantiates a new one, with the same default options as "tempfile" and "tempdir".

SEE ALSO

File::Temp, Directory::Scratch, Path::Class

VERSION CONTROL

This module is maintained using Git. You can get the latest version from git://github.com/nothingmuch/test-tempdir.git <git://github.com/nothingmuch/test-tempdir.git>.

AUTHOR

Yuval Kogman <nothingmuch@woobling.org>
         Copyright (c) 2008 Yuval Kogman. All rights reserved
         This program is free software; you can redistribute
         it and/or modify it under the same terms as Perl itself.