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.