NAME

       DPKG::Log::Analyse::Package - Describe a package as analysed from a dpkg.log

VERSION

       version 1.20

SYNOPSIS

       use DPKG::Log;

       my $package = DPKG::Log::Analyse::Package->new('package' => 'foobar');

DESCRIPTION

       This module is used to analyse a dpkg log.

METHODS

       $package = DPKG::Log::Analyse::Package->new('package' => 'foobar')
           Returns a new DPKG::Log::Analyse::Package object.

       $package_name = $package->name;
           Returns the name of this package.

       $package->version
           Return or set the version of this package.

       $package->previous_version
           Return or set the previous version of this package.

       $package->status
           Return or set the status of this package.

       equals($package1, $package2);
       print "equal" if $package1 eq $package2
           Compares two packages in their string representation.

       compare($package1, $package2)
       print "greater" if $package1 > $package2
           Compare two packages. See OVERLOADING for details on how the comparison works.

       $package_str = $package->as_string
       printf("Package name: %s", $package);
           Return  this  package  as a string. This will return the package name and the version (if set) in the
           form package_name/version.  If version is not set, it will return the package name only.

Overloading

       This  module   explicitly   overloads   some   operators.    Each   operand   is   expected   to   be   a
       DPKG::Log::Analyse::Package object.

       The string comparison operators, "eq" or "ne" will use the string value for the comparison.

       The  numerical  operators  will  use  the  package  name and package version for comparison. That means a
       package1 == package2 if package1->name equals package2->name AND package1->version == package2->version.

       The module stores versions as Dpkg::Version objects, therefore sorting different  versions  of  the  same
       package will work.

       This  module  also  overloads  stringification  returning either the package name if no version is set or
       "package_name/version" if a version is set.

SEE ALSO

       DPKG::Log, DPKG::Version

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.

perl v5.10.1                                       2011-02-23                   DPKG::Log::Analyse::Package(3pm)