---
name: "Lintian::ProcessableGroup"
section: "3"
platform: "linux"
package: "lintian"
version: "2.15.0"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Lintian::ProcessableGroup"
---

# Lintian::ProcessableGroup(3)

## NAME

Lintian::ProcessableGroup -- A group of objects that Lintian can process

## SYNOPSIS

```
 use Lintian::ProcessableGroup;
 my $group = Lintian::ProcessableGroup->new('lintian_2.5.0_i386.changes');
 foreach my $proc ($group->get_processables){
     printf "%s %s (%s)\n", $proc->pkg_name,
            $proc->pkg_version, $proc->pkg_type;
 }
 # etc.
```

## DESCRIPTION

Instances of this perl class are sets of processables.  It allows at most one source and one changes or buildinfo package per set, but multiple binary packages (provided that the binary is not already in the set).

## METHODS

- Lintian::ProcessableGroup-\>new (\[LAB\[, FILE\]\])

  Creates a group and optionally add all processables from .changes or .buildinfo file FILE.

  If the LAB parameter is given, all processables added to this group will be stored as a lab entry from LAB.

- $group-\>add\_new\_processable ($pkg\_path\[, $pkg\_type\])

  Adds a new processable of type `$pkg_type` from `$pkg_path`.  If `$pkg_type` is not given, it will be determined by the file extension.

  This is short hand for:

  ```
   $group->add_processable(
      Lintian::Processable->new ($pkg_path, $pkg_type));
  ```

- $group-\>add\_processable($proc)

  Adds `$proc` to `$group`.  At most one source and one changes `$proc` can be in a `$group`.  There can be multiple binary `$proc`'s, as long as they are all unique.  Successive buildinfo `$proc`'s are silently ignored.

  This will error out if an additional source or changes `$proc` is added to the group. Otherwise it will return a truth value if `$proc` was added.

- $group-\>get\_processables(\[$type\])

  Returns an array of all processables in `$group`.  The processables are returned in the following order: changes (if any), source (if any), all binaries (if any) and all udebs (if any).

  This order is based on the original order that Lintian processed packages in and some parts of the code relies on this order.

  Note if `$type` is given, then only processables of that type is returned.

- $group-\>remove\_processable($proc)

  Removes `$proc` from `$group`

- $group-\>get\_source\_processable

  Returns the processable identified as the "source" package (e.g. the dsc).

  If `$group` does not have a source processable, this method returns `"undef"`.

- $group-\>get\_buildinfo\_processable

  Returns the processable identified as the "buildinfo" processable (e.g. the buildinfo file).

  If `$group` does not have a buildinfo processable, this method returns `"undef"`.

- $group-\>get\_changes\_processable

  Returns the processable identified as the "changes" processable (e.g. the changes file).

  If `$group` does not have a changes processable, this method returns `"undef"`.

- $group-\>get\_binary\_processables

  Returns all binary (and udeb) processables in `$group`.

  If `$group` does not have any binary processables then an empty list is returned.

- $group-\>info

  Returns `$info` element for this group.

- $group-\>init\_shared\_cache

  Prepare a shared memory cache for all current members of the group. This is solely a memory saving optimization and is not required for correct performance.

- $group-\>clear\_cache

  Discard the info element of all members of this group, so the memory used by it can be reclaimed.  Mostly useful when checking a lot of packages (e.g. on lintian.d.o).

## AUTHOR

Originally written by Niels Thykier \<niels@thykier.net\> for Lintian.

## SEE ALSO

[**lintian**(1)](/lintian/1.md)

Lintian::Processable