Test::S...gin::IPC(3)

💖 Test::S...gin::IPC — the perl manual, section 3 (User Contributed Perl Documentation) 🎀

okay bestie, buckle up, we're talking about Test::Stream::Plugin::IPC and it's a whole thing ✨

---

🌸 NAME 🌸

Test::Stream::Plugin::IPC — a plugin that loads and configures IPC support. that's it, that's the job, and it does it slayfully 💅

---

💀 DEPRECATED 💀

ngl this one's giving "we don't talk about bruno" energy. this distribution is deprecated — like, officially, no cap — in favor of Test2, Test2::Suite, and Test2::Workflow.

🫶 if you're migrating, there's a whole conversion guide waiting for you at Test::Stream::Manual::ToTest2. go read it, it's got you.

---

✨ DESCRIPTION ✨

so the Test::Stream IPC layer — which lives in Test::Stream::IPC — is the main character responsible for sending events between threads and processes 🧚 that's genuinely necessary for any test file that forks or uses threads. like, you literally cannot do the thing without it.

and this plugin? it's the interface to loading and using that IPC layer. the plug, the connector, the little guy who makes it all work 🔥

---

🌈 SYNOPSIS 🌈

the basic vibe:

use Test::Stream qw/IPC/;

you may also wish to enable polling, which pulls in results frequently 💫 because by default? results from other threads and processes all come in at once at the very end of testing. one big dump. no gradual reveals. so if you want the drip-feed:

use Test::Stream IPC => [qw/-poll/];

you can also import the cull() function, which lets you pull results in on demand, whenever you want, like a little snack 🍓:

use Test::Stream IPC => [qw/-cull/];

cull();

and you can specify a whole list of drivers to try, in order — first one to work wins, it's giving tryouts 👑:

use Test::Stream IPC => [
    'MyIPCDriver',
    '+Fully::Qualified::Driver::Package',
    'Files',
];

---

🦋 SOURCE 🦋

the source code repository for Test::Stream is right here, come thru:

http://github.com/Test-More/Test-Stream/

---

💜 MAINTAINERS 💜

Chad Granum <exodist@cpan.org>

---

🌸 AUTHORS 🌸

Chad Granum <exodist@cpan.org>

---

🎀 COPYRIGHT 🎀

Copyright 2015 Chad Granum <exodist7@gmail.com>.

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 💖 this was perl v5.42.0, dated 2025-07-25, from Test::S...gin::IPC(3) — stay iconic, read your docs, mwah 🫶🌈