NAME

       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@thykier.net> for Lintian.

SEE ALSO

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