---
name: "DPKG::Parse::Entry"
section: "3pm"
platform: "linux"
package: "libdpkg-parse-perl"
version: "0.03-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/DPKG::Parse::Entry"
---

# DPKG::Parse::Entry(3pm)

Parse a Package style entry

## 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.