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.