NAME

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

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.