NAME

       DPKG::Log::Entry - Describe a log entry in a dpkg.log

VERSION

       version 1.20

SYNOPSIS

       use DPKG::Log::Entry;

       $dpkg_log_entry = DPKG::Log::Entry->new( line => $line, $lineno => 1)

       $dpkg_log_entry->timestamp($dt);

       $dpkg_log_entry->associated_package("foo");

DESCRIPTION

       This module is used to describe one line in a dpkg log by parameterizing every line into
       generic parameters like

       •  Type of log entry (startup-, status-, action-lines)

       •  Timestamp

       •  Subject of log entry (e.g. package, packages or archives)

       •  Package name (if log entry refers to a package subject)

       and so on.

       The various parameters are described below together with the various methods to access or
       modify them.

METHODS

       $dpkg_log_entry = PACKAGE->new( 'line' => $line, 'lineno' => $lineno )
           Returns a new DPKG::Log::Entry object.  The arguments line and lineno are mandatore.
           They store the complete line as stored in the log and the line number.

           Additionally its possible to specify every attribute the object can store, as 'key' =>
           'value' pairs.

ATTRIBUTES

       $dpkg_log_entry->line() / line
           Return the full log line. This attribute is set on object initialization.

       $dpkg_log_entry->lineno() / lineno
           Return the line number of this entry. This attribute is set on object initialization.

       $dpkg_log_entry->timestamp() / timestamp
           Get or set the timestamp of this object. Should be a DateTime object.

       $dpkg_log_entry->type() / type
           Get or set the type of this entry. Specifies weither this is a startup, status or
           action line.

       $dpkg_log_entry->associated_package() / associated_package
           Get or set the associated_package of this entry. This is for lines that are associated
           to a certain package like in action or status lines. Its usually unset for startup and
           status lines.

       $dpkg_log_entry->action() / action
           Get or set the action of this entry. This is for lines that have a certain action,
           like in startup-lines (unpack, configure) or action lines (install, remove).  It is
           usally unset for status lines.

       $dpkg_log_entry->status() / status
           Get or set the status of the package this entry refers to.

       $dpkg_log_entry->subject() / subject
           Gets or Defines the subject of the entry. For startup lines this is usually 'archives'
           or 'packages' for all other lines its 'package'.

       $dpkg_log_entry->installed_version() / installed_version
           Gets or Defines the installed_version of the package this entry refers to.  It refers
           to the current installed version of the package depending on the current status. Is
           "<none>" (or similar) if action is 'install', old version in case of an upgrade.

       $dpkg_log_entry->available_version() / available_version
           Gets or Defines the available_version of the package this entry refers to.  It refers
           to the currently available version of the package depending on the current status. Is
           different from installed_version if the action is install or upgrade.

       $dpkg_log_entry->conffile() / conffile
           Get or set a conffile for a line indicating a conffile change.

       $dpkg_log_entry->decision() / decision
           Gets or defines the decision for a line indicating a conffile change.

SEE ALSO

       DateTime

AUTHOR

       Patrick Schoenfeld <schoenfeld@debian.org>.

COPYRIGHT AND LICENSE

       Copyright (C) 2011 Patrick Schoenfeld <schoenfeld@debian.org>

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