Test::...emonize(3pm)

💖 Test::MooseX::Daemonize — the Test::...emonize(3pm) page, but make it cute 💖

okay so bestie, this is a page from the User Contributed Perl Documentation collection, and it's literally the whole manual for Test::MooseX::Daemonize. It's short, it's sweet, it's giving helpful little test helper, and we're gonna go through <em>every single bit</em> of it together. No skipping. Periodt. 💅

---

✨ NAME ✨

Test::MooseX::Daemonize — a tool to help test MooseX::Daemonize applications. That's it, that's the whole vibe. It's the friend that holds your hand while you test your daemons. 🫶

---

🌸 VERSION 🌸

version <code>0.22</code> — that's the one we're on, bestie. 🎀

---

🦋 SYNOPSIS 🦋

Here's the little taste test, copied <em>exactly</em> so you can run it and feel iconic:

use File::Spec::Functions;
use File::Temp qw(tempdir);

my $dir = tempdir( CLEANUP => 1 );

## Try to make sure we are in the test directory

my $file = catfile( $dir, "im_alive" );
my $daemon = FileMaker->new( pidbase => $dir, filename => $file );

daemonize_ok( $daemon, 'child forked okay' );
ok( -e $file, "$file exists" );

Not me reading this and being like "oh we're forking a child and checking a file exists, slay." Yes. That is exactly what's happening. 💀

---

💜 DESCRIPTION 💜

So, what does this module even do? It hands you some basic <code>Test::Builder</code>-compatible test methods — you know, the kind that slot right into your test suite without drama — for when you're writing tests for your <code>MooseX::Daemonize</code>-based modules. That's the whole point. It's a helper. It's a bestie. It's not trying to be anything else. 🧚

---

🎀 EXPORTED FUNCTIONS 🎀

These are the little functions it gives you. Two of them. Both adorable. Both important. 💖

• daemonize_ok ( $daemon, ?$msg ) — This one tries to daemonize your $daemon, and it goes ok on success and not ok on failure. The ?$msg is the optional message you can hand it, because every test deserves a little caption. 💅
• check_test_output ( $daemon ) — okay so this one is expected to be used with a $daemon that does the <code>Test::MooseX::Daemonize::Testable</code> role (that role is included in this package, and the original literally says to <em>see the source for more info</em>). What it does: it collects the test output from your daemon and applies it in the parent process by mucking around with Test::Builder stuff — and again, the original says <em>read the source for more info</em>. And then, iconic behaviour honestly: "If we get time we will document this more thoroughly." 😭 We love a candid queen. The docs are vibes-based and the source is the truth. 🫶

---

🌈 SEE ALSO 🌈

• MooseX::Daemonize — the main character this whole module exists to support. 👑

---

🍓 SUPPORT 🍓

Need help? Got beef with a bug? The original lays out the whole support situation, so here it is:

• Bugs may be submitted through the RT bug tracker at https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-Daemonize, or you can email bug-MooseX-Daemonize@rt.cpan.org.
• There's also a mailing list for users of this distribution at http://lists.perl.org/list/moose.html. 🫶
• And there's an irc channel for users of this distribution too — it's "#moose" on "irc.perl.org" (irc://irc.perl.org/#moose). Come say hi, iykyk. 💬

---

👑 AUTHORS 👑

The legends who made this happen:

1. Stevan Little <stevan.little@iinteractive.com>
2. Chris Prather <chris@prather.org>

Two icons. One tiny testing module. ✨

---

💅 COPYRIGHT AND LICENCE 💅

This software is copyright (c) 2007 by Chris Prather.

And the legal tea, verbatim in meaning: this is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. So go forth and remix, bestie. 🌸

---

okay and finally, the cute lil sign-off: this whole page is from perl v5.30.0, dated 2019-12-22. 🎀 That's the tea, that's the page, go write some tests and slay. 💖✨🦋