aptpkg::version(3pm) [debian man page]

AptPkg::Version(3pm)					User Contributed Perl Documentation				      AptPkg::Version(3pm)

NAME

       AptPkg::Version - APT package versioning class

SYNOPSIS

       use AptPkg::Version;

DESCRIPTION

       The AptPkg::Version module provides an interface to APT's package version handling.

   AptPkg::Version
       The AptPkg::Version package implements the APT pkgVersioningSystem class.

       An instance of the AptPkg::Version class may be fetched using the "versioning" method from an AptPkg::System object.

       The following methods are implemented:

       label
	   Return the description of the versioning system, for example:

	       Standard .deb

	   for Debian systems.

       compare(A, B)
	   Compare package version A with B, returning a negative value if A is an earlier version than B, zero if the same or a positive value if
	   A is later.

       rel_compare(A, B)
	   Compare distribution release numbers.

       check_dep(PKG, OP, DEP)
	   Check that the package version PKG satisfies the relation OP to the dependency version DEP.

	   The relation OP is specified in the Debian syntax regardless of the versioning system:

	       <<  strictly earlier
	       <=  earlier or equal
	       =   exactly equal
	       >=  later or equal
	       >>  strictly later

       upstream(VER)
	   Return the upstream component of the given version string.

SEE ALSO

       AptPkg::Config(3pm), AptPkg::System(3pm), AptPkg(3pm).

AUTHOR

       Brendan O'Dea <bod@debian.org>

perl v5.14.2							    2012-03-16						      AptPkg::Version(3pm)

AptPkg::hash(3pm)					User Contributed Perl Documentation					 AptPkg::hash(3pm)

NAME

       AptPkg::hash - a helper class for implementing tied hashes

SYNOPSIS

       use AptPkg::hash;

DESCRIPTION

       The AptPkg::hash class provides hash-like access for objects which have an underlying XS implementation.

       Such objects need to add AptPkg::hash to @ISA, provide get, set and exists methods, and an iterator class.

   AptPkg::hash
       new([XS_OBJECT])
	   Create a object as a tied hash.  The object is implemented as a hash reference blessed into the class, which in turn is tied to
	   AptPkg::hash.

	   This means that both $obj->method() and $obj->{key} valid, the latter invoking get/set (through FETCH/STORE).

	   The tie associates an array reference with the hash, which initially contains a reference to the hash, the XS object and an anon hash
	   which may be used by subclasses to store state information.

	   If no XS object is passed, one is created via new in the XS class.  The name of that class is constructed from the class name, by
	   lower-casing the last component and prefixing it with an underscore (eg. AptPkg::Config becomes AptPkg::_config).

	   If the module contains a @KEYS array, then the private hash will be populated with those entries as keys (see the description below of
	   the AptPkg::hash::method class).

       _self, _xs, _priv
	   Accessors which may be used in subclass methods to fetch the three array elements associated with the hash reference.

       keys(ARGS)
	   In a scalar context, creates and returns a new iterator object (the class name with the suffix ::Iter appended).

	   The XS object, the private hash and any arguments are passed to the constructor.

	   In an array context, the iterator is used to generate a list of keys which are then returned.

	   The iterator class must implement a next method, which returns the current key and advances to the next.

   AptPkg::hash::method
       The AptPkg::hash::method class extends AptPkg::hash, providing a simple way to map a fixed set of keys (defined by the @KEYS array) into
       method calls on either the object, or the internal XS object.

       Classes inheriting from AptPkg::hash::method should provide an iterator class which inherits from AptPkg::hash::method::iter.

AUTHOR

       Brendan O'Dea <bod@debian.org>

perl v5.14.2							    2012-03-16							 AptPkg::hash(3pm)