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.