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.