Test::S...stQueue(3)

📦
version 1.84 · 2 versions
, in fedora 43

💖 Test::S...stQueue(3) 💖

okay bestie, so this is a page from the User Contributed Perl Documentation section, and it's literally called Test::S...stQueue(3) (yes the name got truncated, the vibes are immaculate, we move). Let's get into it 🫶

✨ NAME ✨

Test::Smoke::PostQueue — it's a queue mechanism for re-posting reports. that's the whole thing. a little queue. re-posting reports. iconic behavior 💅

🌸 SYNOPSIS 🌸

use Test::Smoke::PostQueue;
my $queue = Test::Smoke::PostQueue->new(
    qfile  => $qfile,
    adir   => $adir,
    poster => $poster
);

$queue->add($patch);

$queue->handle_queue();

see how easy that is?? you make the queue, you add to the queue, you handle_queue(). three steps. that's it. that's the whole flow ✨

🦋 DESCRIPTION 🦋

so here's the tea: this thing is implemented as a singleton. one of them. just the one. there can only be one, main character energy fr fr 👑

⚠️ and listen, it can only work if archiving is true. if archiving isn't true, bestie, it's not happening. no archiving, no queue. periodt.

🌈 Test::Smoke::PostQueue->new(%arguments)

Returns you an instantiated object 💖 — and here's the cute part: if it was already created, it just returns that one. same object. no new ones. singleton said what it said.

Arguments

Named, list — like, you pass them by name, in a list:

  • qfile — the file we keep the queue in. and it's cute because it's one patchlevel per line 🍓
  • adir — the archive directory where we get the report (the jsn one) from 📁
  • poster — this has to be an instance of Test::Smoke::Poster with ddir set to adir. not optional, not vibes-based, it must be that 🎀
  • v — verbosity. turn it up, turn it down, live your truth 🔊

⭐ $queue->add($patchlevel)

Adds an item to the queue-file. that's the move. one item, into the file. slay 💅

🧚 $queue->handle()

This reads the queue-file and tries to post every report it can find in the archive. every single one it can find. it's out here doing the work, no cap 🔥

💜 $queue->purge

Removes all entries that do not exist in adir. bye to the ghosts 👋💀

© 2002-2013, Abe Timmerman <abeltje@cpan.org> All rights reserved.

See AUTHORS for contributers. (their spelling, not mine, we respect it 🙈)

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

See:

This program 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. so like, no promises bestie, it's giving "use at your own risk but lovingly" 😭💖

and that's the whole page!! written by the Perl documentation crew, shipped with perl v5.42.0, dated 2025-07-25, and it lives at Test::S...stQueue(3) forever 🌈✨ mwah, go queue something 🎀💅

📦 where this page comes from