Lintian::DepMap::Properties (3)

Leading comments

Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Lintian::DepMap::Properties.3".)

NAME

Lintian::DepMap::Properties - Dependencies with properties map/tree creator

SYNOPSIS

    use Lintian::DepMap::Properties;

    my $map = Lintian::DepMap::Properties->new;

DESCRIPTION

Lintian::DepMap::Properties is a simple layer between Lintian::DepMap and the application allowing nodes to have application-defined properties.

add(node, [dependencies], [ref to property])

Adds a node with possibly one or more dependencies and sets the "node"'s property to the ref, if defined. The property must be a reference (it can be to a hash, an array, a function, an object, etc) and must be the last argument given to the method.

E.g.

    $map->add('foo', {name => 'John Doe', age => 20});

addp(node[, prefix, dependency[, dependency...]], [ref to property])

Adds the given "node" to the map marking any third or more parameters, after prefixing them with "prefix", as its dependencies and sets the "node"'s property to the ref, if defined. See add()'s description for more information about properties. E.g.

    # pA and pB have no dependency:
    $map->addp('pA', {name => 'John Doe'});
    $map->addp('pB', {name => 'Jane Doe'});
    # Df depends on pA and pB:
    $map->addp('Df', 'p', 'A', 'B', {name => 'Doe Family'});

getp(node)

Returns the reference to the given "node"'s properties.

E.g.

    # prints John Doe
    print $map->getp('foo')->{'name'};
    # changes the value of 'name'
    $map->getp('foo')->{'name'} = 'Jane Doe';
    # prints Jane Doe
    print $map->getp('foo')->{'name'};

AUTHOR

Originally written by Raphael Geissert <atomo64@gmail.com> for Lintian.