DBIAgent::Queue(3pm)

🦋 NAME 🦋

okay bestie, meet POE::Component::DBIAgent::Queue — it's a helper class for managing a round-robin queue of Po:Co:DBIAgent:Helper's. that's the whole vibe. it's the little line-manager keeping all your helpers taking turns like the absolute icons they are 💅

---

✨ SYNOPSIS ✨

sooo the original page just. doesn't have one. no synopsis, no code, nothing. it's giving mysterious. lowkey iconic of it tbh 🎀

---

💖 DESCRIPTION 💖

🌸 Methods 🌸

these are the methods we recognize (its words, not mine, but fr fr):

• init — init the queue. currently it's a noop, so it's just standing there being decorative. we love a method that does nothing and owns it 💀
• add — append argument to the queue. yes, the description literally just says "append argument to the queue". short. sweet. to the point. periodt.
• clear — clear the queue. bye bye queue contents 👋
• find_by_pid — find the index of the helper with the specified pid.
• find_by_wheelid — find the index of the helper with the specified wheel id.
• remove_by_pid — remove the helper with the specified pid.
• remove_by_wheelid — remove the helper with the specified wheel id.
• next — get the next helper off the head of the queue, and then put it back on the end, because round robin. it's a carousel bestie, everyone gets a turn 🎠
• make_next — force the helper with the specified wheel id to the head of the queue. main character promotion, no waiting in line 💅
• exit_all — tell all our helpers to exit gracefully. so polite. so well-mannered 🫶
• kill_all — send the specified signal (default SIGTERM) to all helper processes. okay so when graceful isn't the mood, this is the mood. it defaults to SIGTERM, and you can specify a different signal if you're feeling spicy 🔥

heads up: kill_all really does send signals to all the helper processes, so know what signal you're sending before you send it, bestie 😭

---

👑 AUTHOR 👑

this module has been fine-tuned and packaged by Rob Bloodgood <robb@empire2.com>. but plot twist: most of the code came directly from Fletch <fletch@phydeaux.org> and got adapted for the release of POE::Component::DBIAgent. thank you, Fletch! 🙏

however — and this is a direct quote, i could never — "I own all of the bugs." not me admitting that in the official docs. iconic. no cap 💀

this module is free software; you may redistribute it and/or modify it under the same terms as Perl itself. so go forth and remix, bestie 🌈

---

and that's the page! the docs themselves were built with perl v5.32.0 and stamped 2021-01-08 — so this whole thing is a little vintage, a classic, an heirloom even 🎀 stan a legacy module. mwah 💋