Test::TempDir - (DEPRECATED) Temporary files support for testing
Contents
Contributors
• Karen Etheridge <ether@cpan.org>
• Florian Ragwitz <rafl@debian.org>
Copyright And Licence
This software is copyright (c) 2006 by XXXX XXX'XX (Yuval Kogman).
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5
programming language system itself.
perl v5.34.0 2022-07-11 Test::TempDir(3pm)
Deprecation Notice
There have been numerous issues found with this module, particularly with its use of locks (unreliable,
may result in your entire $TMPDIR being deleted) and MSWin32 compatibility. As well, it uses Moose, which
is nowadays considered to be heavier than necessary.
Test::TempDir::Tiny was written as a replacement. Please use it instead!
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"
• Lock files 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 beginning 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.
"scratch"
Loads Directory::Scratch and instantiates a new one, with the same default options as "tempfile" and
"tempdir".
Name
Test::TempDir - (DEPRECATED) Temporary files support for testing
See Also
• File::Temp,
• Directory::Scratch
• Path::Class
Support
Bugs may be submitted through the RT bug tracker <https://rt.cpan.org/Public/Dist/Display.html?Name=Test-
TempDir> (or bug-Test-TempDir@rt.cpan.org <mailto:bug-Test-TempDir@rt.cpan.org>).
There is also a mailing list available for users of this distribution, at
<http://lists.perl.org/list/perl-qa.html>.
There is also an irc channel available for users of this distribution, at "#perl" on "irc.perl.org"
<irc://irc.perl.org/#perl-qa>.
Synopsis
use Test::TempDir;
my $test_tempdir = temp_root();
my ( $fh, $file ) = tempfile();
my $directory_scratch_obj = scratch();
Version
version 0.11
