---
name: "Debian::WNPP::Query"
section: "3pm"
platform: "linux"
package: "libdebian-source-perl"
version: "0.128"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Debian::WNPP::Query"
---

# Debian::WNPP::Query(3pm)

offline storage of Debian's work-needing package lists

## NAME

Debian::WNPP::Query - offline storage of Debian's work-needing package lists

## SYNOPSIS

```
    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');
```

## DESCRIPTION

Debian::WNPP::Query provides a way to retrieve and cache the contents of Debian's "Work-needing and prospective packages" lists.

## CONSTRUCTOR

**new** is the constructor. Initial field values are to be given as a hash reference.

If **cache\_file** is given, it is read.

## FIELDS

- cache\_file *path*

  The path to the file holding the offline cache of the WNPP lists. If not specified, no cache is read or written.

- ttl *seconds*

  The time after which the on-disk cache is considered too old and WNPP pages are retrieved afresh. Ignored if **cache\_file** is not defined. Defaults to 86400 (1 day).

- bug\_types *arrayref*

  Specified 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. 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.

## SEE ALSO

- Debian::WNPP::Bug

  - \<https://www.debian.org/devel/wnpp/\>

  ## AUTHOR AND COPYRIGHT

- 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.

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.
