/ 
Unzip-Passwd_0.0.9-Alpha
/ Unzip::Passwd

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:

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