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 a pre-Alpha module.

VERSION
Version 0.0.9

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

 #done!

METHODS

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

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

  DEPENDECIES
 NO DEPENDECIES!!! But unzip program MUST BE INSTALLED in your O.S.

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

NOTES FOR THIS VERSION
 Many changes! The code is more optimized and less complex. Some basic tests are implemented ( finaly! :P ).

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