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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
<!--
__COPYRIGHT__
This file is processed by the bin/SConsDoc.py module.
See its __doc__ string for a discussion of the format.
-->
<tool name="zip">
<summary>
Sets construction variables for the &zip; archiver.
</summary>
<sets>
ZIP
ZIPFLAGS
ZIPCOM
ZIPCOMPRESSION
ZIPSUFFIX
</sets>
<uses>
ZIPCOMSTR
</uses>
</tool>
<builder name="Zip">
<summary>
Builds a zip archive of the specified files
and/or directories.
Unlike most builder methods,
the
&b-Zip;
builder method may be called multiple times
for a given target;
each additional call
adds to the list of entries
that will be built into the archive.
Any source directories will
be scanned for changes to
any on-disk files,
regardless of whether or not
&scons;
knows about them from other Builder or function calls.
<example>
env.Zip('src.zip', 'src')
# Create the stuff.zip file.
env.Zip('stuff', ['subdir1', 'subdir2'])
# Also add "another" to the stuff.tar file.
env.Zip('stuff', 'another')
</example>
</summary>
</builder>
<cvar name="ZIP">
<summary>
The zip compression and file packaging utility.
</summary>
</cvar>
<cvar name="ZIPCOM">
<summary>
The command line used to call the zip utility,
or the internal Python function used to create a
zip archive.
</summary>
</cvar>
<cvar name="ZIPCOMSTR">
<summary>
The string displayed when archiving files
using the zip utility.
If this is not set, then &cv-link-ZIPCOM;
(the command line or internal Python function) is displayed.
<example>
env = Environment(ZIPCOMSTR = "Zipping $TARGET")
</example>
</summary>
</cvar>
<cvar name="ZIPCOMPRESSION">
<summary>
The
<varname>compression</varname>
flag
from the Python
<filename>zipfile</filename>
module used by the internal Python function
to control whether the zip archive
is compressed or not.
The default value is
<literal>zipfile.ZIP_DEFLATED</literal>,
which creates a compressed zip archive.
This value has no effect if the
<literal>zipfile</literal>
module is unavailable.
</summary>
</cvar>
<cvar name="ZIPFLAGS">
<summary>
General options passed to the zip utility.
</summary>
</cvar>
<cvar name="ZIPSUFFIX">
<summary>
The suffix used for zip file names.
</summary>
</cvar>
<cvar name="ZIPROOT">
<summary>
An optional zip root directory (default empty). The filenames stored
in the zip file will be relative to this directory, if given.
Otherwise the filenames are relative to the current directory of the
command.
For instance:
<example>
env = Environment()
env.Zip('foo.zip', 'subdir1/subdir2/file1', ZIPROOT='subdir1')
</example>
will produce a zip file <literal>foo.zip</literal>
containing a file with the name
<literal>subdir2/file1</literal> rather than
<literal>subdir1/subdir2/file1</literal>.
</summary>
</cvar>
|
