NAME

       Test::TempDir::Handle - A handle for managing a temporary directory root

VERSION

       version 0.11

SYNOPSIS

           use Test::TempDir::Handle;

           my $h = Test::TempDir::Handle->new( dir => dir("t/tmp") );

           $h->empty;

           # ...

           $h->cleanup; # will delete on success by default

DESCRIPTION

       This class manages a temporary directory.

ATTRIBUTES

   "dir"
       The Path::Class::Dir that is being managed.

   "lock"
       No longer used.

   "cleanup_policy"
       One of "success", "always" or "never".

       "success" means that "cleanup" deletes only if "test_builder" says the tests have passed.

   "test_builder"
       The Test::Builder singleton.

METHODS

   "empty"
       Cleans out the directory but doesn't delete it.

   "delete"
       Cleans out the directory and removes it.

   "cleanup"
       Calls "delete" if the "cleanup_policy" dictates to do so.

       This is normally called automatically at destruction.

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>

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.