Test2::...r::Files(3)

📦 version 1.302214, in opensuse-leap 16.0

💖 NAME 💖

Test2::IPC::Driver::Files — the temp-dir + files concurrency model, bestie. That's the whole vibe: it's the manual page for Test2::...r::Files(3) and it's lowkey the workhorse nobody claps for.

✨ DESCRIPTION ✨

Okay so listen. This is the default concurrency model for Test2, and it's also the fallback one — like, the reliable friend who shows up no matter what. 🫶

What it does: it sends events between processes and threads using serialized files in a temporary directory. That's it. That's the whole mechanism. Files in a tmpdir, vibes intact.

Is it fast? Ngl, not particularly 😭 — this is not the speedrun build. But it works everywhere, and honestly? That's giving main character energy. Portability queen. 👑

🌸 SYNOPSIS 🌸

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

# IPC is now enabled

Literally two lines and you're done. Slay. ✨

🎀 ENVIRONMENT VARIABLES 🎀

These are your little dials, bestie — set them and the driver behaves accordingly:

  • T2_KEEP_TEMPDIR=0 — when this is true, the tempdir that the IPC driver uses will not be deleted when the test is done. So it just... stays there. Forever. Like a screenshot you forgot to delete. 🔥
  • T2_TEMPDIR_TEMPLATE='test2-XXXXXX' — this one lets you set the template for the IPC temp dir. The template should follow the template specifications from File::Temp. Iykyk — don't just make up your own placeholder rules, follow File::Temp's, ok? 💅

🦋 SEE ALSO 🦋

Check out Test2::IPC::Driver for methods. That's where the actual method docs live, so go look there if you need the how-to. 🫡

🌈 SOURCE 🌈

The source code repository for Test2 can be found at <https://github.com/Test-More/test-more/>. Go star it, go read it, go be obsessed. ⭐

👑 MAINTAINERS 👑

Chad Granum <exodist@cpan.org>

💜 AUTHORS 💜

Chad Granum <exodist@cpan.org>

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/>

fr fr that's the whole page. No cap, no skipped sections. 💀

Okay and last thing — the official paperwork says this page ships with perl v5.42.0, dated 2025-07-28, and the manual name is Test2::...r::Files(3) (the truncated little gremlin in the header). Byeee, go keep your tempdirs cute 🧚💖

📦 where this page comes from