debian man page for dpkg::log::analyse::package

DPKG::Log::Analyse::Package(3pm)			User Contributed Perl Documentation			  DPKG::Log::Analyse::Package(3pm)

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)