archive::peek(3pm) [debian man page]

Archive::Peek(3pm)					User Contributed Perl Documentation					Archive::Peek(3pm)

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.

perl v5.12.4							    2011-09-26							Archive::Peek(3pm)

Archive::Any(3pm)					User Contributed Perl Documentation					 Archive::Any(3pm)

NAME

       Archive::Any - Single interface to deal with file archives.

SYNOPSIS

	 use Archive::Any;

	 my $archive = Archive::Any->new($archive_file);

	 my @files = $archive->files;

	 $archive->extract;

	 my $type = $archive->type;

	 $archive->is_impolite;
	 $archive->is_naughty;

DESCRIPTION

       This module is a single interface for manipulating different archive formats.  Tarballs, zip files, etc.

       new
	     my $archive = Archive::Any->new($archive_file);
	     my $archive = Archive::Any->new($archive_file, $type);

	   $type is optional.  It lets you force the file type in-case Archive::Any can't figure it out.

       extract
	     $archive->extract;
	     $archive->extract($directory);

	   Extracts the files in the archive to the given $directory.  If no $directory is given, it will go into the current working directory.

       files
	     my @file = $archive->files;

	   A list of files in the archive.

       mime_type
	    my $mime_type = $archive->mime_type();

	   Returns the mime type of the archive.

       is_impolite
	     my $is_impolite = $archive->is_impolite;

	   Checks to see if this archive is going to unpack into the current directory rather than create its own.

       is_naughty
	     my $is_naughty = $archive->is_naughty;

	   Checks to see if this archive is going to unpack outside the current directory.

DEPRECATED

       type
	     my $type = $archive->type;

	   Returns the type of archive.  This method is provided for backwards compatibility in the Tar and Zip plugins and will be going away
	   soon in favor of "mime_type".

PLUGINS

       For detailed information on writing plugins to work with Archive::Any, please see the pod documentation for Archive::Any::Plugin.

AUTHOR

       Clint Moore <cmoore@cpan.org>

AUTHOR EMERITUS

       Michael G Schwern

SEE ALSO

       Archive::Any::Plugin

SUPPORT

       You can find documentation for this module with the perldoc command.

	perldoc Archive::Any

       You can also look for information at:

       o   AnnoCPAN: Annotated CPAN documentation

	   <http://annocpan.org/dist/Archive-Any>

       o   CPAN Ratings

	   <http://cpanratings.perl.org/d/Archive-Any>

       o   RT: CPAN's request tracker

	   <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Archive-Any>

       o   Search CPAN

	   <http://search.cpan.org/dist/Archive-Any>

LICENSE

       This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.10.0							    2008-06-25							 Archive::Any(3pm)