Debian...::Query(3pm)

📦
version 0.133 · 7 versions
, in ubuntu stonking

💖 Debian::WNPP::Query — the manual, but make it make sense 💖

okay so bestie, welcome to the Debian::WNPP::Query(3pm) page — a Perl module, section 3pm of the manual, and honestly? it's giving "offline storage of Debian's work-needing package lists" and I'm obsessed. it's Debian::WNPP::Query and it's about to be your new fave.

✨ NAME ✨

Debian::WNPP::Query — offline storage of Debian's work-needing package lists. no cap, that's literally the whole job.

🌸 SYNOPSIS 🌸

here's the vibe:

my $wnpp = Debian::WNPP::Query->new(
    {   cache_dir       => '/somewhere',
        network_enabled => 0,
        ttl             => 3600 * 24,
        bug_types       => [qw( ITP RFP )]
    }
);

my @bugs = $wnpp->bugs_for_package('ken-lee');

look at her. she's doing so much with so little. 💅

🦋 DESCRIPTION 🦋

Debian::WNPP::Query gives you a way to retrieve and cache the contents of Debian's "Work-needing and prospective packages" lists. that's it, that's the queen energy. 📥✨

🎀 CONSTRUCTOR 🎀

new is the constructor, as always, main character behaviour. initial field values are to be given as a hash reference — you hand her a { ... }, she handles the rest.

if cache_file is given, it is read. simple as. 📖

🍓 FIELDS 🍓

  • cache_file path — the path to the file holding the offline cache of the WNPP lists. if you don't specify it, no cache is read or written, like, at all. none. gone. 🫥
  • ttl seconds — the time after which the on-disk cache is considered too old and WNPP pages are retrieved afresh. she's not gonna let stale data hang around, periodt. 👑 ignored if cache_file is not defined. defaults to 86400 (that's 1 day, bestie).
  • bug_types arrayref — specifies which bug types to retrieve. for example, if you are interested in ITP and RFP bugs, there is no point in downloading, parsing and storing ITA/RFA/O bugs — like why would you, that's wasted effort. by default all types of bugs are processed. 🌈

💜 METHODS 💜

  • bugs_for_package(package) — returns a list of bugs matching the given package name. normally the list would contain only one bug, but there are no guarantees, so don't come for her if it's a surprise party. 😭 usually one, no promises, iykyk.

💅 SEE ALSO 💅

Copyright (C) 2010 Damyan Ivanov <dmn@debian.org>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2 as published by the Free Software Foundation.

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. See the GNU General Public License for more details. ⚠️ (yes, that's the legal all-caps shout, she means it.)

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ✉️

no cap, that's the whole page. go file some bugs, bestie. 🧚💖

and that's a wrap on the perl v5.40.1 manual page, dated 2026-05-08 — slay, stay iconic, see you in the next man page. 🎀✨

📦 where this page comes from