NAME

       Lintian::Lab::Manifest -- Lintian Lab manifest

SYNOPSIS

        use Lintian::Lab::Manifest;

        my $plist = Lintian::Lab::Manifest->new ('binary');
        # Read the file
        $plist->read_list('info/binary-packages');
        # fetch the entry for lintian (if any)
        my $entry = $plist->get('lintian', '2.5.2', 'all');
        if ( $entry && exits $entry->{'version'} ) {
           print "Lintian has version $entry->{'version'}\n";
        }
        # delete all lintian entries
        $plist->delete('lintian');
        # Write to file if changed
        if ($plist->dirty) {
           $plist->write_list('info/binary-packages');
        }

DESCRIPTION

       Instances of this class provide access to the packages list used by the lab as caches.

       The data structure is basically a tree (using hashes).  For binaries is looks (something)
       like:

        $self->{'state'}{$name}{$version}{$architecture}

       The (order of the) fields used in the tree are listed in the @{BIN,SRC,CHG}_QUERY lists
       below.  The fields may (and generally do) differ between package types.

CLASS METHODS

       new (TYPE[, GROUPING])
           Creates a new packages list for a certain type of packages.  This type defines the
           format of the files.

           The known types are:
            * binary
            * changes
            * source
            * udeb
            * GROUP

           If TYPE is GROUP, then GROUPING should be omitted.

INSTANCE METHODS

       dirty
           Returns a truth value if the manifest has changed since it was last written.

       type
           Returns the type of packages that this manifest has information about.  (one of
           binary, udeb, source or changes)

       read_list (FILE)
           Reads a manifest from FILE.  Any records already in the manifest will be discarded
           before reading the contents.

           On success, this will clear the "dirty" flag and on error it will croak.

       write_list (FILE)
           Writes the manifest to FILE.

           On success, this will clear the "dirty" flag and on error it will croak.

           On error, the contents of FILE are undefined.

       visit_all (VISITOR[, KEY1, ..., KEYN])
           Visits entries and passes them to VISITOR.  If any keys are passed they are used to
           reduce the search.  See get for a list of (common) keys.

           The VISITOR is called as:

            VISITOR->(ENTRY, KEYS)

           where ENTRY is the entry and KEYS are the keys to be used to look up this entry via
           get method.  So for the lintian 2.5.2 binary the keys would be something like:
            ('lintian', '2.5.2', 'all')

       get (KEYS...)
           Fetches the entry for KEYS (if any).  Returns "undef" if the entry is not known.  If
           KEYS is exactly one item, it is assumed to be a Lintian::Processable and the correct
           keys are extracted from it.

           Otherwise, the keys are (in general and in order):

           package/source
           version
           architecture
               except for source packages

       set (ENTRY)
           Inserts ENTRY into the manifest.  This may replace an existing entry.

           Note: The interesting fields from ENTRY are copied, so later changes to ENTRY will not
           affect the data in the manifest.

       set_transient_marker (TRANSIENT, KEYS...)
           Set or clear transient flag.  Transient entries are not written to the disk (i.e. They
           will not appear in the file created/written by "write_list (FILE)").  KEYS is passed
           as is passed to "get (KEYS...)".

           By default all entries are persistent.

       delete (KEYS...)
           Removes the entry/entries found by KEYS (if any).  KEYS must contain at least one item
           - if the list of keys cannot uniquely identify a single element, all "matching"
           elements will be removed.  Examples:

            # Delete the gcc-4.6 entry at version 4.6.1-4 that is also architecture i386
            $manifest->delete ('gcc-4.6', '4.6.1-4', 'i386');

            # Delete all gcc-4.6 entries at version 4.6.1-4 regardless of their
            # architecture
            $manifest->delete ('gcc-4.6', '4.6.1-4');

            # Delete all gcc-4.6 entries regardless of version and architecture
            $manifest->delete ('gcc-4.6')

           If KEYS is exactly one item, it is assumed to be a Lintian::Processable.  If so, the
           proper keys will be extracted from that processable and (if present) that one element
           will be removed.

           This will mark the list as dirty if an element was removed.  If it returns a truth
           value, an element was removed - otherwise it will return 0.

           See "get (KEYS...)" for the key names.

       diff (MANIFEST)
           Returns a diff between this manifest and MANIFEST.

           This instance is considered the "original" and MANIFEST is "new" version of the
           manifest.  (See the olist and nlist methods of Lintian::Lab::ManifestDiff for more
           information.

AUTHOR

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

SEE ALSO

       lintian(1)