Unzip::Passwd(3pm)

NAME
 Unzip::Passwd - Unzip files with password.

DESCRIPTION
Extreamly simple Unzip abstraction using the unzip program( MUST BE INSTALLED )

WARNING: This is Alpha version.

VERSION
Version 0.0.14

SYNOPSIS
 #Instance
 my $obj = Unzip::Passwd->new( filename => 'myfile.zip',
                                        destiny => 'some/path/to/file/unziped',
                                        passwd => 'somebetterpassword',
                                                        );
 #unzip ...
 $obj->unzip;

 #done!

METHODS

  new
This is the constructor

  unzip
Do the job, basicly. But first invokes the analyze method, to have certain the zip file is fine. If analyze returns 1, then unzip will try to open the zip file. No parameters, will return 1 if it's all ok. Otherwise, will return 0 and throw an exception.

  list_files
This try to obtain a list of files from zipfile in $self->filename. If succeded, returns an arrayref with the filelist. Otherwise returns an arrayref empty.

  analyze
Analyzes possible file and directory problems( permissions and non-existing directories etc ). Returns 1 if all it's ok! Otherwise returns 0. Receives the files list( arrayref ) as parameter.

  exec_unzip
This is a internal method. You should exec unzip method. Never exec this method directly.

  show_errors
Makes the obvious. Show errors. Don't receives anything. Returns the error messages( arrayref ).

ACCESSORS

  filename
Name/Path of file that will be 'unziped'

  passwd
string with the password

  destiny
filepath to extract file

  errors
stack(array) of errors

DEPENDECIES
unzip program MUST be installed!

AUTHOR
Andre Carneiro, "<andregarciacarneiro at gmail.com>"

NOTES FOR THIS VERSION
More tests implement.

BUGS
Please report any bugs or feature requests to "bug-unzip-passwd at rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Unzip-Passwd>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT
This module was tested JUST ON LINUX. DON'T HAVE SUPPORT IN WINDOWS YET. MAYBE LATER...

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

   perldoc Unzip::Passwd

You can also look for information at:

•   RT: CPAN's request tracker

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

•   AnnoCPAN: Annotated CPAN documentation

    <http://annocpan.org/dist/Unzip-Passwd>

•   CPAN Ratings

    <http://cpanratings.perl.org/d/Unzip-Passwd>

•   Search CPAN

    <http://search.cpan.org/dist/Unzip-Passwd/>

TODO
All other features from unzip ( Linux version ). :D

Aggregates some log module.

Finish the tests... :(

Create a better way to treat exceptions...

ACKNOWLEDGEMENTS

LICENSE AND COPYRIGHT
Copyright 2010 Andre Carneiro.

This program is released under the following license: Artistic2