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);

Compares two packages in their string representation.

compare($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.