Test::TempDir::Handle(3)

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.