-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.html
executable file
·69 lines (69 loc) · 6.33 KB
/
README.html
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
<div class="figure">
<img src="resources/zip-subdirs-icon-export.ico" alt=" " />
<p class="caption"> </p>
</div>
<h1 id="zip-subdirs-version-0.1.0">Zip Subdirs Version 0.1.0</h1>
<p>February 15, 2016</p>
<p><em>Copyright <a href="https://endosynth.wordpress.com/">Andrew Proper</a> 2016.</em> <em><script type="text/javascript">
<!--
h='gmail.com';a='@';n='%20andrewrproper';e=n+a+h;
document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'" clas'+'s="em' + 'ail">'+'andrewrproper@gmail.com'+'<\/'+'a'+'>');
// -->
</script><noscript>andrewrproper@gmail.com (%20andrewrproper at gmail dot com)</noscript></em></p>
<p>Tested on Windows 7, 8, 10.</p>
<p><a href="https://endosynth.wordpress.com/category/zip-subdirs/">Zip-Subdirs News Online</a></p>
<h2 id="problems-and-features">Problems and Features</h2>
<p>Please report any problems any feature requests on the <a href="https://github.com/endosynth/zip-subdirs/issues">issues page</a>.</p>
<p>Please create one issue per problem or feature, for easier tracking.</p>
<h2 id="license-gpl-v3">License: GPL v3</h2>
<p>This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
<p>You should have received a copy of the GNU General Public License along with this program. If not, see <a href="http://www.gnu.org/licenses/" class="uri">http://www.gnu.org/licenses/</a>.</p>
<h2 id="install">Install</h2>
<p>First install <a href="http://dwimperl.com">DWIMPerl</a>.</p>
<ul>
<li>This was tested with <a href="http://dwimperl.com">DWIMPerl</a> v5.14.2.1 v7 32 bit for Windows.</li>
<li>If you cant get <a href="http://dwimperl.com">DWIMPerl</a>, Strawberry Perl may work.</li>
</ul>
<p>After that is installed, you can run the <code>zip-subdirs</code> shortcut to start. If the shortcut fails, try running the <code>zip-subdirs.bat</code> batch file.</p>
<p>If you have problems, try running <code>zip-subdirs-debug.bat</code> to see any debug or error output (in the black command prompt window).</p>
<h2 id="purpose">Purpose</h2>
<p>Allows the user to select a directory, then displays the list of subdirectories under that directory. The user can select one or more (Ctrl-click) subdirectories to zip, then press the Zip button.</p>
<p>Subdirectories will be zipped in the order they are listed. Each one will be zipped into a timestamped zip file. Insize the zip file, the top-level item will be the subdirectory with a timestamp appended.</p>
<h2 id="how-to-use">How to Use</h2>
<p>First, select a parent directory using the "Browse" button. This should then display a list of sub-directories in the text area below the "Browse" button. These are directories inside of the parent directory.</p>
<div class="figure">
<img src="screenshots/main-window.png" alt="Main Window" />
<p class="caption">Main Window</p>
</div>
<p>Next, select one or more sub-directories to copy into archive zip files. You can select only one, or some, or all of them.</p>
<p>After that, click the "create a zip of each selected path" button. Results of zipping will be shown in the bottom text area. Directories will be zipped one by one. Each resulting zip file will have a timestamp added to the end of the file name, and will contain the zipped directory with the timestamp added to the end of its name.</p>
<div class="figure">
<img src="screenshots/created-2-zips.png" alt="Created some zips" />
<p class="caption">Created some zips</p>
</div>
<p>The timestamps make this useful for backing up timestamped zips of directories. They are also helpful for extracting/unzipping, because when you extract the zip file with paths enabled, the top directory will have a timestamp on it. This way, you can archive the same directory multiple times, and extract the archives, without the extracted archives overiting each others' directories.</p>
<p>This screenshot shows a resulting zip file opened in 7zip.</p>
<div class="figure">
<img src="screenshots/archive-shown-in-7zip.png" alt="Archive shown in 7zip" />
<p class="caption">Archive shown in 7zip</p>
</div>
<h2 id="configuration">Configuration</h2>
<p>The config file is <code>connfig.yaml</code>. It is a plain text file and can be editing with Notepad, gVim, etc.</p>
<p>It is in <a href="http://yaml.org/">YAML</a> format, which is white space sensitive. So don't change the white space, only change the values.</p>
<p>The following options exist:</p>
<ul>
<li>get_tree_du_max_ms : 5000
<ul>
<li>this is how long, in milliseconds, to wait to load disk usage per subdirectory. If loading takes too long, it will be stopped and a "+" sign will be shown beside the shown directory size.</li>
<li>the value, 5000, means 5000 milliseconds, or 0.5 seconds.</li>
<li>some computers are faster at loading disk usage than others.</li>
<li>if your computer is slow to load the subdirectories list, change this to a smaller number to speed up the loading.</li>
</ul></li>
</ul>
<h2 id="compiling-to-exe">Compiling to Exe</h2>
<p>You will need to install the <strong>PAR::Packer</strong> CPAN module into DWIMPerl, using its cpan interface. This basically involves opening a Windows command prompt and running:</p>
<pre><code>cpan
> install PAR::Packer</code></pre>
<p>After that, you can run <code>compile_to_exe.bat</code> to create a .exe file from the .pl file.</p>
<p>Note that this essentially just creates a zip of the perl code which can extract and run itself. It may not be better or faster than running the .pl file directly via its .bat file.</p>