Acme::POE::Knee(3pm)

💖 Acme::POE::Knee 💖

okay bestie, buckle UP, because this is the Acme::POE::Knee manual page (that's the 3pm one, perl module docs, iykyk) and it's literally about racing ponies. time-sliced ponies. using the POE kernel. no I'm not kidding.

✨ NAME ✨

Acme::POE::Knee — it's a time sliced pony race, and it runs on the POE kernel. that's the whole vibe. 🐴

---

🎀 VERSION 🎀

version 1.12 — yes queen, we're on 1.12.

---

🌸 SYNOPSIS 🌸

here's the whole thing, copy-paste-able, no notes:

#!/usr/bin/perl -w
use strict;

# Use POEny!
use Acme::POE::Knee;

# Every Acme::POE::Knee race will require a set of arguments.
# There are defaults but it's just more fun to set these
# yourselves. We set a distance the ponies must run and of course
# we name our race ponies! You'll have to specify the maximum
# delay a pony can have before reaching the next stage.
# The lower the delay, the higher the chances are the pony will
# win the race.

my $pony = new Acme::POE::Knee (
          dist   => 20,
    ponies  => {
        'dngor'     => 5,
        'Abigail'   => 5.2,
        'Co-Kane'   => 5.4,
        'MJD'       => 5.6,
        'acme'      => 5.8,
    },
);

# start the race
$pony->race( );

exit;

okay so real talk, every single race needs a set of arguments. there are defaults, but setting them yourself is just objectively more fun, so. you give it a distance the ponies have to run, you name your race ponies (obvi), and you have to specify the maximum delay a pony can have before it reaches the next stage. and here's the tea: the lower the delay, the higher the chances the pony wins the race. so yeah, dngor at 5 is the fastest in that lineup. periodt.

---

🦋 DESCRIPTION 🦋

POE::Knee is an acronym of "Pony". (yes really. iconic.) we all like ponies. and wouldn't we love to race ponies?? well babes, that's literally what Acme::POE::Knee is for! 💅

it's perfect for those friday afternoons at the office where everyone's wondering who's gonna pay the beer tab. and here's the twist: whoever 'wins' the race, loses 😭 so it's giving lose-to-win, it's giving sacrifice, it's giving "not me paying for rounds".

you specify a distance the ponies must run, plus a maximum delay before the pony will reach the next step. so the bigger the delay, the bigger the distance between multiple ponies can be. math, but make it horse girl.

and of course it wouldn't be any fun if we couldn't name the ponies ourselves?? so we just drop all our race ponies into an array reference and the Acme::POE::Knee module handles the rest. she's got it. 🫶

---

🔥 QUICK LINKS 🔥

• please go look at the samples directory in POE's distribution — there are several well-commented sample and tutorial programs in there and they're genuinely so good.
• also please see <http://www.perl.com/pub/2001/01/poe.html> for an excellent intro to POE, and more importantly: a gradual one. (gradual is the key word bestie, that article ate.)

---

🌈 USING Acme::POE::Knee 🌈

using Acme::POE::Knee is really, truly easy. this simple program alone would already suffice:

use strict;
use Acme::POE::Knee;

my $pony = new Acme::POE::Knee;
$pony->race();
exit;

that uses the defaults of the POE::Knee module, but you can of course specify your own arguments, exactly like the synopsis shows. go off.

---

👑 The Use of Acme::POE::Knee 👑

"use" — yes. "useful"? ...probably not. 💀

this was written in response to a rather persistent meme on #perl (you know who you are!). basically, we all wanted ponies. well folks, here it is. dreams do come true.

and lowkey, its source might actually be interesting to look at if you're a newcomer to POE and you wanna see how this time slicing thing works. educational slay.

---

🧚 Learning more about POE 🧚

💌 The POE Mailing List

POE has a mailing list at perl.org. you can receive subscription information by sending e-mail:

To: poe-help@perl.org
Subject: (anything will do)

The message body is ignored.

all forms of feedback are welcome!! (yes, all forms. they said it, not me.)

⭐ The POE Web Site

POE has a web site where the latest development snapshot lives, along with the Changes file and other stuff: <http://poe.perl.org/> — go peek, it's cute.

---

🍓 AUTHORS 🍓

• Jos Boumans <kane@cpan.org>
• Rocco Caputo <rcaputo@cpan.org>

two absolute legends, respect.

---

💜 COPYRIGHT AND LICENSE 💜

this software is copyright (c) 2011 by Jos Boumans.

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 like, free free. share the pony wealth.

---

and that's the whole page, bestie!! this was perl v5.36.0 documentation, dated 2022-11-27, and it's the Acme::POE::Knee(3pm) page — mwah, sending you off with the pony race of your dreams 🐴✨🫶