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.