Test::TempDir::Handle(3p)

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.