NAME
    Archive::Peek - Peek into archives without extracting them

SYNOPSIS
      use Archive::Peek;
      my $peek = Archive::Peek->new( filename => 'archive.tgz' );
      my @files = $peek->files();
      my $contents = $peek->file('README.txt')

DESCRIPTION
    This module lets you peek into archives without extracting them. It
    currently supports tar files and zip files. To support Bzip2- compressed
    files, you should install IO::Uncompress::Bunzip2.

METHODS
  new
    The constructor takes the filename of the archive to peek into:

      my $peek = Archive::Peek->new( filename => 'archive.tgz' );

  files
    Returns the files in the archive:

      my @files = $peek->files();

  file
    Returns the contents of a file in the archive:

      my $contents = $peek->file('README.txt')

AUTHOR
    Leon Brocard <acme@astray.com>

COPYRIGHT
    Copyright (C) 2008, Leon Brocard.

LICENSE
    This module is free software; you can redistribute it or modify it under
    the same terms as Perl itself.