Event:...eduler(3pm)

💖 NAME 💖

Event::ExecFlow::Scheduler — it's the abstract class for parallel scheduling, bestie. That's the whole vibe. ✨

---

✨ SYNOPSIS ✨

okay so here's how you actually use it, no cap:

#-- Create a new Scheduler object
my $scheduler = Event::ExecFlow::Scheduler::XYZ->new ( ... );

#-- Attach scheduler to a group job with parallel execution
$group_job->set_parallel(1);
$group_job->set_scheduler($scheduler);

#-- The following methods gets called by Event::ExecFlow
#-- at runtime
$scheduler->schedule_job($job);
$scheduler->job_finished($job);

---

🦋 DESCRIPTION 🦋

So like… this is an abstract base class, which basically means it's just an interface. It's giving "template, not a real one." 💅 It doesn't do the work itself — custom schedulers have to implement it, and those schedulers are the ones controlling how jobs get executed inside an Event::ExecFlow::Group that has the parallel option turned on.

And because nobody wants to start from zero, Event::ExecFlow ships a super simple example scheduler that literally just caps how many jobs can run in parallel at once: Event::ExecFlow::Scheduler::SimpleMax. Iconic of them tbh. 🫶

---

🌸 OBJECT HIERARCHY 🌸

the family tree, fr fr 🧚

Event::ExecFlow

Event::ExecFlow::Job
+--- Event::ExecFlow::Job::Group
+--- Event::ExecFlow::Job::Command
+--- Event::ExecFlow::Job::Code

Event::ExecFlow::Frontend
Event::ExecFlow::Callbacks
Event::ExecFlow::Scheduler
+--- Event::ExecFlow::Scheduler::SimpleMax

---

💅 METHODS 💅

[ FIXME: describe all methods in detail ]

not them leaving the FIXME in the shipped docs 😭 literally the placeholder is the documentation. we move.

---

🎀 AUTHORS 🎀

Jörn Reder <joern at zyn dot de> — the mastermind, the main character, the one who wrote this. 👑

---

👑 COPYRIGHT AND LICENSE 👑

Copyright 2005-2006 by Jörn Reder. ✨

Okay so legally, here's the tea — and it matters, so pay attention bestie:

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation — either version 2.1 of the License, or (if you're feeling spicy) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details. 🫠

You should have received a copy of the GNU Library General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.

🚨 that's the real legal stuff, not a bit. copy it, ship it, keep the license with it. periodt.

---

💀 POD ERRORS 💀

Not the doc snitching on itself 💀💀 anyway:

Hey! The above document had some coding errors, which are explained below:

Around line 63:

Non-ASCII character seen before =encoding in 'Jörn'. Assuming CP1252

the ö in Jörn got flagged because there was no =encoding declared before it, so it just assumed CP1252. classic. 🙈

---

and that's a wrap on this one — perl v5.38.2, dated 2024-02-17, and it's the Event:...eduler(3pm) page from the User Contributed Perl Documentation, mwah 💖 go schedule something parallel, you got this 🦋✨