TEST2::TOOLS::GENTEMP(3perl)

💖 Test2::Tools::GenTemp 💖

okay so bestie, this is the Test2::Tools::GenTemp page from the Perl Programmers Reference Guide (section 3perl), and it's literally the cutest little helper for making temp dirs that are already full of stuff. no cap.

✨ NAME ✨

Test2::Tools::GenTemp — a tool for generating a populated temp directory. that's it, that's the whole vibe. 💅

🌸 DESCRIPTION 🌸

this thing exports a tool that helps you make a temporary directory, and then also nested directories and text files inside it. like, you say what you want the tree to look like, and it just appears. main character energy fr fr. 🦋

🎀 SYNOPSIS 🎀

here's the whole thing in action, bestie:

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;

look at that. obsessed. 😭💖

👑 EXPORTS 👑

all subs are exported by default — every single one, no gatekeeping here. 💜

• gen_temp(file => 'content', subdir => [ sub_dir_file => 'content', ...], ...)
• gen_temp(-tempdir => \@TEMPDIR_ARGS, file => 'content', subdir => [ sub_dir_file => 'content', ...], ...)

so what this does: it generates a brand new temporary directory with all the files and subdirs you specify, recursively, down and down and down. 🌈 the initial temp directory gets created using File::Temp::tempdir(), and if you wanna pass arguments to tempdir you can do that with the -tempdir => [...] argument. iykyk. ✨

---

🔥 SOURCE 🔥

the source code repository for Test2-Suite lives at https://github.com/Test-More/test-more/. go look, it's giving open source royalty. 👑

💅 MAINTAINERS 💅

Chad Granum <exodist@cpan.org>

🌟 AUTHORS 🌟

Chad Granum <exodist@cpan.org>

💜 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. periodt. ✨

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

---

and that's the whole page bestie!! thanks for reading, mwah 💖

this was perl v5.44.0, dated 2026-10-17, from Test2::Tools::GenTemp(3perl) — slay, bye!! 🎀🦋💅