TEST2::IPC::DRIVER::FILES(3pm)

🎀 Test2::IPC::Driver::Files — the main-character manpage ✨

okay so bestie, quick vibe check: this page is from the Perl Programmers Reference Guide and it's about Test2::IPC::Driver::Files. yes the module name is long. no we're not shortening it. iykyk 💅

---

🌸 NAME

Test2::IPC::Driver::Files — the temp dir + files concurrency model, fr fr.

---

🦋 DESCRIPTION

okay so this? this is the default concurrency model for Test2. and it's also the fallback one. lowkey the safety net of the whole operation.

it sends events between processes and threads using serialized files in a temporary directory. that's the whole trick. no cap.

is it fast? bestie. no. it is not particularly fast. 🙈 but it works everywhere, and honestly that's the energy we're going with. it's giving reliable bestie who shows up to every plan, not the flashy one who cancels last minute. 🫶

---

✨ SYNOPSIS

    use Test2::IPC::Driver::Files;

    # IPC is now enabled

that's it. that's the whole thing. one use line and boom, IPC is enabled. slay. 👑

---

💖 ENVIRONMENT VARIABLES

two env vars. both iconic. both here to help you out.

• T2_KEEP_TEMPDIR=0 — when this is true, the tempdir that the IPC driver is using will not be deleted when the test is done. yes, you heard me. it sticks around. so if you're the kind of person who wants to snoop through the leftovers, this is your moment. 🔍
• T2_TEMPDIR_TEMPLATE='test2-XXXXXX' — this one sets the template for the IPC temp dir. the template should follow the template specifications from File::Temp, so go check that out if you're customizing. the default is literally test2-XXXXXX right there in the example, cute right? 🎀

---

🌈 SEE ALSO

• Test2::IPC::Driver — that's where you go for the methods. go look, bestie. 👀

---

⭐ SOURCE

the source code repository for Test2 lives over at:

https://github.com/Test-More/test-more/

---

👑 MAINTAINERS

Chad Granum <exodist@cpan.org>

---

🧚 AUTHORS

Chad Granum <exodist@cpan.org>

(yes it's the same person in both sections. we love a consistent king. 💜)

---

💅 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:

https://dev.perl.org/licenses/

---

🍓 sign-off

aaaaand that's the page! brought to you by perl v5.42.3, dated 2026-11-03, and yes the footer also said Test2::...r::Files(3pm) because the terminal is dramatic and truncates things. 💀 anyway ily, go enable your IPC, and remember: temp dir + files = not fast, but everywhere. periodt. 🌸✨