NAME

       Lintian::Reporting::Util - Lintian utility functions

SYNOPSIS

        use Lintian::Reporting::Util qw(load_state_cache find_backlog);

        my $cache = load_state_cache('path/to/state-dir');
        my @backlog = find_backlog('2.12', $cache);

DESCRIPTION

       This module contains a number of utility subs that are nice to have for the reporting
       framework, but on their own did not warrant their own module.

       Most subs are imported only on request.

FUNCTIONS

       load_state_cache(STATE_DIR)
           [Reporting tools only] Load the state cache from STATE_DIR.

       save_state_cache(STATE_DIR, STATE)
           [Reporting tools only] Save the STATE cache to STATE_DIR.

       find_backlog(LINTIAN_VERSION, STATE)
           [Reporting tools only] Given the current lintian version and the harness state, return
           a list of group ids that are part of the backlog.  The list is sorted based on what
           version of Lintian processed the package.

           Note the result is by design not deterministic to reduce the risk of all large
           packages being in the same run (e.g. like gcc-5 + gcc-5-cross + gcc-6 + gcc-6-cross).

SEE ALSO

       lintian(1)