SysTutorials

Linux Manual Pages › Section 3

lintiancollscript(3)

Lintian::CollScript - Collection script handle

Synopsis

 use Lintian::CollScript;
 my $cs = Lintian::CollScript->new ("$ENV{'LINTIAN_ROOT'}/collection/index.desc");
 my $name = $cs->name;
 foreach my $needs ($cs->needs_info) {
 print "$name needs $needs\n";
 }

Description

Instances of this class represents the data in the collection ``.desc'' files. It allows access to the common meta data of the collection (such as Needs-Info).

Class Methods

new (FILE)
Parse FILE as a collection desc file.

Instance Methods

name
Returns the ``name'' of the collection script. This is the value in the Collector-Script field in the file.
type
Returns the value stored in the ``Type'' field of the file. For the purpose of testing if the collection applies to a given package type, the ``is_type'' method can be used instead.
version
Returns the value of the ``Version'' field of the file. This should be an integer describing the version of the collector script.
auto_remove
Returns a truth value if the collection has the ``auto-remove'' flag.
script_path
Returns the absolute path to the collection script.
interface
The call interface for this collection script.
exec
The collection is run by invoking the script denoted by script_path with the proper arguments. This is the default value.
perl-coll
The collection is implemented in Perl in such a way that it can be loaded into perl and run via the ``collect (PKG, TASK, DIR)'' method. Collections that have the ``perl-coll'' can also be run as if they had the ``exec'' interface (see above).
needs_info ([COND])
Returns a list of all items listed in the Needs-Info field. Neither the list nor its contents should be modified.

COND is optional and used to determine what conditions are true. If omitted, all ``extra’’ dependencies are returned. Otherwise, only the dependencies required by COND are included. COND is a hashref and with the following key/values:

type
The value is a package type that determines which package type is being unpacked. This is used to determine if the condition for ``<dep> [<type>]'' relations are true or not.
is_type (TYPE)
Returns a truth value if this collection can be applied to a TYPE package.
collect (PKG, TASK, DIR)

Author

Originally written by Niels Thykier <niels [at] thykier.net> for Lintian.

See Also

lintian(1), Lintian::Profile(3), Lintian::Tag::Info(3)