NAME

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

VERSION

version 0.10

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.

AUTHOR

יובל קוג'מן (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2006 by יובל קוג'מן (Yuval Kogman).

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.