Sun, 19 Oct 2008 22:42:20 -0400
Prepare for a 6.3 release
63 | 1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Strict//EN" |
2 | "http://www.w3.org/TR/html4/strict.dtd"> | |
3 | ||
4 | <html><head><title>dtrx: Intelligent archive extraction</title> | |
5 | <link rel="stylesheet" href="common.css"> | |
89 | 6 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
63 | 7 | </head> |
8 | <body> | |
9 | <h1>dtrx: Intelligent archive extraction</h1> | |
10 | ||
11 | <h2>Introduction</h2> | |
12 | ||
13 | <p><span class="pname">dtrx</span> stands for “Do The Right | |
14 | Extraction.” It's a tool for Unix-like systems that takes all the | |
15 | hassle out of extracting archives. Here's an example of how you use | |
16 | it:</p> | |
17 | ||
18 | <pre>$ dtrx linux-2.6.10.tar.bz2</pre> | |
19 | ||
20 | <p>That's basically the same thing as:</p> | |
21 | ||
22 | <pre>$ tar -jxf linux-2.6.10.tar.bz2</pre> | |
23 | ||
24 | <p>But there's more to it than that. You know those really annoying files | |
25 | that don't put everything in a dedicated directory, and have the | |
26 | permissions all wrong?</p> | |
27 | ||
28 | <pre>$ tar -zvxf random-tarball.tar.gz | |
29 | foo | |
30 | bar | |
31 | data/ | |
32 | data/text | |
33 | $ cd data/ | |
34 | cd: permission denied: data</pre> | |
35 | ||
36 | <p><span class="pname">dtrx</span> takes care of all those problems for | |
37 | you, too:</p> | |
38 | ||
39 | <pre>$ dtrx random-tarball.tar.gz | |
40 | $ cd random-tarball/data | |
41 | $ cat text | |
42 | This all works properly.</pre> | |
43 | ||
44 | <p><span class="pname">dtrx</span> is simple and powerful. Just use the | |
45 | same command for all your archive files, and they'll never frustrate you | |
46 | again.</p> | |
47 | ||
48 | <h2>Features</h2> | |
49 | ||
50 | <ul> | |
51 | ||
52 | <li><strong>Handles many archive types</strong>: You only need to remember | |
53 | one simple command to extract | |
54 | ||
55 | <span class="pname">tar</span>, | |
56 | <span class="pname">zip</span>, | |
57 | <span class="pname">cpio</span>, | |
58 | <span class="pname">deb</span>, | |
59 | <span class="pname">rpm</span>, | |
60 | <span class="pname">gem</span>, | |
61 | <span class="pname">7z</span>, | |
62 | <span class="pname">cab</span>, | |
93
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
63 | <span class="pname">rar</span>, |
63 | 64 | <span class="pname">gz</span>, |
75
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
65 | <span class="pname">bz2</span>, |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
66 | <span class="pname">lzma</span>, and many kinds of |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
67 | <span class="pname">exe</span> files, including Microsoft Cabinet archives, |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
68 | InstallShield archives, and self-extracting <span class="pname">zip</span> |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
69 | files. |
63 | 70 | |
93
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
71 | If they have any extra compression, like <span class="pname">tar.bz2</span> |
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
72 | files, <span class="pname">dtrx</span> will take care of that for you, |
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
73 | too.</li> |
63 | 74 | |
75 | <li><strong>Keeps everything organized</strong>: <span | |
76 | class="pname">dtrx</span> will make sure that archives are extracted into | |
77 | their own dedicated directories.</li> | |
78 | ||
79 | <li><strong>Sane permissions</strong>: <span class="pname">dtrx</span> makes | |
80 | sure you can read and write all the files you just extracted, while leaving | |
81 | the rest of the permissions intact.</li> | |
82 | ||
83 | <li><strong>Recursive extraction</strong>: <span class="pname">dtrx</span> can | |
84 | find archives inside the archive and extract those too.</li> | |
85 | ||
86 | </ul> | |
87 | ||
88 | <h2>Download</h2> | |
89 | ||
93
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
90 | <p><a href="dtrx-6.3.tar.gz">Download <span class="pname">dtrx</span> |
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
91 | 6.3</a>. The SHA1 checksum for this file |
89 | 92 | is <tt>7f2c633c97e79083c08cb63f3c155395f8f88646</tt>. New features in this |
63 | 93 | release include:</p> |
94 | ||
95 | <ul> | |
96 | ||
93
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
97 | <li>New support for RAR archives, thanks to Peter Kelemen.</li> |
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
98 | <li><span class="pname">dtrx</span> will no longer crash when extracting |
6c20788653a8
Prepare for a 6.3 release
Brett Smith <brettcsmith@brettcsmith.org>
parents:
89
diff
changeset
|
99 | certain archive types with the verbose option turned on.</li> |
63 | 100 | |
101 | </ul> | |
102 | ||
64
d7b46cae939b
Add notes about the hg repo.
Brett Smith <brett@brettcsmith.org>
parents:
63
diff
changeset
|
103 | <p>If you would like to try the latest development version—or maybe do some |
75
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
104 | work on it yourself—you can check out the |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
105 | project's <a href="http://www.selenic.com/mercurial/wiki/">Mercurial</a> |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
106 | repository. A |
64
d7b46cae939b
Add notes about the hg repo.
Brett Smith <brett@brettcsmith.org>
parents:
63
diff
changeset
|
107 | <a href="http://www.brettcsmith.org/2007/dtrx/dtrx/">web repository</a> is |
d7b46cae939b
Add notes about the hg repo.
Brett Smith <brett@brettcsmith.org>
parents:
63
diff
changeset
|
108 | available, or you can just run:</p> |
d7b46cae939b
Add notes about the hg repo.
Brett Smith <brett@brettcsmith.org>
parents:
63
diff
changeset
|
109 | |
d7b46cae939b
Add notes about the hg repo.
Brett Smith <brett@brettcsmith.org>
parents:
63
diff
changeset
|
110 | <pre>$ hg clone http://www.brettcsmith.org/2007/dtrx/dtrx</pre> |
d7b46cae939b
Add notes about the hg repo.
Brett Smith <brett@brettcsmith.org>
parents:
63
diff
changeset
|
111 | |
63 | 112 | <h2>Requirements</h2> |
113 | ||
114 | <p>If you have Python 2.4 or greater, this should work out of the box. If | |
75
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
115 | you're stuck on Python 2.3, you can use this if you install |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
116 | the <a href="http://www.lysator.liu.se/~astrand/popen5/">subprocess |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
117 | module</a>. You'll need the usual tools for the archive types you want to |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
118 | extract: for example, if you're extracting <span class="pname">zip</span> |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
119 | files, you'll need <span class="pname">zipinfo</span> |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
120 | and <span class="pname">unzip</span>. See the INSTALL file included |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
121 | with <span class="pname">dtrx</span> for a complete list of necessary |
856de7e8f494
Update for 6.1, plus some tweaks here and there.
Brett Smith <brettcsmith@brettcsmith.org>
parents:
64
diff
changeset
|
122 | utilities.</p> |
63 | 123 | |
124 | <h2>Installation</h2> | |
125 | ||
126 | <p>You can just put <span class="pname">scripts/dtrx</span> wherever is | |
127 | convenient for you, but if you want to install the program system-wide, you | |
128 | can also run the following command as root or equivalent:</p> | |
129 | ||
130 | <pre>python setup.py install</pre> | |
131 | ||
132 | <p>See the included <tt>INSTALL</tt> file for more information.</p> | |
133 | ||
134 | </body> | |
135 | </html> |