File Coverage

blib/lib/DPKG/Parse/Available.pm

Criterion	Covered	Total	%
statement	9	9	100.0
branch			n/a
condition			n/a
subroutine	3	3	100.0
pod			n/a
total	12	12	100.0

#
# DPKG::Parse::Available.pm
# Created by: Adam Jacob, Marchex,
# Created on: 12/19/2005 02:21:25 PM PST
#
# $Id: $
#

=head1 NAME

DPKG::Parse::Available - Parse the "available" file

=head1 SYNOPSIS

    use DPKG::Parse::Available;

    my $available = DPKG::Parse::Available->new;
    while (my $entry = $available->next_package) {
        print $entry->package . " " . $entry->version . "\n";
    }

    my $postfix = $available->get_package('name' => 'postfix');

=head1 DESCRIPTION

L parses a dpkg "available" file and turns
each entry into a L object.  By default, it uses
the Debian default location of "/var/lib/dpkg/available".

See L for more information on the get_package and next_package
methods.

See L for more information on the entry objects.

=head1 METHODS

=over 4

=cut

package DPKG::Parse::Available;

use Params::Validate qw(:all);
use Class::C3;
use base qw(DPKG::Parse);
use strict;
use warnings;

=item new('filename' => '/var/lib/dpkg/available')

Creates a new DPKG::Parse::Available object.  By default, it tries to open
/var/lib/dpkg/available.

=cut
sub new {
    my $pkg = shift;
    my %p = validate(@_,
        {
            'filename' => { 'type' => SCALAR, 'default' => '/var/lib/dpkg/available', 'optional' => 1 },
        }
    );
    my $ref = $pkg->next::method('filename' => $p{'filename'});
    return $ref;
}

1;

__END__