NAME

       Test::TempDir - (DEPRECATED) Temporary files support for testing

VERSION

       version 0.11

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!

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"

       •   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".

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>.

AUTHOR

       XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

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)