Debbugs::Bugs(3pm)

📦
version 2.6.5 · 4 versions
, in ubuntu stonking

✨ Debbugs::Bugs — the bug-picking bestie of debbugs ✨

okay so real talk, this is Debbugs::Bugs, a Perl module from the User Contributed Perl Documentation, and it's literally the glow-up replacement for every messy way you used to select bugs. it lives in the 3pm man section bestie, and it's giving main character energy for bug selection. 💅

🌸 NAME 🌸

Debbugs::Bugs — bug selection routines for debbugs 🐛✨

🎀 SYNOPSIS 🎀

use Debbugs::Bugs qw(get_bugs);

like, that's it. that's the whole vibe. 🫶

💖 DESCRIPTION 💖

so basically this module is the ✨replacement✨ for ALL of the various methods of selecting different types of bugs. yes, all of them. she ate and left no crumbs. 💅

she implements a single function, get_bugs, which defines the master interface for selecting bugs. one function to rule them all, periodt. 👑

and the way she works is iconic — she attempts to use subsidiary functions to actually do the selection, in the order specified in the configuration files. 🔥

ngl bestie, unless you're literally insane, they should be in order from fastest (and often most incomplete) to slowest (and most complete). that's just the vibe check okay. 😭

💀 BUGS 💀

(no content here in the original, bestie — she's just sitting there, silently, like a mood. 🙈)

👑 FUNCTIONS 👑

🦋 get_bugs

get_bugs()

✨ Parameters ✨

okay so listen — the following parameters can either be a single scalar OR a reference to an array. the parameters are ANDed together (all of them gotta match, no cap), and the elements of arrayrefs in a parameter are ORed (any of them matching is enough, slay). future versions of this may allow for limited regular expressions, and/or more complex expressions — so like, watch this space bestie. 👀

  • package — name of the binary package 📦
  • src — name of the source package 📂
  • maint — address of the maintainer 📧
  • submitter — address of the submitter 🙋
  • severity — severity of the bug 🚨
  • status — status of the bug 📊
  • tag — bug tags 🏷️
  • owner — owner of the bug 👤
  • correspondent — address of someone who sent mail to the log ✉️
  • affects — bugs which affect this package 🎯
  • dist — distribution (ngl I don't know about this one yet 😭)
  • bugs — list of bugs to search within 🐛
  • function — see description below 👇

🌈 Special options 🌈

these are the special options used to modulate how the searches are performed — the little seasoning on top, iykyk. 🧂✨

  • archive — whether to search archived bugs or normal bugs; defaults to false. and as a special case bestie, if archive is 'both', then both archived and unarchived bugs are returned. iconic behaviour honestly. 💅
  • usertags — set of usertags and the bugs they are applied to 🏷️

🧚 Subsidiary routines 🧚

all subsidiary routines get passed exactly the same set of options as get_bugs. and if for some reason they are unable to handle the options passed (like, for example, they don't have the right type of index for the type of selection) they should die as early as possible. dramatic? yes. necessary? also yes. 💀

using Params::Validate and/or die when files don't exist makes this fairly trivial, so like, no excuses bestie. ✨

this function will then immediately move on to the next subroutine, giving it the same arguments. she's efficient like that. 🏃‍♀️💨

⭐ function ⭐

this option allows you to provide an arbitrary function which will be given the information in the index.db file. and bestie, I gotta be honest with you — this will be super, super slow, so only do this if there's literally no other way to write the search. like, last resort energy fr fr. 😭

you'll be given a list (which you can turn into a hash) like the following:

(pkg => ['a','b'], # may be a scalar (most common)
 bug => 1234,
 status => 'pending',
 submitter => 'boo@baz.com',
 severity => 'serious',
 tags => ['a','b','c'], # may be an empty arrayref
)

and the function should return 1 if the bug should be included; 0 if the bug should not. simple as that, no notes. ✅

💜 count_bugs

count_bugs(function => sub {...})

uses a subroutine to classify bugs into categories and return the number of bugs which fall into those categories. counting era 🔢✨

🍓 newest_bug

my $bug = newest_bug();

returns the bug number of the newest bug, which is nextnumber-1. fresh off the press, the newest baby bug 🐣

🧁 bug_filter

bug_filter

allows filtering bugs on commonly used criteria. she's picky and that's valid 💅

💫 get_bugs_by_idx

this routine uses the by-$index.idx indicies to try to speed up searches. yes she's trying to be fast, let her cook 🔥

🌸 get_bugs_flatfile

this is the fallback search routine. it should be able to complete all searches. [or at least, that's the idea.] 🫠

🔒 PRIVATE FUNCTIONS 🔒

🌟 __handle_pkg_src_and_maint

my @packages = __handle_pkg_src_and_maint(map {exists $param{$_}?($_,$param{$_}):()}
                                          qw(package src maint)
                                         );

turn package/src/maint into a list of packages. boom, transformed. ✨🦋

and that's the whole page bestie!! this was perl v5.40.1, dated 2026-04-27, from the Debbugs::Bugs(3pm) manual in the User Contributed Perl Documentation. go forth and select your bugs responsibly, ily, mwah 💖🎀✨👑

📦 where this page comes from