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
       <http://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.