NAME

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

VERSION

       version 0.10

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"
       An optional lock object (File::NFSLock). Just kept around for reference counting.

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

AUTHOR

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

COPYRIGHT AND LICENSE

       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.