-
-
Notifications
You must be signed in to change notification settings - Fork 8
/
Copy pathREADME
87 lines (61 loc) · 2.83 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
File-Unpack
File::Unpack is an aggressive unpacker for archive files. We call it aggressive,
because it recursivly descends into any freshly unpacked file, if it appears to be an archive itself.
It also uncompresses files where needed. The ultimate goal of File::Unpack is
to extract as much readable text (ascii or any other encoding) as possible.
Most of the currently known archive file formats are supported.
While The following perl modules are considered helpful, although we may run
perfectly okay, if only a subset of these is available:
- File::LibMagic, File::MimeInfo::Magic
File::LibMagic is preferred, its underlying libmagic is activly maintained.
Its database is very large, and it is much faster than File::MimeInfo::Magic
Beware, that File::MimeInfo::Magic may derive a mimetype from the suffix, if
nothing else works.
- IO::Uncompress::AnyUncompress (perl-IO-Compress)
- IO::Uncompress::AnyInflate
- Compress::Raw::Bzip2
- Compress::Raw::Zlib
- Archive::Zip
- String::ShellQuote
Do not use:
- File::MMagic, File::MMagic::XS, File::Type
These three are inferior, compared to the other options.
- Archive::Tar
It is pure perl, so it's a lot slower then your "/bin/tar"
IT is heavy on memory, all will be read into memory.
- Archive::Zip
If you are just going to be extracting zips (and/or other archives) you are
recommended to look at using Archive::Extract
- "Archive::Extract"
tries first to determine what type of archive you are passing it, by
inspecting its suffix. It does not do this by using Mime magic.
Maybe this module should use something like "File::Type" to determine the
type, rather than blindly trust the suffix.
Set $Archive::Extract::PREFER_BIN to 1, which will prefer the use of command
line programs and won't consume so much memory. Default: use "Archive::Tar" -.
We also rely on a range of command line utilities to be callable via the shell.
INSTALLATION
To install this module, run the following commands:
perl Makefile.PL
make
make test
make install
SUPPORT AND DOCUMENTATION
After installing, you can find documentation for this module with the
perldoc command.
perldoc File::Unpack
You can also look for information at:
RT, CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=File-Unpack
AnnoCPAN, Annotated CPAN documentation
http://annocpan.org/dist/File-Unpack
CPAN Ratings
http://cpanratings.perl.org/d/File-Unpack
Search CPAN
http://search.cpan.org/dist/File-Unpack/
LICENSE AND COPYRIGHT
Copyright (C) 2010-2013 Juergen Weigert
This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.
See http://dev.perl.org/licenses/ for more information.