NAME

       Test::TempDir::Factory - A factory for creating Test::TempDir::Handle objects

VERSION

       version 0.10

SYNOPSIS

           my $f = Test::TempDir::Factory->new;

           my $d = $f->create;

           $d->empty;

           # ...

           $d->cleanup

DESCRIPTION

       This class creates Test::TempDir::Handle objects with the right "dir" parameter, taking
       care of obtaining locks, creating directories, and handling fallback logic.

ATTRIBUTES

   "lock"
       Whether or not to enable locking.

       Defaults to true.

   "lock_opts"
       A hash reference to pass to File::NFSLock.

       Defaults to "NONBLOCKING"

   "lock_attempts"
       How many times to try to create and lock a directory.

       Defaults to 2.

   "dir_name"
       The directory under "t_dir" to use.

       Defaults to "tmp"

   "t_dir"
       Defaults to "t"

   "use_subdir"
       Whether to always use a temporary subdirectory under the temporary root.

       This means that with a "success" cleanup policy all failures are retained.

       When disabled, "t/tmp" will be used directly as "temp_root".

       Defaults to true.

   "subdir_template"
       The template to pass to "tempdir". Defaults to "File::Temp::TEMPXXX".

   "handle_class"
       Defaults to Test::TempDir::Handle.

   "verbose"
       Whether or not to "carp" diagnostics when falling back.

       If you subclass this factory and add a "logger" method a la MooseX::Logger then this
       parameter is ignored and all messages will be "warn"ed on the logger.

METHODS

   "create"
       Create a Test::TempDir::Handle object with a proper "dir" attribute.

AUTHOR

       XXXX XXX'XX (Yuval Kogman) <nothingmuch@woobling.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2006 by XXXX XXX'XX (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.