NAME

       Debbugs::DebArchive -- Routines for reading files from Debian archives

SYNOPSIS

       use Debbugs::DebArchive;

          read_packages('/srv/mirrors/ftp.debian.org/ftp/dist',
                        sub { print map {qq($_\n)} @_ },
                        Term::ProgressBar->new(),
                       );

DESCRIPTION

       This module implements a set of routines for reading Packages.gz, Sources.gz and Release
       files from the dists directory of a Debian archive.

BUGS

       None known.

       read_release_file
                read_release_file('stable/Release')

           Reads a Debian release file and returns a hashref of information about the release
           file, including the Packages and Sources files for that distribution

       read_packages
                read_packages($dist_dir,$callback,$progress)

           dist_dir
               Path to dists directory

           callback
               Function which is called with key, value pairs of suite, arch, component, Package,
               Source, Version, and Maintainer information for each package in the Packages file.

           progress
               Optional Term::ProgressBar object to output progress while reading packages.