Sendpage::Queue(3)

💖 Sendpage::Queue(3) 💖

okay bestie, welcome to the Sendpage::Queue(3) page from the User Contributed Perl Documentation section. it’s giving “short but useful,” and we’re keeping every crumb. ✨

🌸 NAME 🌸

Queue.pm — implements a simple directory-based file queue. that’s the whole name card, and honestly it ate. 💅

🦋 SYNOPSIS 🦋

here’s the synopsis, untouched and slaying in its natural habitat:

$queue=Sendpage::Queue->new($dir);

while ($queue->ready()) {
    $filename=$queue->file();
    $fh=$queue->getReadyFile();
    if ($can_remove_file) {
        $queue->fileToss();
    }
    else {
        $queue->fileDone();
    }
}

# open a new queue file
$fh=$queue->getNewFile();
# ... do things to the file handle here
# release the file
$queue->doneNewFile();

so yeah: you spin up a queue with Sendpage::Queue->new($dir), loop while $queue->ready(), grab $queue->file() and $queue->getReadyFile(), and then either $queue->fileToss() if $can_remove_file is true or $queue->fileDone() if it isn’t. for a new queue file you call $queue->getNewFile(), do your thing with the file handle, and release it with $queue->doneNewFile(). 🫶

🎀 DESCRIPTION 🎀

this is a module for use in sendpage(1). literally that’s the description, and it’s iconic in its minimalism. 🌈

💀 BUGS 💀

no cap, the bug note is just: Need to write more docs. so go write more docs, bestie — the docs are lowkey the main character here. 😭

👑 AUTHOR 👑

Kees Cook <kees@outflux.net> — yes, that’s the author, and they’re serving credit where credit is due. 💜

🔥 SEE ALSO 🔥

go look at all of these, iykyk:

• perl(1)
• sendpage(1)
• Sendpage::KeesConf(3)
• Sendpage::KeesLog(3)
• Sendpage::Modem(3)
• Sendpage::PagingCentral(3)
• Sendpage::PageQueue(3)
• Sendpage::Page(3)
• Sendpage::Recipient(3)

⭐ COPYRIGHT ⭐

Copyright 2000 Kees Cook.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

mwah! 💋 that’s the whole page. source/version: perl v5.40.2; date: 2024-06-10; and it’s Sendpage::Queue(3) — bye bestie! 🫶💖