Debian::Dependencies(3pm)

Debian::Dependencies3pm

A list of debian::dependency objects

Usage

    my $dl = Debian::Dependencies->new('perl, libfoo-perl (>= 3.4)');
    print $dl->[1]->ver;      # 3.4
    print $dl->[1];           # libfoo-perl (>= 3.4)
    print $dl;                # perl, libfoo-perl (>= 3.4)
    $dl += 'libbar-perl';
    print $dl;                # perl, libfoo-perl (>= 3.4), libbar-perl
    print Debian::Dependencies->new('perl') + 'libfoo-bar-perl';
                              # simple 'sum'
    print Debian::Dependencies->new('perl')
          + Debian::Dependencies->new('libfoo, libbar');
                              # add (concatenate) two lists
    print Debian::Dependencies->new('perl')
          + Debian::Dependency->new('foo');
                              # add dependency to a list

Overview

Debian::Dependencies a list of Debian::Dependency objects, with automatic construction and stringification.

Objects of this class are blessed array references. You can safely treat them as arrayrefs, as long as the elements you put in them are instances of the Debian::Dependency class.

When used in string context, Debian::Dependencies converts itself into a comma-delimited list of dependencies, suitable for dependency fields of debian/control files.

Class methods

new(dependency-string)

Constructs a new Debian::Dependencies object. Accepts one scalar argument, which is parsed and turned into an arrayref of Debian::Dependency objects. Each dependency should be delimited by a comma and optional space. The exact regular expression is "/\s*,\s*/".

Object methods

add( dependency[, ... ] )

Adds dependency (or a list of) to the list of dependencies. If the new dependency is a subset of or overlaps some of the old dependencies, it is not duplicated.

    my $d = Debian::Dependencies('foo, bar (<=4)');
    $d->add('foo (>= 4), bar');
    print "$d";     # foo (>= 4), bar (>= 4)

dependency can be either a Debian::Dependency object, a Debian::Deendencies object, or a string (in which case it is converted to an instance of the Debian::Dependencies class).

remove( dependency, ... )
remove( dependencies, ... )

Removes a dependency from the list of dependencies. Instances of Debian::Dependency and Debian::Dependencies classes are supported as arguments.

Any non-reference arguments are coerced to instances of Debian::Dependencies class.

Only dependencies that are subset of the given dependencies are removed:

    my $deps = Debian::Dependencies->new('foo (>= 1.2), bar');
    $deps->remove('foo, bar (>= 2.0)');
    print $deps;    # bar

Returns the list of the dependencies removed.

has( dep )

Return true if the dependency list contains given dependency. In other words, this returns true if the list of dependencies guarantees that the given dependency will be satisfied. For example, "foo, bar" satisfies "foo", but not "foo (>= 5)".

prune()

This method is deprecated. If you want to sort the dependency list, either call "sort" or use normal perl sorting stuff on the dereferenced array.

sort()

Sorts the dependency list by package name, version and relation.

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 7 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13

Author

Damyan Ivanov <[email protected]>

From libdebian-source-perl 0.128 in Debian 13 (Trixie). Parsed by carta from the page's man source.