NAME

       DPKG::Parse - Parse various dpkg files into Perl Objects

SYNOPSIS

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

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

DESCRIPTION

       DPKG::Parse contains utilities to parse the various files created by dpkg and turn them
       into helpful Perl objects.  Current files understood by various DPKG::Parse modules:

         /var/lib/dpkg/status    - DPKG::Parse::Status
         /var/lib/dpkg/available - DPKG::Parse::Available
         Packages.gz             - DPKG::Parse::Packages

       See each module's documentation for particulars - You should not be calling DPKG::Parse
       directly.

METHODS

       filename($filename)
           A simple accessor for the file currently being parsed.

       entryarray
           Access to the raw array of entries in a given file.

       entryhash
           Access to the raw hash of entries.  The key is determined by the module, but is
           usually the Package name.

       new('filename' => '/var/lib/dpkg/status');
           A generic new function; takes a filename and calls the filename() accessor with it.
           Should not be called directly, but through on of the children of this package.

       parse
           A default parse function; simply calls parse_package_format.

       parse_package_format
           Takes a file in a format similar to the dpkg "available" file, and creates
           DPKG::Parse::Entry objects from each entry.

       get_package('name' => 'postfix', 'hash' => 'entryhash');
           The value of a hash, if it exists.  By default, it uses the value returned by the
           "entryhash" accessor, but that can be overridden with the "hash" parameter.  Usually
           returns a DPKG::Parse::Entry object.

       next_package
           Shifts the next value off the array stored in the entryarray() accessor.  If you want
           to access the raw values, do not use this function!  It shifts!

SEE ALSO

       DPKG::Parse::Status, DPKG::Parse::Available, DPKG::Parse::Packages, DPKG::Parse::Entry

AUTHOR

       Adam Jacob, "holoway@cpan.org"

LICENSE

       This library is free software. You can redistribute it and/or modify it under the same
       terms as perl itself.