NAME

DPKG::Parse::Entry - Parse a Package style entry

SYNOPSIS

   use DPKG::Parse::Entry;

   my $data = <<EOH;
Package: kernel-image-2.6.12.2
Source: kernel-source-2.6.12.2
Version: wrk01
Priority: optional
Section: base
Maintainer: Jamie Heilman <jamie@marchex.com>
Depends: coreutils | fileutils (>= 4.0)
Suggests: lilo (>= 19.1) | grub, fdutils, kernel-doc-2.6.12.2 | kernel-source-2.6.12.2
Provides: kernel-image, kernel-image-2.6
Architecture: i386
Filename: packages/./kernel-image-2.6.12.2_wrk01_i386.deb
Size: 4293154
Installed-Size: 10312
MD5sum: 2acf846b127b71a1fa1143214b2b85a9
Description: Linux kernel binary image for version 2.6.12.2. 
EOH

   my $entry = DPKG::Parse::Entry->new('data' => $data);

   print $entry->package . " " . $entry->version . "\n";

   $entry->package("kernel-foobar");

DESCRIPTION

DPKG::Parse::Entry parses a dpkg "Package" file entry, creating a new DPKG::Parse::Entry instance for it. You submit the contents, beginning with a "Package:" line, as the 'data' argument to new. After that, all the data is populated as lowercased instance methods. For example, if we used the above to create an $entry object, we would have:

$entry->package == "kernel-image-2.6.12.2"
$entry->size    == 4293154
$entry->md5sum  == 2acf846b127b71a1fa1143214b2b85a9

DPKG::Parse::Entry will skip any attribute it does not know about. You can see what it has skipped by passing a true value to the 'debug' option to 'new()'.

It should know all the attributes present in a Packages, available, and status file.

See DPKG::Parse::Status, DPKG::Parse::Available, and DPKG::Parse::Packages for more information on how to easily generate DPKG::Parse::Entry objects.

METHODS

Accessor Methods

The following accessor methods correspond directly to the values found in the parsed Package block, with one exception: "-" characters are replaced with "_". So, "build-essential" becomes "build_essential".

The accessors are:

architecture 
bugs 
build_essential
conflicts 
config_version
conffiles
depends 
description 
enhances 
essential 
filename 
installed_size
maintainer 
md5sum 
origin 
package 
priority 
provides 
pre_depends
recommends 
replaces 
size 
source 
section 
suggests 
status 
task 
tag
url 
version

new('data' => $data, 'debug' => 1)

Creates a new DPKG::Parse::Entry object. 'data' should be a scalar that contains the text of a dpkg-style Package entry. If the 'debug' flag is set, we will Carp about entries we don't have accessors for.

parse('data' => $data);

Does the actual parsing of the Package block given to new(). Probably should only be called once per object.