NAME

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

VERSION

version 0.0946

SYNOPSIS

use Archive::Any;

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

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_with_type = 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.

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:

• MetaCPAN

  https://metacpan.org/module/Archive::Any

• Issue tracker

  https://github.com/oalders/archive-any/issues

AUTHORS

• Clint Moore
• Michael G Schwern (author emeritus)
• Olaf Alders (current maintainer)

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Michael G Schwern, Clint Moore, Olaf Alders.

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