Test2::Tools::GenTemp(3pm) Perl Programmers Reference Guide Test2::Tools::GenTemp(3pm)

# [NAME](#NAME)

Test2::Tools::GenTemp - Tool for generating a populated temp directory.

# [DESCRIPTION](#DESCRIPTION)

This exports a tool that helps you make a temporary directory, nested directories and text files within.

# [SYNOPSIS](#SYNOPSIS)

```
    use Test2::Tools::GenTemp qw/gen_temp/;
    my $dir = gen_temp(
        a_file => "Contents of a_file",
        a_dir  => {
            'a_file' => 'Contents of a_dir/afile',
            a_nested_dir => { ... },
        },
        ...
    );
    done_testing;
```

# [EXPORTS](#EXPORTS)

All subs are exported by default.

[gen\_temp(file => 'content', subdir => \[ sub\_dir\_file => 'content', ...\], ...)](#gen_temp%28file)

[gen\_temp(-tempdir => \\@TEMPDIR\_ARGS, file => 'content', subdir => \[ sub\_dir\_file => 'content', ...\], ...)](#gen_temp%28)

This will generate a new temporary directory with all the files and subdirs you specify, recursively. The initial temp directory is created using File::Temp::tempdir(), you may pass arguments to tempdir using the "-tempdir => \[...]" argument.

# [SOURCE](#SOURCE)

The source code repository for Test2-Suite can be found at *https://github.com/Test-More/test-more/*.

# [MAINTAINERS](#MAINTAINERS)

[Chad Granum <exodist@cpan.org>](#Chad)

# [AUTHORS](#AUTHORS)

[Chad Granum <exodist@cpan.org>](#Chad~2)

# [COPYRIGHT](#COPYRIGHT)

Copyright Chad Granum <exodist@cpan.org>.

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

See *http://dev.perl.org/licenses/*

2026-10-26 perl v5.44.0

---

Document: Test2::Tools::GenTemp(3pm) from perl 5.44.0-r3 (Chainguard OS)
Source: https://github.com/Perl/perl5.git