blob: ff490bea192349c3990eb0e4df05ccfb56dddefd [file] [log] [blame]
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001# Python MSI Generator
2# (C) 2003 Martin v. Loewis
3# See "FOO" in comments refers to MSDN sections with the title FOO.
Martin v. Löwisa5e31092010-09-04 14:38:09 +00004import msilib, schema, sequence, os, glob, time, re, shutil, zipfile
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00005from msilib import Feature, CAB, Directory, Dialog, Binary, add_data
6import uisample
7from win32com.client import constants
Martin v. Löwis9fda9312004-12-22 13:41:49 +00008from distutils.spawn import find_executable
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00009from uuids import product_codes
Martin v. Löwis0077b652010-03-16 18:53:33 +000010import tempfile
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000011
12# Settings can be overridden in config.py below
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000013# 0 for official python.org releases
14# 1 for intermediate releases by anybody, with
15# a new product code for every package.
16snapshot = 1
17# 1 means that file extension is px, not py,
18# and binaries start with x
19testpackage = 0
20# Location of build tree
21srcdir = os.path.abspath("../..")
22# Text to be displayed as the version in dialogs etc.
23# goes into file name and ProductCode. Defaults to
24# current_version.day for Snapshot, current_version otherwise
25full_current_version = None
Martin v. Löwise0f780d2004-09-01 14:51:06 +000026# Is Tcl available at all?
27have_tcl = True
Christian Heimes81ca7c72007-11-18 18:18:41 +000028# path to PCbuild directory
Christian Heimesfaf2f632008-01-06 16:59:19 +000029PCBUILD="PCbuild"
Christian Heimes81ca7c72007-11-18 18:18:41 +000030# msvcrt version
Christian Heimesfaf2f632008-01-06 16:59:19 +000031MSVCR = "90"
Martin v. Löwis0077b652010-03-16 18:53:33 +000032# Name of certificate in default store to sign MSI with
33certname = None
Martin v. Löwisa5e31092010-09-04 14:38:09 +000034# Make a zip file containing the PDB files for this build?
35pdbzip = True
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000036
37try:
38 from config import *
39except ImportError:
40 pass
41
42# Extract current version from Include/patchlevel.h
43lines = open(srcdir + "/Include/patchlevel.h").readlines()
44major = minor = micro = level = serial = None
45levels = {
46 'PY_RELEASE_LEVEL_ALPHA':0xA,
47 'PY_RELEASE_LEVEL_BETA': 0xB,
48 'PY_RELEASE_LEVEL_GAMMA':0xC,
49 'PY_RELEASE_LEVEL_FINAL':0xF
50 }
51for l in lines:
52 if not l.startswith("#define"):
53 continue
54 l = l.split()
55 if len(l) != 3:
56 continue
57 _, name, value = l
58 if name == 'PY_MAJOR_VERSION': major = value
59 if name == 'PY_MINOR_VERSION': minor = value
60 if name == 'PY_MICRO_VERSION': micro = value
61 if name == 'PY_RELEASE_LEVEL': level = levels[value]
62 if name == 'PY_RELEASE_SERIAL': serial = value
63
64short_version = major+"."+minor
65# See PC/make_versioninfo.c
66FIELD3 = 1000*int(micro) + 10*level + int(serial)
67current_version = "%s.%d" % (short_version, FIELD3)
68
69# This should never change. The UpgradeCode of this package can be
70# used in the Upgrade table of future packages to make the future
71# package replace this one. See "UpgradeCode Property".
Martin v. Löwisf27f8a12008-09-13 08:14:01 +000072# upgrade_code gets set to upgrade_code_64 when we have determined
73# that the target is Win64.
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000074upgrade_code_snapshot='{92A24481-3ECB-40FC-8836-04B7966EC0D5}'
75upgrade_code='{65E6DE48-A358-434D-AA4F-4AF72DB4718F}'
Martin v. Löwisf27f8a12008-09-13 08:14:01 +000076upgrade_code_64='{6A965A0C-6EE6-4E3A-9983-3263F56311EC}'
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000077
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000078if snapshot:
79 current_version = "%s.%s.%s" % (major, minor, int(time.time()/3600/24))
80 product_code = msilib.gen_uuid()
81else:
82 product_code = product_codes[current_version]
83
84if full_current_version is None:
85 full_current_version = current_version
86
87extensions = [
88 'bz2.pyd',
89 'pyexpat.pyd',
90 'select.pyd',
91 'unicodedata.pyd',
92 'winsound.pyd',
Trent Micke97e5a72005-12-15 22:08:46 +000093 '_elementtree.pyd',
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +000094 '_socket.pyd',
95 '_ssl.pyd',
96 '_testcapi.pyd',
97 '_tkinter.pyd',
Martin v. Löwis8c7c56e2006-03-05 14:04:26 +000098 '_msi.pyd',
Martin v. Löwisa09655e2006-03-10 15:36:28 +000099 '_ctypes.pyd',
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000100 '_ctypes_test.pyd',
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000101 '_sqlite3.pyd',
Martin v. Löwis9aa04c42008-06-30 07:03:57 +0000102 '_hashlib.pyd',
103 '_multiprocessing.pyd'
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000104]
105
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000106# Well-known component UUIDs
107# These are needed for SharedDLLs reference counter; if
108# a different UUID was used for each incarnation of, say,
109# python24.dll, an upgrade would set the reference counter
110# from 1 to 2 (due to what I consider a bug in MSI)
111# Using the same UUID is fine since these files are versioned,
112# so Installer will always keep the newest version.
Christian Heimesd0764e22007-12-04 15:00:33 +0000113# NOTE: All uuids are self generated.
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000114pythondll_uuid = {
115 "24":"{9B81E618-2301-4035-AC77-75D9ABEB7301}",
Martin v. Löwis4c6c7ca2007-08-30 15:23:04 +0000116 "25":"{2e41b118-38bd-4c1b-a840-6977efd1b911}",
Guido van Rossumaf554a02007-08-16 23:48:43 +0000117 "26":"{34ebecac-f046-4e1c-b0e3-9bac3cdaacfa}",
Martin v. Löwis7a63fc42008-10-02 20:09:01 +0000118 "27":"{4fe21c76-1760-437b-a2f2-99909130a175}",
Martin v. Löwis4c6c7ca2007-08-30 15:23:04 +0000119 "30":"{6953bc3b-6768-4291-8410-7914ce6e2ca8}",
Martin v. Löwisfc972492008-10-02 20:09:47 +0000120 "31":"{4afcba0b-13e4-47c3-bebe-477428b46913}",
Martin v. Löwisb4f4e722010-03-16 14:16:09 +0000121 "32":"{3ff95315-1096-4d31-bd86-601d5438ad5e}",
Vinay Sajip4334d742011-07-03 10:35:41 +0100122 "33":"{f7581ca4-d368-4eea-8f82-d48c64c4f047}",
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000123 } [major+minor]
Tim Peterseba28be2005-03-28 01:08:02 +0000124
Alexandre Vassalotti6461e102008-05-15 22:09:29 +0000125# Compute the name that Sphinx gives to the docfile
126docfile = ""
Martin v. Löwisdb7b5702009-06-28 12:28:29 +0000127if int(micro):
128 docfile = micro
Alexandre Vassalotti6461e102008-05-15 22:09:29 +0000129if level < 0xf:
Benjamin Petersonb48f6342009-06-22 19:36:31 +0000130 if level == 0xC:
Martin v. Löwisdb7b5702009-06-28 12:28:29 +0000131 docfile += "rc%s" % (serial,)
Benjamin Petersonb48f6342009-06-22 19:36:31 +0000132 else:
Martin v. Löwisdb7b5702009-06-28 12:28:29 +0000133 docfile += '%x%s' % (level, serial)
Alexandre Vassalotti6461e102008-05-15 22:09:29 +0000134docfile = 'python%s%s%s.chm' % (major, minor, docfile)
135
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000136# Build the mingw import library, libpythonXY.a
137# This requires 'nm' and 'dlltool' executables on your PATH
138def build_mingw_lib(lib_file, def_file, dll_file, mingw_lib):
139 warning = "WARNING: %s - libpythonXX.a not built"
140 nm = find_executable('nm')
141 dlltool = find_executable('dlltool')
142
143 if not nm or not dlltool:
Collin Winter6afaeb72007-08-03 17:06:41 +0000144 print(warning % "nm and/or dlltool were not found")
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000145 return False
146
147 nm_command = '%s -Cs %s' % (nm, lib_file)
148 dlltool_command = "%s --dllname %s --def %s --output-lib %s" % \
149 (dlltool, dll_file, def_file, mingw_lib)
150 export_match = re.compile(r"^_imp__(.*) in python\d+\.dll").match
151
152 f = open(def_file,'w')
Martin v. Löwis4c6c7ca2007-08-30 15:23:04 +0000153 f.write("LIBRARY %s\n" % dll_file)
154 f.write("EXPORTS\n")
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000155
156 nm_pipe = os.popen(nm_command)
157 for line in nm_pipe.readlines():
158 m = export_match(line)
159 if m:
Martin v. Löwis4c6c7ca2007-08-30 15:23:04 +0000160 f.write(m.group(1)+"\n")
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000161 f.close()
162 exit = nm_pipe.close()
163
164 if exit:
Collin Winter6afaeb72007-08-03 17:06:41 +0000165 print(warning % "nm did not run successfully")
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000166 return False
167
168 if os.system(dlltool_command) != 0:
Collin Winter6afaeb72007-08-03 17:06:41 +0000169 print(warning % "dlltool did not run successfully")
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000170 return False
171
172 return True
173
174# Target files (.def and .a) go in PCBuild directory
Christian Heimes81ca7c72007-11-18 18:18:41 +0000175lib_file = os.path.join(srcdir, PCBUILD, "python%s%s.lib" % (major, minor))
176def_file = os.path.join(srcdir, PCBUILD, "python%s%s.def" % (major, minor))
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000177dll_file = "python%s%s.dll" % (major, minor)
Christian Heimes81ca7c72007-11-18 18:18:41 +0000178mingw_lib = os.path.join(srcdir, PCBUILD, "libpython%s%s.a" % (major, minor))
Martin v. Löwis9fda9312004-12-22 13:41:49 +0000179
180have_mingw = build_mingw_lib(lib_file, def_file, dll_file, mingw_lib)
181
Ezio Melotti42da6632011-03-15 05:18:48 +0200182# Determine the target architecture
Christian Heimes81ca7c72007-11-18 18:18:41 +0000183dll_path = os.path.join(srcdir, PCBUILD, dll_file)
Martin v. Löwis856bf9a2006-02-14 20:42:55 +0000184msilib.set_arch_from_file(dll_path)
185if msilib.pe_type(dll_path) != msilib.pe_type("msisupport.dll"):
Collin Wintera817e582007-08-22 23:05:06 +0000186 raise SystemError("msisupport.dll for incorrect architecture")
Martin v. Löwisf27f8a12008-09-13 08:14:01 +0000187if msilib.Win64:
188 upgrade_code = upgrade_code_64
Martin v. Löwise40a2132008-09-13 08:37:17 +0000189 # Bump the last digit of the code by one, so that 32-bit and 64-bit
190 # releases get separate product codes
191 digit = hex((int(product_code[-2],16)+1)%16)[-1]
192 product_code = product_code[:-2] + digit + '}'
Martin v. Löwis856bf9a2006-02-14 20:42:55 +0000193
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000194if testpackage:
195 ext = 'px'
196 testprefix = 'x'
197else:
198 ext = 'py'
199 testprefix = ''
200
201if msilib.Win64:
Martin v. Löwis47cc2a02007-08-30 18:27:06 +0000202 SystemFolderName = "[System64Folder]"
Martin v. Löwis283e35f2007-08-31 09:59:29 +0000203 registry_component = 4|256
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000204else:
205 SystemFolderName = "[SystemFolder]"
Martin v. Löwis283e35f2007-08-31 09:59:29 +0000206 registry_component = 4
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000207
208msilib.reset()
209
210# condition in which to install pythonxy.dll in system32:
211# a) it is Windows 9x or
212# b) it is NT, the user is privileged, and has chosen per-machine installation
213sys32cond = "(Windows9x or (Privileged and ALLUSERS))"
214
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000215def build_database():
216 """Generate an empty database, with just the schema and the
217 Summary information stream."""
218 if snapshot:
219 uc = upgrade_code_snapshot
220 else:
221 uc = upgrade_code
Martin v. Löwise40a2132008-09-13 08:37:17 +0000222 if msilib.Win64:
223 productsuffix = " (64-bit)"
224 else:
225 productsuffix = ""
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000226 # schema represents the installer 2.0 database schema.
227 # sequence is the set of standard sequences
228 # (ui/execute, admin/advt/install)
Martin v. Löwis0077b652010-03-16 18:53:33 +0000229 msiname = "python-%s%s.msi" % (full_current_version, msilib.arch_ext)
230 db = msilib.init_database(msiname,
Martin v. Löwise40a2132008-09-13 08:37:17 +0000231 schema, ProductName="Python "+full_current_version+productsuffix,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000232 ProductCode=product_code,
233 ProductVersion=current_version,
Martin v. Löwisf63921f2008-10-13 11:30:30 +0000234 Manufacturer=u"Python Software Foundation",
235 request_uac = True)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000236 # The default sequencing of the RemoveExistingProducts action causes
237 # removal of files that got just installed. Place it after
238 # InstallInitialize, so we first uninstall everything, but still roll
239 # back in case the installation is interrupted
240 msilib.change_sequence(sequence.InstallExecuteSequence,
241 "RemoveExistingProducts", 1510)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000242 msilib.add_tables(db, sequence)
243 # We cannot set ALLUSERS in the property table, as this cannot be
244 # reset if the user choses a per-user installation. Instead, we
245 # maintain WhichUsers, which can be "ALL" or "JUSTME". The UI manages
246 # this property, and when the execution starts, ALLUSERS is set
247 # accordingly.
248 add_data(db, "Property", [("UpgradeCode", uc),
249 ("WhichUsers", "ALL"),
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000250 ("ProductLine", "Python%s%s" % (major, minor)),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000251 ])
252 db.Commit()
Martin v. Löwis0077b652010-03-16 18:53:33 +0000253 return db, msiname
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000254
255def remove_old_versions(db):
256 "Fill the upgrade table."
257 start = "%s.%s.0" % (major, minor)
258 # This requests that feature selection states of an older
259 # installation should be forwarded into this one. Upgrading
260 # requires that both the old and the new installation are
261 # either both per-machine or per-user.
262 migrate_features = 1
263 # See "Upgrade Table". We remove releases with the same major and
264 # minor version. For an snapshot, we remove all earlier snapshots. For
265 # a release, we remove all snapshots, and all earlier releases.
266 if snapshot:
267 add_data(db, "Upgrade",
Tim Peters66cb0182004-08-26 05:23:19 +0000268 [(upgrade_code_snapshot, start,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000269 current_version,
270 None, # Ignore language
Tim Peters66cb0182004-08-26 05:23:19 +0000271 migrate_features,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000272 None, # Migrate ALL features
273 "REMOVEOLDSNAPSHOT")])
274 props = "REMOVEOLDSNAPSHOT"
275 else:
276 add_data(db, "Upgrade",
277 [(upgrade_code, start, current_version,
278 None, migrate_features, None, "REMOVEOLDVERSION"),
279 (upgrade_code_snapshot, start, "%s.%d.0" % (major, int(minor)+1),
280 None, migrate_features, None, "REMOVEOLDSNAPSHOT")])
281 props = "REMOVEOLDSNAPSHOT;REMOVEOLDVERSION"
Martin v. Löwis1c4c3062008-09-08 16:27:54 +0000282
283 props += ";TARGETDIR;DLLDIR"
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000284 # Installer collects the product codes of the earlier releases in
285 # these properties. In order to allow modification of the properties,
286 # they must be declared as secure. See "SecureCustomProperties Property"
287 add_data(db, "Property", [("SecureCustomProperties", props)])
288
289class PyDialog(Dialog):
290 """Dialog class with a fixed layout: controls at the top, then a ruler,
291 then a list of buttons: back, next, cancel. Optionally a bitmap at the
292 left."""
293 def __init__(self, *args, **kw):
294 """Dialog(database, name, x, y, w, h, attributes, title, first,
295 default, cancel, bitmap=true)"""
296 Dialog.__init__(self, *args)
297 ruler = self.h - 36
298 bmwidth = 152*ruler/328
299 if kw.get("bitmap", True):
300 self.bitmap("Bitmap", 0, 0, bmwidth, ruler, "PythonWin")
301 self.line("BottomLine", 0, ruler, self.w, 0)
302
303 def title(self, title):
304 "Set the title text of the dialog at the top."
305 # name, x, y, w, h, flags=Visible|Enabled|Transparent|NoPrefix,
306 # text, in VerdanaBold10
307 self.text("Title", 135, 10, 220, 60, 0x30003,
308 r"{\VerdanaBold10}%s" % title)
309
310 def back(self, title, next, name = "Back", active = 1):
311 """Add a back button with a given title, the tab-next button,
312 its name in the Control table, possibly initially disabled.
313
314 Return the button, so that events can be associated"""
315 if active:
316 flags = 3 # Visible|Enabled
317 else:
318 flags = 1 # Visible
319 return self.pushbutton(name, 180, self.h-27 , 56, 17, flags, title, next)
320
321 def cancel(self, title, next, name = "Cancel", active = 1):
322 """Add a cancel button with a given title, the tab-next button,
323 its name in the Control table, possibly initially disabled.
324
325 Return the button, so that events can be associated"""
326 if active:
327 flags = 3 # Visible|Enabled
328 else:
329 flags = 1 # Visible
330 return self.pushbutton(name, 304, self.h-27, 56, 17, flags, title, next)
331
332 def next(self, title, next, name = "Next", active = 1):
333 """Add a Next button with a given title, the tab-next button,
334 its name in the Control table, possibly initially disabled.
335
336 Return the button, so that events can be associated"""
337 if active:
338 flags = 3 # Visible|Enabled
339 else:
340 flags = 1 # Visible
341 return self.pushbutton(name, 236, self.h-27, 56, 17, flags, title, next)
342
343 def xbutton(self, name, title, next, xpos):
344 """Add a button with a given title, the tab-next button,
345 its name in the Control table, giving its x position; the
346 y-position is aligned with the other buttons.
347
348 Return the button, so that events can be associated"""
349 return self.pushbutton(name, int(self.w*xpos - 28), self.h-27, 56, 17, 3, title, next)
350
351def add_ui(db):
352 x = y = 50
353 w = 370
354 h = 300
355 title = "[ProductName] Setup"
356
357 # see "Dialog Style Bits"
358 modal = 3 # visible | modal
359 modeless = 1 # visible
360 track_disk_space = 32
361
362 add_data(db, 'ActionText', uisample.ActionText)
363 add_data(db, 'UIText', uisample.UIText)
364
365 # Bitmaps
366 if not os.path.exists(srcdir+r"\PC\python_icon.exe"):
Georg Brandlbf82e372008-05-16 17:02:34 +0000367 raise RuntimeError("Run icons.mak in PC directory")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000368 add_data(db, "Binary",
Christian Heimesd9a4d1d2008-01-01 14:42:15 +0000369 [("PythonWin", msilib.Binary(r"%s\PCbuild\installer.bmp" % srcdir)), # 152x328 pixels
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000370 ("py.ico",msilib.Binary(srcdir+r"\PC\py.ico")),
371 ])
372 add_data(db, "Icon",
373 [("python_icon.exe", msilib.Binary(srcdir+r"\PC\python_icon.exe"))])
374
375 # Scripts
Martin v. Löwisdff68d02004-09-10 09:20:10 +0000376 # CheckDir sets TargetExists if TARGETDIR exists.
377 # UpdateEditIDLE sets the REGISTRY.tcl component into
378 # the installed/uninstalled state according to both the
379 # Extensions and TclTk features.
Martin v. Löwiseb68be42004-12-12 15:29:21 +0000380 if os.system("nmake /nologo /c /f msisupport.mak") != 0:
Georg Brandlbf82e372008-05-16 17:02:34 +0000381 raise RuntimeError("'nmake /f msisupport.mak' failed")
Martin v. Löwiseb68be42004-12-12 15:29:21 +0000382 add_data(db, "Binary", [("Script", msilib.Binary("msisupport.dll"))])
383 # See "Custom Action Type 1"
Martin v. Löwis3390d332005-03-14 17:20:13 +0000384 if msilib.Win64:
385 CheckDir = "CheckDir"
Martin v. Löwisdf40ce32006-02-16 14:38:30 +0000386 UpdateEditIDLE = "UpdateEditIDLE"
Martin v. Löwis3390d332005-03-14 17:20:13 +0000387 else:
388 CheckDir = "_CheckDir@4"
389 UpdateEditIDLE = "_UpdateEditIDLE@4"
Tim Peters0e9980f2004-09-12 03:49:31 +0000390 add_data(db, "CustomAction",
Martin v. Löwis3390d332005-03-14 17:20:13 +0000391 [("CheckDir", 1, "Script", CheckDir)])
Martin v. Löwiseac02e62004-11-18 08:00:33 +0000392 if have_tcl:
393 add_data(db, "CustomAction",
Martin v. Löwis3390d332005-03-14 17:20:13 +0000394 [("UpdateEditIDLE", 1, "Script", UpdateEditIDLE)])
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000395
396 # UI customization properties
397 add_data(db, "Property",
398 # See "DefaultUIFont Property"
399 [("DefaultUIFont", "DlgFont8"),
400 # See "ErrorDialog Style Bit"
401 ("ErrorDialog", "ErrorDlg"),
402 ("Progress1", "Install"), # modified in maintenance type dlg
403 ("Progress2", "installs"),
404 ("MaintenanceForm_Action", "Repair")])
405
406 # Fonts, see "TextStyle Table"
407 add_data(db, "TextStyle",
408 [("DlgFont8", "Tahoma", 9, None, 0),
409 ("DlgFontBold8", "Tahoma", 8, None, 1), #bold
410 ("VerdanaBold10", "Verdana", 10, None, 1),
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000411 ("VerdanaRed9", "Verdana", 9, 255, 0),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000412 ])
413
Martin v. Löwis4ad70df2010-03-16 16:19:47 +0000414 compileargs = r'-Wi "[TARGETDIR]Lib\compileall.py" -f -x "bad_coding|badsyntax|site-packages|py2_|lib2to3\\tests" "[TARGETDIR]Lib"'
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000415 lib2to3args = r'-c "import lib2to3.pygram, lib2to3.patcomp;lib2to3.patcomp.PatternCompiler()"'
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000416 # See "CustomAction Table"
417 add_data(db, "CustomAction", [
418 # msidbCustomActionTypeFirstSequence + msidbCustomActionTypeTextData + msidbCustomActionTypeProperty
419 # See "Custom Action Type 51",
420 # "Custom Action Execution Scheduling Options"
421 ("InitialTargetDir", 307, "TARGETDIR",
422 "[WindowsVolume]Python%s%s" % (major, minor)),
423 ("SetDLLDirToTarget", 307, "DLLDIR", "[TARGETDIR]"),
424 ("SetDLLDirToSystem32", 307, "DLLDIR", SystemFolderName),
425 # msidbCustomActionTypeExe + msidbCustomActionTypeSourceFile
426 # See "Custom Action Type 18"
Martin v. Löwis7b2563b2004-11-02 22:59:56 +0000427 ("CompilePyc", 18, "python.exe", compileargs),
428 ("CompilePyo", 18, "python.exe", "-O "+compileargs),
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000429 ("CompileGrammar", 18, "python.exe", lib2to3args),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000430 ])
431
432 # UI Sequences, see "InstallUISequence Table", "Using a Sequence Table"
433 # Numbers indicate sequence; see sequence.py for how these action integrate
434 add_data(db, "InstallUISequence",
435 [("PrepareDlg", "Not Privileged or Windows9x or Installed", 140),
436 ("WhichUsersDlg", "Privileged and not Windows9x and not Installed", 141),
437 ("InitialTargetDir", 'TARGETDIR=""', 750),
438 # In the user interface, assume all-users installation if privileged.
439 ("SetDLLDirToSystem32", 'DLLDIR="" and ' + sys32cond, 751),
440 ("SetDLLDirToTarget", 'DLLDIR="" and not ' + sys32cond, 752),
441 ("SelectDirectoryDlg", "Not Installed", 1230),
442 # XXX no support for resume installations yet
443 #("ResumeDlg", "Installed AND (RESUME OR Preselected)", 1240),
444 ("MaintenanceTypeDlg", "Installed AND NOT RESUME AND NOT Preselected", 1250),
445 ("ProgressDlg", None, 1280)])
446 add_data(db, "AdminUISequence",
447 [("InitialTargetDir", 'TARGETDIR=""', 750),
448 ("SetDLLDirToTarget", 'DLLDIR=""', 751),
449 ])
450
451 # Execute Sequences
452 add_data(db, "InstallExecuteSequence",
453 [("InitialTargetDir", 'TARGETDIR=""', 750),
454 ("SetDLLDirToSystem32", 'DLLDIR="" and ' + sys32cond, 751),
455 ("SetDLLDirToTarget", 'DLLDIR="" and not ' + sys32cond, 752),
Martin v. Löwisdff68d02004-09-10 09:20:10 +0000456 ("UpdateEditIDLE", None, 1050),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000457 ("CompilePyc", "COMPILEALL", 6800),
458 ("CompilePyo", "COMPILEALL", 6801),
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000459 ("CompileGrammar", "COMPILEALL", 6802),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000460 ])
461 add_data(db, "AdminExecuteSequence",
462 [("InitialTargetDir", 'TARGETDIR=""', 750),
463 ("SetDLLDirToTarget", 'DLLDIR=""', 751),
464 ("CompilePyc", "COMPILEALL", 6800),
465 ("CompilePyo", "COMPILEALL", 6801),
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000466 ("CompileGrammar", "COMPILEALL", 6802),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000467 ])
468
469 #####################################################################
470 # Standard dialogs: FatalError, UserExit, ExitDialog
471 fatal=PyDialog(db, "FatalError", x, y, w, h, modal, title,
472 "Finish", "Finish", "Finish")
473 fatal.title("[ProductName] Installer ended prematurely")
474 fatal.back("< Back", "Finish", active = 0)
475 fatal.cancel("Cancel", "Back", active = 0)
476 fatal.text("Description1", 135, 70, 220, 80, 0x30003,
477 "[ProductName] setup ended prematurely because of an error. Your system has not been modified. To install this program at a later time, please run the installation again.")
478 fatal.text("Description2", 135, 155, 220, 20, 0x30003,
479 "Click the Finish button to exit the Installer.")
480 c=fatal.next("Finish", "Cancel", name="Finish")
481 # See "ControlEvent Table". Parameters are the event, the parameter
482 # to the action, and optionally the condition for the event, and the order
483 # of events.
484 c.event("EndDialog", "Exit")
Tim Peters66cb0182004-08-26 05:23:19 +0000485
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000486 user_exit=PyDialog(db, "UserExit", x, y, w, h, modal, title,
487 "Finish", "Finish", "Finish")
488 user_exit.title("[ProductName] Installer was interrupted")
489 user_exit.back("< Back", "Finish", active = 0)
490 user_exit.cancel("Cancel", "Back", active = 0)
491 user_exit.text("Description1", 135, 70, 220, 80, 0x30003,
492 "[ProductName] setup was interrupted. Your system has not been modified. "
493 "To install this program at a later time, please run the installation again.")
494 user_exit.text("Description2", 135, 155, 220, 20, 0x30003,
495 "Click the Finish button to exit the Installer.")
496 c = user_exit.next("Finish", "Cancel", name="Finish")
497 c.event("EndDialog", "Exit")
Tim Peters66cb0182004-08-26 05:23:19 +0000498
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000499 exit_dialog = PyDialog(db, "ExitDialog", x, y, w, h, modal, title,
500 "Finish", "Finish", "Finish")
501 exit_dialog.title("Completing the [ProductName] Installer")
502 exit_dialog.back("< Back", "Finish", active = 0)
503 exit_dialog.cancel("Cancel", "Back", active = 0)
Martin v. Löwis2dd2a282004-08-22 17:10:12 +0000504 exit_dialog.text("Acknowledgements", 135, 95, 220, 120, 0x30003,
505 "Special Windows thanks to:\n"
Martin v. Löwisd3f61a22004-08-30 09:22:30 +0000506 " Mark Hammond, without whose years of freely \n"
507 " shared Windows expertise, Python for Windows \n"
508 " would still be Python for DOS.")
Tim Peters66cb0182004-08-26 05:23:19 +0000509
Martin v. Löwis8c7c56e2006-03-05 14:04:26 +0000510 c = exit_dialog.text("warning", 135, 200, 220, 40, 0x30003,
511 "{\\VerdanaRed9}Warning: Python 2.5.x is the last "
512 "Python release for Windows 9x.")
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000513 c.condition("Hide", "NOT Version9X")
Martin v. Löwis8c7c56e2006-03-05 14:04:26 +0000514
Martin v. Löwis2dd2a282004-08-22 17:10:12 +0000515 exit_dialog.text("Description", 135, 235, 220, 20, 0x30003,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000516 "Click the Finish button to exit the Installer.")
517 c = exit_dialog.next("Finish", "Cancel", name="Finish")
518 c.event("EndDialog", "Return")
519
520 #####################################################################
521 # Required dialog: FilesInUse, ErrorDlg
522 inuse = PyDialog(db, "FilesInUse",
523 x, y, w, h,
524 19, # KeepModeless|Modal|Visible
525 title,
526 "Retry", "Retry", "Retry", bitmap=False)
527 inuse.text("Title", 15, 6, 200, 15, 0x30003,
528 r"{\DlgFontBold8}Files in Use")
529 inuse.text("Description", 20, 23, 280, 20, 0x30003,
530 "Some files that need to be updated are currently in use.")
531 inuse.text("Text", 20, 55, 330, 50, 3,
532 "The following applications are using files that need to be updated by this setup. Close these applications and then click Retry to continue the installation or Cancel to exit it.")
533 inuse.control("List", "ListBox", 20, 107, 330, 130, 7, "FileInUseProcess",
534 None, None, None)
535 c=inuse.back("Exit", "Ignore", name="Exit")
536 c.event("EndDialog", "Exit")
537 c=inuse.next("Ignore", "Retry", name="Ignore")
538 c.event("EndDialog", "Ignore")
539 c=inuse.cancel("Retry", "Exit", name="Retry")
540 c.event("EndDialog","Retry")
541
542
543 # See "Error Dialog". See "ICE20" for the required names of the controls.
544 error = Dialog(db, "ErrorDlg",
545 50, 10, 330, 101,
546 65543, # Error|Minimize|Modal|Visible
547 title,
548 "ErrorText", None, None)
549 error.text("ErrorText", 50,9,280,48,3, "")
550 error.control("ErrorIcon", "Icon", 15, 9, 24, 24, 5242881, None, "py.ico", None, None)
551 error.pushbutton("N",120,72,81,21,3,"No",None).event("EndDialog","ErrorNo")
552 error.pushbutton("Y",240,72,81,21,3,"Yes",None).event("EndDialog","ErrorYes")
553 error.pushbutton("A",0,72,81,21,3,"Abort",None).event("EndDialog","ErrorAbort")
554 error.pushbutton("C",42,72,81,21,3,"Cancel",None).event("EndDialog","ErrorCancel")
555 error.pushbutton("I",81,72,81,21,3,"Ignore",None).event("EndDialog","ErrorIgnore")
556 error.pushbutton("O",159,72,81,21,3,"Ok",None).event("EndDialog","ErrorOk")
557 error.pushbutton("R",198,72,81,21,3,"Retry",None).event("EndDialog","ErrorRetry")
558
559 #####################################################################
560 # Global "Query Cancel" dialog
561 cancel = Dialog(db, "CancelDlg", 50, 10, 260, 85, 3, title,
562 "No", "No", "No")
Tim Peters66cb0182004-08-26 05:23:19 +0000563 cancel.text("Text", 48, 15, 194, 30, 3,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000564 "Are you sure you want to cancel [ProductName] installation?")
565 cancel.control("Icon", "Icon", 15, 15, 24, 24, 5242881, None,
566 "py.ico", None, None)
567 c=cancel.pushbutton("Yes", 72, 57, 56, 17, 3, "Yes", "No")
568 c.event("EndDialog", "Exit")
Tim Peters66cb0182004-08-26 05:23:19 +0000569
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000570 c=cancel.pushbutton("No", 132, 57, 56, 17, 3, "No", "Yes")
571 c.event("EndDialog", "Return")
572
573 #####################################################################
574 # Global "Wait for costing" dialog
575 costing = Dialog(db, "WaitForCostingDlg", 50, 10, 260, 85, modal, title,
576 "Return", "Return", "Return")
577 costing.text("Text", 48, 15, 194, 30, 3,
578 "Please wait while the installer finishes determining your disk space requirements.")
579 costing.control("Icon", "Icon", 15, 15, 24, 24, 5242881, None,
580 "py.ico", None, None)
581 c = costing.pushbutton("Return", 102, 57, 56, 17, 3, "Return", None)
582 c.event("EndDialog", "Exit")
583
584 #####################################################################
585 # Preparation dialog: no user input except cancellation
586 prep = PyDialog(db, "PrepareDlg", x, y, w, h, modeless, title,
587 "Cancel", "Cancel", "Cancel")
588 prep.text("Description", 135, 70, 220, 40, 0x30003,
589 "Please wait while the Installer prepares to guide you through the installation.")
590 prep.title("Welcome to the [ProductName] Installer")
591 c=prep.text("ActionText", 135, 110, 220, 20, 0x30003, "Pondering...")
592 c.mapping("ActionText", "Text")
593 c=prep.text("ActionData", 135, 135, 220, 30, 0x30003, None)
594 c.mapping("ActionData", "Text")
595 prep.back("Back", None, active=0)
596 prep.next("Next", None, active=0)
597 c=prep.cancel("Cancel", None)
598 c.event("SpawnDialog", "CancelDlg")
599
600 #####################################################################
601 # Target directory selection
602 seldlg = PyDialog(db, "SelectDirectoryDlg", x, y, w, h, modal, title,
603 "Next", "Next", "Cancel")
604 seldlg.title("Select Destination Directory")
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000605 c = seldlg.text("Existing", 135, 25, 235, 30, 0x30003,
606 "{\VerdanaRed9}This update will replace your existing [ProductLine] installation.")
607 c.condition("Hide", 'REMOVEOLDVERSION="" and REMOVEOLDSNAPSHOT=""')
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000608 seldlg.text("Description", 135, 50, 220, 40, 0x30003,
609 "Please select a directory for the [ProductName] files.")
610
611 seldlg.back("< Back", None, active=0)
612 c = seldlg.next("Next >", "Cancel")
613 c.event("DoAction", "CheckDir", "TargetExistsOk<>1", order=1)
614 # If the target exists, but we found that we are going to remove old versions, don't bother
615 # confirming that the target directory exists. Strictly speaking, we should determine that
616 # the target directory is indeed the target of the product that we are going to remove, but
617 # I don't know how to do that.
618 c.event("SpawnDialog", "ExistingDirectoryDlg", 'TargetExists=1 and REMOVEOLDVERSION="" and REMOVEOLDSNAPSHOT=""', 2)
619 c.event("SetTargetPath", "TARGETDIR", 'TargetExists=0 or REMOVEOLDVERSION<>"" or REMOVEOLDSNAPSHOT<>""', 3)
620 c.event("SpawnWaitDialog", "WaitForCostingDlg", "CostingComplete=1", 4)
621 c.event("NewDialog", "SelectFeaturesDlg", 'TargetExists=0 or REMOVEOLDVERSION<>"" or REMOVEOLDSNAPSHOT<>""', 5)
622
623 c = seldlg.cancel("Cancel", "DirectoryCombo")
624 c.event("SpawnDialog", "CancelDlg")
625
626 seldlg.control("DirectoryCombo", "DirectoryCombo", 135, 70, 172, 80, 393219,
627 "TARGETDIR", None, "DirectoryList", None)
628 seldlg.control("DirectoryList", "DirectoryList", 135, 90, 208, 136, 3, "TARGETDIR",
629 None, "PathEdit", None)
630 seldlg.control("PathEdit", "PathEdit", 135, 230, 206, 16, 3, "TARGETDIR", None, "Next", None)
631 c = seldlg.pushbutton("Up", 306, 70, 18, 18, 3, "Up", None)
632 c.event("DirectoryListUp", "0")
633 c = seldlg.pushbutton("NewDir", 324, 70, 30, 18, 3, "New", None)
634 c.event("DirectoryListNew", "0")
635
636 #####################################################################
637 # SelectFeaturesDlg
638 features = PyDialog(db, "SelectFeaturesDlg", x, y, w, h, modal|track_disk_space,
639 title, "Tree", "Next", "Cancel")
640 features.title("Customize [ProductName]")
641 features.text("Description", 135, 35, 220, 15, 0x30003,
642 "Select the way you want features to be installed.")
643 features.text("Text", 135,45,220,30, 3,
644 "Click on the icons in the tree below to change the way features will be installed.")
645
646 c=features.back("< Back", "Next")
647 c.event("NewDialog", "SelectDirectoryDlg")
648
649 c=features.next("Next >", "Cancel")
650 c.mapping("SelectionNoItems", "Enabled")
651 c.event("SpawnDialog", "DiskCostDlg", "OutOfDiskSpace=1", order=1)
652 c.event("EndDialog", "Return", "OutOfDiskSpace<>1", order=2)
653
654 c=features.cancel("Cancel", "Tree")
655 c.event("SpawnDialog", "CancelDlg")
656
Tim Peters66cb0182004-08-26 05:23:19 +0000657 # The browse property is not used, since we have only a single target path (selected already)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000658 features.control("Tree", "SelectionTree", 135, 75, 220, 95, 7, "_BrowseProperty",
659 "Tree of selections", "Back", None)
660
661 #c=features.pushbutton("Reset", 42, 243, 56, 17, 3, "Reset", "DiskCost")
662 #c.mapping("SelectionNoItems", "Enabled")
663 #c.event("Reset", "0")
Tim Peters66cb0182004-08-26 05:23:19 +0000664
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000665 features.control("Box", "GroupBox", 135, 170, 225, 90, 1, None, None, None, None)
666
667 c=features.xbutton("DiskCost", "Disk &Usage", None, 0.10)
668 c.mapping("SelectionNoItems","Enabled")
669 c.event("SpawnDialog", "DiskCostDlg")
670
671 c=features.xbutton("Advanced", "Advanced", None, 0.30)
672 c.event("SpawnDialog", "AdvancedDlg")
673
674 c=features.text("ItemDescription", 140, 180, 210, 30, 3,
675 "Multiline description of the currently selected item.")
676 c.mapping("SelectionDescription","Text")
Tim Peters66cb0182004-08-26 05:23:19 +0000677
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000678 c=features.text("ItemSize", 140, 210, 210, 45, 3,
679 "The size of the currently selected item.")
680 c.mapping("SelectionSize", "Text")
681
682 #####################################################################
683 # Disk cost
684 cost = PyDialog(db, "DiskCostDlg", x, y, w, h, modal, title,
685 "OK", "OK", "OK", bitmap=False)
686 cost.text("Title", 15, 6, 200, 15, 0x30003,
687 "{\DlgFontBold8}Disk Space Requirements")
688 cost.text("Description", 20, 20, 280, 20, 0x30003,
689 "The disk space required for the installation of the selected features.")
690 cost.text("Text", 20, 53, 330, 60, 3,
691 "The highlighted volumes (if any) do not have enough disk space "
692 "available for the currently selected features. You can either "
693 "remove some files from the highlighted volumes, or choose to "
694 "install less features onto local drive(s), or select different "
695 "destination drive(s).")
696 cost.control("VolumeList", "VolumeCostList", 20, 100, 330, 150, 393223,
697 None, "{120}{70}{70}{70}{70}", None, None)
698 cost.xbutton("OK", "Ok", None, 0.5).event("EndDialog", "Return")
699
700 #####################################################################
701 # WhichUsers Dialog. Only available on NT, and for privileged users.
702 # This must be run before FindRelatedProducts, because that will
703 # take into account whether the previous installation was per-user
704 # or per-machine. We currently don't support going back to this
705 # dialog after "Next" was selected; to support this, we would need to
706 # find how to reset the ALLUSERS property, and how to re-run
707 # FindRelatedProducts.
708 # On Windows9x, the ALLUSERS property is ignored on the command line
709 # and in the Property table, but installer fails according to the documentation
710 # if a dialog attempts to set ALLUSERS.
711 whichusers = PyDialog(db, "WhichUsersDlg", x, y, w, h, modal, title,
712 "AdminInstall", "Next", "Cancel")
713 whichusers.title("Select whether to install [ProductName] for all users of this computer.")
714 # A radio group with two options: allusers, justme
Martin v. Löwisf63921f2008-10-13 11:30:30 +0000715 g = whichusers.radiogroup("AdminInstall", 135, 60, 235, 80, 3,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000716 "WhichUsers", "", "Next")
Martin v. Löwisf63921f2008-10-13 11:30:30 +0000717 g.condition("Disable", "VersionNT=600") # Not available on Vista and Windows 2008
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000718 g.add("ALL", 0, 5, 150, 20, "Install for all users")
Martin v. Löwisf63921f2008-10-13 11:30:30 +0000719 g.add("JUSTME", 0, 25, 235, 20, "Install just for me (not available on Windows Vista)")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000720
Tim Peters66cb0182004-08-26 05:23:19 +0000721 whichusers.back("Back", None, active=0)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000722
723 c = whichusers.next("Next >", "Cancel")
724 c.event("[ALLUSERS]", "1", 'WhichUsers="ALL"', 1)
725 c.event("EndDialog", "Return", order = 2)
726
727 c = whichusers.cancel("Cancel", "AdminInstall")
728 c.event("SpawnDialog", "CancelDlg")
Tim Peters66cb0182004-08-26 05:23:19 +0000729
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000730 #####################################################################
731 # Advanced Dialog.
732 advanced = PyDialog(db, "AdvancedDlg", x, y, w, h, modal, title,
Martin v. Löwisa632a752008-11-19 13:55:07 +0000733 "CompilePyc", "Ok", "Ok")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000734 advanced.title("Advanced Options for [ProductName]")
735 # A radio group with two options: allusers, justme
736 advanced.checkbox("CompilePyc", 135, 60, 230, 50, 3,
Martin v. Löwisa632a752008-11-19 13:55:07 +0000737 "COMPILEALL", "Compile .py files to byte code after installation", "Ok")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000738
Martin v. Löwisa632a752008-11-19 13:55:07 +0000739 c = advanced.cancel("Ok", "CompilePyc", name="Ok") # Button just has location of cancel button.
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000740 c.event("EndDialog", "Return")
741
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000742 #####################################################################
Tim Peters66cb0182004-08-26 05:23:19 +0000743 # Existing Directory dialog
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000744 dlg = Dialog(db, "ExistingDirectoryDlg", 50, 30, 200, 80, modal, title,
745 "No", "No", "No")
746 dlg.text("Title", 10, 20, 180, 40, 3,
747 "[TARGETDIR] exists. Are you sure you want to overwrite existing files?")
748 c=dlg.pushbutton("Yes", 30, 60, 55, 17, 3, "Yes", "No")
749 c.event("[TargetExists]", "0", order=1)
750 c.event("[TargetExistsOk]", "1", order=2)
751 c.event("EndDialog", "Return", order=3)
752 c=dlg.pushbutton("No", 115, 60, 55, 17, 3, "No", "Yes")
753 c.event("EndDialog", "Return")
754
755 #####################################################################
756 # Installation Progress dialog (modeless)
757 progress = PyDialog(db, "ProgressDlg", x, y, w, h, modeless, title,
758 "Cancel", "Cancel", "Cancel", bitmap=False)
759 progress.text("Title", 20, 15, 200, 15, 0x30003,
760 "{\DlgFontBold8}[Progress1] [ProductName]")
761 progress.text("Text", 35, 65, 300, 30, 3,
762 "Please wait while the Installer [Progress2] [ProductName]. "
763 "This may take several minutes.")
764 progress.text("StatusLabel", 35, 100, 35, 20, 3, "Status:")
765
766 c=progress.text("ActionText", 70, 100, w-70, 20, 3, "Pondering...")
767 c.mapping("ActionText", "Text")
768
769 #c=progress.text("ActionData", 35, 140, 300, 20, 3, None)
770 #c.mapping("ActionData", "Text")
771
772 c=progress.control("ProgressBar", "ProgressBar", 35, 120, 300, 10, 65537,
773 None, "Progress done", None, None)
774 c.mapping("SetProgress", "Progress")
775
776 progress.back("< Back", "Next", active=False)
777 progress.next("Next >", "Cancel", active=False)
778 progress.cancel("Cancel", "Back").event("SpawnDialog", "CancelDlg")
779
780 # Maintenance type: repair/uninstall
781 maint = PyDialog(db, "MaintenanceTypeDlg", x, y, w, h, modal, title,
782 "Next", "Next", "Cancel")
783 maint.title("Welcome to the [ProductName] Setup Wizard")
784 maint.text("BodyText", 135, 63, 230, 42, 3,
785 "Select whether you want to repair or remove [ProductName].")
786 g=maint.radiogroup("RepairRadioGroup", 135, 108, 230, 60, 3,
787 "MaintenanceForm_Action", "", "Next")
788 g.add("Change", 0, 0, 200, 17, "&Change [ProductName]")
789 g.add("Repair", 0, 18, 200, 17, "&Repair [ProductName]")
790 g.add("Remove", 0, 36, 200, 17, "Re&move [ProductName]")
Tim Peters66cb0182004-08-26 05:23:19 +0000791
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000792 maint.back("< Back", None, active=False)
793 c=maint.next("Finish", "Cancel")
794 # Change installation: Change progress dialog to "Change", then ask
795 # for feature selection
796 c.event("[Progress1]", "Change", 'MaintenanceForm_Action="Change"', 1)
797 c.event("[Progress2]", "changes", 'MaintenanceForm_Action="Change"', 2)
798
799 # Reinstall: Change progress dialog to "Repair", then invoke reinstall
800 # Also set list of reinstalled features to "ALL"
801 c.event("[REINSTALL]", "ALL", 'MaintenanceForm_Action="Repair"', 5)
802 c.event("[Progress1]", "Repairing", 'MaintenanceForm_Action="Repair"', 6)
Raymond Hettinger72f08012004-11-07 07:08:25 +0000803 c.event("[Progress2]", "repairs", 'MaintenanceForm_Action="Repair"', 7)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000804 c.event("Reinstall", "ALL", 'MaintenanceForm_Action="Repair"', 8)
805
806 # Uninstall: Change progress to "Remove", then invoke uninstall
807 # Also set list of removed features to "ALL"
808 c.event("[REMOVE]", "ALL", 'MaintenanceForm_Action="Remove"', 11)
809 c.event("[Progress1]", "Removing", 'MaintenanceForm_Action="Remove"', 12)
810 c.event("[Progress2]", "removes", 'MaintenanceForm_Action="Remove"', 13)
811 c.event("Remove", "ALL", 'MaintenanceForm_Action="Remove"', 14)
812
Tim Peters66cb0182004-08-26 05:23:19 +0000813 # Close dialog when maintenance action scheduled
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000814 c.event("EndDialog", "Return", 'MaintenanceForm_Action<>"Change"', 20)
815 c.event("NewDialog", "SelectFeaturesDlg", 'MaintenanceForm_Action="Change"', 21)
Tim Peters66cb0182004-08-26 05:23:19 +0000816
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000817 maint.cancel("Cancel", "RepairRadioGroup").event("SpawnDialog", "CancelDlg")
Tim Peters66cb0182004-08-26 05:23:19 +0000818
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000819
820# See "Feature Table". The feature level is 1 for all features,
821# and the feature attributes are 0 for the DefaultFeature, and
822# FollowParent for all other features. The numbers are the Display
823# column.
824def add_features(db):
825 # feature attributes:
826 # msidbFeatureAttributesFollowParent == 2
827 # msidbFeatureAttributesDisallowAdvertise == 8
828 # Features that need to be installed with together with the main feature
829 # (i.e. additional Python libraries) need to follow the parent feature.
830 # Features that have no advertisement trigger (e.g. the test suite)
831 # must not support advertisement
Martin v. Löwis21c80f22008-04-07 21:14:19 +0000832 global default_feature, tcltk, htmlfiles, tools, testsuite, ext_feature, private_crt
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000833 default_feature = Feature(db, "DefaultFeature", "Python",
834 "Python Interpreter and Libraries",
835 1, directory = "TARGETDIR")
Martin v. Löwis2a241ca2008-04-05 18:58:09 +0000836 shared_crt = Feature(db, "SharedCRT", "MSVCRT", "C Run-Time (system-wide)", 0,
837 level=0)
838 private_crt = Feature(db, "PrivateCRT", "MSVCRT", "C Run-Time (private)", 0,
839 level=0)
840 add_data(db, "Condition", [("SharedCRT", 1, sys32cond),
841 ("PrivateCRT", 1, "not "+sys32cond)])
Martin v. Löwisdff68d02004-09-10 09:20:10 +0000842 # We don't support advertisement of extensions
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000843 ext_feature = Feature(db, "Extensions", "Register Extensions",
844 "Make this Python installation the default Python installation", 3,
Martin v. Löwisdff68d02004-09-10 09:20:10 +0000845 parent = default_feature, attributes=2|8)
Martin v. Löwise0f780d2004-09-01 14:51:06 +0000846 if have_tcl:
847 tcltk = Feature(db, "TclTk", "Tcl/Tk", "Tkinter, IDLE, pydoc", 5,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000848 parent = default_feature, attributes=2)
849 htmlfiles = Feature(db, "Documentation", "Documentation",
850 "Python HTMLHelp File", 7, parent = default_feature)
851 tools = Feature(db, "Tools", "Utility Scripts",
Tim Peters66cb0182004-08-26 05:23:19 +0000852 "Python utility scripts (Tools/", 9,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000853 parent = default_feature, attributes=2)
854 testsuite = Feature(db, "Testsuite", "Test suite",
855 "Python test suite (Lib/test/)", 11,
856 parent = default_feature, attributes=2|8)
Tim Peters66cb0182004-08-26 05:23:19 +0000857
Christian Heimes81ca7c72007-11-18 18:18:41 +0000858def extract_msvcr90():
Martin v. Löwisee7498e2008-02-28 23:01:33 +0000859 # Find the redistributable files
Martin v. Löwis8a2e90e2008-09-19 19:21:20 +0000860 if msilib.Win64:
861 arch = "amd64"
862 else:
863 arch = "x86"
864 dir = os.path.join(os.environ['VS90COMNTOOLS'], r"..\..\VC\redist\%s\Microsoft.VC90.CRT" % arch)
Christian Heimes81ca7c72007-11-18 18:18:41 +0000865
Christian Heimese1feb2e2008-02-28 20:52:40 +0000866 result = []
Christian Heimes81ca7c72007-11-18 18:18:41 +0000867 installer = msilib.MakeInstaller()
Christian Heimese1feb2e2008-02-28 20:52:40 +0000868 # omit msvcm90 and msvcp90, as they aren't really needed
869 files = ["Microsoft.VC90.CRT.manifest", "msvcr90.dll"]
870 for f in files:
871 path = os.path.join(dir, f)
872 kw = {'src':path}
873 if f.endswith('.dll'):
874 kw['version'] = installer.FileVersion(path, 0)
875 kw['language'] = installer.FileVersion(path, 1)
876 result.append((f, kw))
877 return result
Christian Heimes81ca7c72007-11-18 18:18:41 +0000878
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000879def generate_license():
880 import shutil, glob
881 out = open("LICENSE.txt", "w")
882 shutil.copyfileobj(open(os.path.join(srcdir, "LICENSE")), out)
Martin v. Löwisb29f2d72008-09-14 20:27:52 +0000883 shutil.copyfileobj(open("crtlicense.txt"), out)
Martin v. Löwisf38e0d02008-06-13 14:11:59 +0000884 for name, pat, file in (("bzip2","bzip2-*", "LICENSE"),
Martin v. Löwisf38e0d02008-06-13 14:11:59 +0000885 ("openssl", "openssl-*", "LICENSE"),
886 ("Tcl", "tcl8*", "license.terms"),
887 ("Tk", "tk8*", "license.terms"),
888 ("Tix", "tix-*", "license.terms")):
889 out.write("\nThis copy of Python includes a copy of %s, which is licensed under the following terms:\n\n" % name)
890 dirs = glob.glob(srcdir+"/../"+pat)
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000891 if not dirs:
Martin v. Löwisf38e0d02008-06-13 14:11:59 +0000892 raise ValueError, "Could not find "+srcdir+"/../"+pat
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000893 if len(dirs) > 2:
Martin v. Löwisf38e0d02008-06-13 14:11:59 +0000894 raise ValueError, "Multiple copies of "+pat
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000895 dir = dirs[0]
896 shutil.copyfileobj(open(os.path.join(dir, file)), out)
897 out.close()
898
899
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000900class PyDirectory(Directory):
901 """By default, all components in the Python installer
902 can run from source."""
903 def __init__(self, *args, **kw):
Georg Brandlbf82e372008-05-16 17:02:34 +0000904 if "componentflags" not in kw:
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000905 kw['componentflags'] = 2 #msidbComponentAttributesOptional
906 Directory.__init__(self, *args, **kw)
907
Martin v. Löwis797721b2010-08-03 18:35:55 +0000908 def check_unpackaged(self):
909 self.unpackaged_files.discard('__pycache__')
910 self.unpackaged_files.discard('.svn')
911 if self.unpackaged_files:
912 print "Warning: Unpackaged files in %s" % self.absolute
913 print self.unpackaged_files
914
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000915# See "File Table", "Component Table", "Directory Table",
916# "FeatureComponents Table"
917def add_files(db):
918 cab = CAB("python")
919 tmpfiles = []
920 # Add all executables, icons, text files into the TARGETDIR component
921 root = PyDirectory(db, cab, None, srcdir, "TARGETDIR", "SourceDir")
922 default_feature.set_current()
Martin v. Löwise0f780d2004-09-01 14:51:06 +0000923 if not msilib.Win64:
Christian Heimes81ca7c72007-11-18 18:18:41 +0000924 root.add_file("%s/w9xpopen.exe" % PCBUILD)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000925 root.add_file("README.txt", src="README")
926 root.add_file("NEWS.txt", src="Misc/NEWS")
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +0000927 generate_license()
928 root.add_file("LICENSE.txt", src=os.path.abspath("LICENSE.txt"))
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000929 root.start_component("python.exe", keyfile="python.exe")
Christian Heimes81ca7c72007-11-18 18:18:41 +0000930 root.add_file("%s/python.exe" % PCBUILD)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000931 root.start_component("pythonw.exe", keyfile="pythonw.exe")
Christian Heimes81ca7c72007-11-18 18:18:41 +0000932 root.add_file("%s/pythonw.exe" % PCBUILD)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000933
934 # msidbComponentAttributesSharedDllRefCount = 8, see "Component Table"
Martin v. Löwisc820eaf2008-10-17 13:47:20 +0000935 dlldir = PyDirectory(db, cab, root, srcdir, "DLLDIR", ".")
Christian Heimese1feb2e2008-02-28 20:52:40 +0000936
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000937 pydll = "python%s%s.dll" % (major, minor)
Christian Heimes81ca7c72007-11-18 18:18:41 +0000938 pydllsrc = os.path.join(srcdir, PCBUILD, pydll)
Martin v. Löwis141f41a2005-03-15 00:39:40 +0000939 dlldir.start_component("DLLDIR", flags = 8, keyfile = pydll, uuid = pythondll_uuid)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000940 installer = msilib.MakeInstaller()
941 pyversion = installer.FileVersion(pydllsrc, 0)
942 if not snapshot:
943 # For releases, the Python DLL has the same version as the
944 # installer package.
945 assert pyversion.split(".")[:3] == current_version.split(".")
Christian Heimes81ca7c72007-11-18 18:18:41 +0000946 dlldir.add_file("%s/python%s%s.dll" % (PCBUILD, major, minor),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000947 version=pyversion,
948 language=installer.FileVersion(pydllsrc, 1))
Christian Heimese1feb2e2008-02-28 20:52:40 +0000949 DLLs = PyDirectory(db, cab, root, srcdir + "/" + PCBUILD, "DLLs", "DLLS|DLLs")
Christian Heimes81ca7c72007-11-18 18:18:41 +0000950
Martin v. Löwis21c80f22008-04-07 21:14:19 +0000951 # msvcr90.dll: Need to place the DLL and the manifest into the root directory,
952 # plus another copy of the manifest in the DLLs directory, with the manifest
953 # pointing to the root directory
954 root.start_component("msvcr90", feature=private_crt)
955 # Results are ID,keyword pairs
956 manifest, crtdll = extract_msvcr90()
957 root.add_file(manifest[0], **manifest[1])
958 root.add_file(crtdll[0], **crtdll[1])
959 # Copy the manifest
Martin v. Löwis91845562008-11-06 19:46:56 +0000960 # Actually, don't do that anymore - no DLL in DLLs should have a manifest
961 # dependency on msvcr90.dll anymore, so this should not be necessary
962 #manifest_dlls = manifest[0]+".root"
963 #open(manifest_dlls, "w").write(open(manifest[1]['src']).read().replace("msvcr","../msvcr"))
964 #DLLs.start_component("msvcr90_dlls", feature=private_crt)
965 #DLLs.add_file(manifest[0], src=os.path.abspath(manifest_dlls))
Martin v. Löwis21c80f22008-04-07 21:14:19 +0000966
967 # Now start the main component for the DLLs directory;
968 # no regular files have been added to the directory yet.
969 DLLs.start_component()
Tim Peters66cb0182004-08-26 05:23:19 +0000970
Thomas Wouters89f507f2006-12-13 04:49:30 +0000971 # Check if _ctypes.pyd exists
Christian Heimes81ca7c72007-11-18 18:18:41 +0000972 have_ctypes = os.path.exists(srcdir+"/%s/_ctypes.pyd" % PCBUILD)
Thomas Wouters89f507f2006-12-13 04:49:30 +0000973 if not have_ctypes:
Collin Winter6afaeb72007-08-03 17:06:41 +0000974 print("WARNING: _ctypes.pyd not found, ctypes will not be included")
Thomas Wouters89f507f2006-12-13 04:49:30 +0000975 extensions.remove("_ctypes.pyd")
976
Georg Brandl6e47a332008-05-17 19:15:58 +0000977 # Add all .py files in Lib, except tkinter, test
Martin v. Löwis797721b2010-08-03 18:35:55 +0000978 dirs = []
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000979 pydirs = [(root,"Lib")]
980 while pydirs:
Martin v. Löwis94b8b822008-06-13 19:00:35 +0000981 # Commit every now and then, or else installer will complain
982 db.Commit()
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000983 parent, dir = pydirs.pop()
Martin v. Löwis797721b2010-08-03 18:35:55 +0000984 if dir == ".svn" or dir == '__pycache__' or dir.startswith("plat-"):
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000985 continue
Georg Brandl6e47a332008-05-17 19:15:58 +0000986 elif dir in ["tkinter", "idlelib", "Icons"]:
Martin v. Löwise0f780d2004-09-01 14:51:06 +0000987 if not have_tcl:
988 continue
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000989 tcltk.set_current()
Martin v. Löwis5c9e55e2004-12-30 14:08:18 +0000990 elif dir in ['test', 'tests', 'data', 'output']:
Amaury Forgeot d'Arcf7bfcfb2008-09-09 06:42:00 +0000991 # test: Lib, Lib/email, Lib/ctypes, Lib/sqlite3
Martin v. Löwis5c9e55e2004-12-30 14:08:18 +0000992 # tests: Lib/distutils
993 # data: Lib/email/test
994 # output: Lib/test
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000995 testsuite.set_current()
Thomas Wouters89f507f2006-12-13 04:49:30 +0000996 elif not have_ctypes and dir == "ctypes":
997 continue
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +0000998 else:
999 default_feature.set_current()
1000 lib = PyDirectory(db, cab, parent, dir, dir, "%s|%s" % (parent.make_short(dir), dir))
1001 # Add additional files
Martin v. Löwis797721b2010-08-03 18:35:55 +00001002 dirs.append(lib)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001003 lib.glob("*.txt")
1004 if dir=='site-packages':
Martin v. Löwis6d60c092004-11-21 10:16:26 +00001005 lib.add_file("README.txt", src="README")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001006 continue
1007 files = lib.glob("*.py")
1008 files += lib.glob("*.pyw")
1009 if files:
1010 # Add an entry to the RemoveFile table to remove bytecode files.
1011 lib.remove_pyc()
Martin v. Löwis797721b2010-08-03 18:35:55 +00001012 # package READMEs if present
1013 lib.glob("README")
Vinay Sajip4334d742011-07-03 10:35:41 +01001014 if dir=='Lib':
1015 lib.add_file("sysconfig.cfg")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001016 if dir=='test' and parent.physical=='Lib':
1017 lib.add_file("185test.db")
1018 lib.add_file("audiotest.au")
Thomas Wouters89f507f2006-12-13 04:49:30 +00001019 lib.add_file("sgml_input.html")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001020 lib.add_file("testtar.tar")
Martin v. Löwis7d3755d2004-09-06 06:31:12 +00001021 lib.add_file("test_difflib_expect.html")
Thomas Wouters49fd7fa2006-04-21 10:40:58 +00001022 lib.add_file("check_soundcard.vbs")
1023 lib.add_file("empty.vbs")
Martin v. Löwisbb6db342009-06-01 04:12:01 +00001024 lib.add_file("Sine-1000Hz-300ms.aif")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001025 lib.glob("*.uue")
Christian Heimes5d14c2b2007-11-20 23:38:09 +00001026 lib.glob("*.pem")
Christian Heimescbf3b5c2007-12-03 21:02:03 +00001027 lib.glob("*.pck")
Martin v. Löwis797721b2010-08-03 18:35:55 +00001028 lib.glob("cfgparser.*")
Martin v. Löwis678fa9f2011-01-15 19:43:18 +00001029 lib.add_file("zip_cp437_header.zip")
Martin v. Löwis270a9ce2009-04-04 18:48:39 +00001030 lib.add_file("zipdir.zip")
Martin v. Löwis797721b2010-08-03 18:35:55 +00001031 if dir=='capath':
1032 lib.glob("*.0")
Georg Brandl8708e382010-08-01 09:17:53 +00001033 if dir=='tests' and parent.physical=='distutils':
1034 lib.add_file("Setup.sample")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001035 if dir=='decimaltestdata':
1036 lib.glob("*.decTest")
Florent Xiclunaf15351d2010-03-13 23:24:31 +00001037 if dir=='xmltestdata':
1038 lib.glob("*.xml")
1039 lib.add_file("test.xml.out")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001040 if dir=='output':
1041 lib.glob("test_*")
Martin v. Löwis797721b2010-08-03 18:35:55 +00001042 if dir=='sndhdrdata':
1043 lib.glob("sndhdr.*")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001044 if dir=='idlelib':
1045 lib.glob("*.def")
1046 lib.add_file("idle.bat")
Martin v. Löwis797721b2010-08-03 18:35:55 +00001047 lib.add_file("ChangeLog")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001048 if dir=="Icons":
1049 lib.glob("*.gif")
1050 lib.add_file("idle.icns")
Vinay Sajip4334d742011-07-03 10:35:41 +01001051 if dir=="command" and parent.physical in ("distutils", "packaging"):
Martin v. Löwis5680d0c2008-04-10 03:06:53 +00001052 lib.glob("wininst*.exe")
Martin v. Löwis797721b2010-08-03 18:35:55 +00001053 lib.add_file("command_template")
Martin v. Löwis90cc5ab2008-06-02 10:04:16 +00001054 if dir=="lib2to3":
1055 lib.removefile("pickle", "*.pickle")
Martin v. Löwis797721b2010-08-03 18:35:55 +00001056 if dir=="macholib":
1057 lib.add_file("README.ctypes")
1058 lib.glob("fetch_macholib*")
Martin v. Löwisd53ee5d2010-12-05 23:07:58 +00001059 if dir=='turtledemo':
1060 lib.add_file("turtle.cfg")
1061 if dir=="pydoc_data":
1062 lib.add_file("_pydoc.css")
R David Murray6a738452011-06-18 11:45:59 -04001063 if dir=="data" and parent.physical=="test_email":
Martin v. Löwis9ca9f562006-01-03 06:29:53 +00001064 # This should contain all non-.svn files listed in subversion
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001065 for f in os.listdir(lib.absolute):
Martin v. Löwis9ca9f562006-01-03 06:29:53 +00001066 if f.endswith(".txt") or f==".svn":continue
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001067 if f.endswith(".au") or f.endswith(".gif"):
1068 lib.add_file(f)
1069 else:
R David Murray6a738452011-06-18 11:45:59 -04001070 print("WARNING: New file %s in test/test_email/data" % f)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001071 for f in os.listdir(lib.absolute):
1072 if os.path.isdir(os.path.join(lib.absolute, f)):
1073 pydirs.append((lib, f))
Martin v. Löwis797721b2010-08-03 18:35:55 +00001074 for d in dirs:
1075 d.check_unpackaged()
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001076 # Add DLLs
1077 default_feature.set_current()
Christian Heimese1feb2e2008-02-28 20:52:40 +00001078 lib = DLLs
Christian Heimesd9a4d1d2008-01-01 14:42:15 +00001079 lib.add_file("py.ico", src=srcdir+"/PC/py.ico")
1080 lib.add_file("pyc.ico", src=srcdir+"/PC/pyc.ico")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001081 dlls = []
1082 tclfiles = []
1083 for f in extensions:
1084 if f=="_tkinter.pyd":
1085 continue
Christian Heimes81ca7c72007-11-18 18:18:41 +00001086 if not os.path.exists(srcdir + "/" + PCBUILD + "/" + f):
Collin Winter6afaeb72007-08-03 17:06:41 +00001087 print("WARNING: Missing extension", f)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001088 continue
1089 dlls.append(f)
1090 lib.add_file(f)
Martin v. Löwisd53ee5d2010-12-05 23:07:58 +00001091 lib.add_file('python3.dll')
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001092 # Add sqlite
1093 if msilib.msi_type=="Intel64;1033":
1094 sqlite_arch = "/ia64"
1095 elif msilib.msi_type=="x64;1033":
1096 sqlite_arch = "/amd64"
Martin v. Löwis20c892d2008-02-29 21:03:38 +00001097 tclsuffix = "64"
Thomas Wouters0e3f5912006-08-11 14:57:12 +00001098 else:
1099 sqlite_arch = ""
Martin v. Löwis20c892d2008-02-29 21:03:38 +00001100 tclsuffix = ""
Martin v. Löwis94b8b822008-06-13 19:00:35 +00001101 lib.add_file("sqlite3.dll")
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001102 if have_tcl:
Christian Heimes81ca7c72007-11-18 18:18:41 +00001103 if not os.path.exists("%s/%s/_tkinter.pyd" % (srcdir, PCBUILD)):
Collin Winter6afaeb72007-08-03 17:06:41 +00001104 print("WARNING: Missing _tkinter.pyd")
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001105 else:
1106 lib.start_component("TkDLLs", tcltk)
1107 lib.add_file("_tkinter.pyd")
1108 dlls.append("_tkinter.pyd")
Martin v. Löwis20c892d2008-02-29 21:03:38 +00001109 tcldir = os.path.normpath(srcdir+("/../tcltk%s/bin" % tclsuffix))
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001110 for f in glob.glob1(tcldir, "*.dll"):
1111 lib.add_file(f, src=os.path.join(tcldir, f))
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001112 # check whether there are any unknown extensions
Christian Heimes81ca7c72007-11-18 18:18:41 +00001113 for f in glob.glob1(srcdir+"/"+PCBUILD, "*.pyd"):
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001114 if f.endswith("_d.pyd"): continue # debug version
1115 if f in dlls: continue
Collin Winter6afaeb72007-08-03 17:06:41 +00001116 print("WARNING: Unknown extension", f)
Tim Peters66cb0182004-08-26 05:23:19 +00001117
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001118 # Add headers
1119 default_feature.set_current()
1120 lib = PyDirectory(db, cab, root, "include", "include", "INCLUDE|include")
1121 lib.glob("*.h")
1122 lib.add_file("pyconfig.h", src="../PC/pyconfig.h")
1123 # Add import libraries
Christian Heimes81ca7c72007-11-18 18:18:41 +00001124 lib = PyDirectory(db, cab, root, PCBUILD, "libs", "LIBS|libs")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001125 for f in dlls:
1126 lib.add_file(f.replace('pyd','lib'))
1127 lib.add_file('python%s%s.lib' % (major, minor))
Martin v. Löwisd53ee5d2010-12-05 23:07:58 +00001128 lib.add_file('python3.lib')
Martin v. Löwis9fda9312004-12-22 13:41:49 +00001129 # Add the mingw-format library
1130 if have_mingw:
Tim Peters5a9fb3c2005-01-07 16:01:32 +00001131 lib.add_file('libpython%s%s.a' % (major, minor))
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001132 if have_tcl:
1133 # Add Tcl/Tk
Martin v. Löwis20c892d2008-02-29 21:03:38 +00001134 tcldirs = [(root, '../tcltk%s/lib' % tclsuffix, 'tcl')]
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001135 tcltk.set_current()
1136 while tcldirs:
1137 parent, phys, dir = tcldirs.pop()
1138 lib = PyDirectory(db, cab, parent, phys, dir, "%s|%s" % (parent.make_short(dir), dir))
1139 if not os.path.exists(lib.absolute):
1140 continue
1141 for f in os.listdir(lib.absolute):
1142 if os.path.isdir(os.path.join(lib.absolute, f)):
1143 tcldirs.append((lib, f, f))
1144 else:
1145 lib.add_file(f)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001146 # Add tools
1147 tools.set_current()
1148 tooldir = PyDirectory(db, cab, root, "Tools", "Tools", "TOOLS|Tools")
Martin v. Löwisa6207482010-08-28 13:40:10 +00001149 for f in ['i18n', 'pynche', 'Scripts']:
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001150 lib = PyDirectory(db, cab, tooldir, f, f, "%s|%s" % (tooldir.make_short(f), f))
1151 lib.glob("*.py")
1152 lib.glob("*.pyw", exclude=['pydocgui.pyw'])
1153 lib.remove_pyc()
1154 lib.glob("*.txt")
1155 if f == "pynche":
1156 x = PyDirectory(db, cab, lib, "X", "X", "X|X")
1157 x.glob("*.txt")
Martin v. Löwis4d930be2004-12-01 21:46:35 +00001158 if os.path.exists(os.path.join(lib.absolute, "README")):
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001159 lib.add_file("README.txt", src="README")
Martin v. Löwis4d930be2004-12-01 21:46:35 +00001160 if f == 'Scripts':
Martin v. Löwisfe218842008-10-01 11:22:32 +00001161 lib.add_file("2to3.py", src="2to3")
Vinay Sajip4334d742011-07-03 10:35:41 +01001162 lib.add_file("pydoc3.py", src="pydoc3")
1163 lib.add_file("pysetup3.py", src="pysetup3")
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001164 if have_tcl:
1165 lib.start_component("pydocgui.pyw", tcltk, keyfile="pydocgui.pyw")
1166 lib.add_file("pydocgui.pyw")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001167 # Add documentation
1168 htmlfiles.set_current()
1169 lib = PyDirectory(db, cab, root, "Doc", "Doc", "DOC|Doc")
Alexandre Vassalotti6461e102008-05-15 22:09:29 +00001170 lib.start_component("documentation", keyfile=docfile)
1171 lib.add_file(docfile, src="build/htmlhelp/"+docfile)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001172
1173 cab.commit(db)
1174
1175 for f in tmpfiles:
1176 os.unlink(f)
1177
1178# See "Registry Table", "Component Table"
1179def add_registry(db):
1180 # File extensions, associated with the REGISTRY.def component
1181 # IDLE verbs depend on the tcltk feature.
1182 # msidbComponentAttributesRegistryKeyPath = 4
1183 # -1 for Root specifies "dependent on ALLUSERS property"
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001184 tcldata = []
1185 if have_tcl:
1186 tcldata = [
Martin v. Löwis283e35f2007-08-31 09:59:29 +00001187 ("REGISTRY.tcl", msilib.gen_uuid(), "TARGETDIR", registry_component, None,
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001188 "py.IDLE")]
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001189 add_data(db, "Component",
1190 # msidbComponentAttributesRegistryKeyPath = 4
Martin v. Löwis283e35f2007-08-31 09:59:29 +00001191 [("REGISTRY", msilib.gen_uuid(), "TARGETDIR", registry_component, None,
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001192 "InstallPath"),
Martin v. Löwis283e35f2007-08-31 09:59:29 +00001193 ("REGISTRY.doc", msilib.gen_uuid(), "TARGETDIR", registry_component, None,
Martin v. Löwis141f41a2005-03-15 00:39:40 +00001194 "Documentation"),
Martin v. Löwis283e35f2007-08-31 09:59:29 +00001195 ("REGISTRY.def", msilib.gen_uuid(), "TARGETDIR", registry_component,
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001196 None, None)] + tcldata)
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001197 # See "FeatureComponents Table".
1198 # The association between TclTk and pythonw.exe is necessary to make ICE59
1199 # happy, because the installer otherwise believes that the IDLE and PyDoc
1200 # shortcuts might get installed without pythonw.exe being install. This
1201 # is not true, since installing TclTk will install the default feature, which
1202 # will cause pythonw.exe to be installed.
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001203 # REGISTRY.tcl is not associated with any feature, as it will be requested
1204 # through a custom action
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001205 tcldata = []
1206 if have_tcl:
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001207 tcldata = [(tcltk.id, "pythonw.exe")]
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001208 add_data(db, "FeatureComponents",
1209 [(default_feature.id, "REGISTRY"),
Martin v. Löwis141f41a2005-03-15 00:39:40 +00001210 (htmlfiles.id, "REGISTRY.doc"),
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001211 (ext_feature.id, "REGISTRY.def")] +
1212 tcldata
1213 )
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001214 # Extensions are not advertised. For advertised extensions,
1215 # we would need separate binaries that install along with the
1216 # extension.
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001217 pat = r"Software\Classes\%sPython.%sFile\shell\%s\command"
1218 ewi = "Edit with IDLE"
1219 pat2 = r"Software\Classes\%sPython.%sFile\DefaultIcon"
1220 pat3 = r"Software\Classes\%sPython.%sFile"
Martin v. Löwisbfda5442008-11-07 18:54:51 +00001221 pat4 = r"Software\Classes\%sPython.%sFile\shellex\DropHandler"
Martin v. Löwiseac02e62004-11-18 08:00:33 +00001222 tcl_verbs = []
1223 if have_tcl:
1224 tcl_verbs=[
1225 ("py.IDLE", -1, pat % (testprefix, "", ewi), "",
Martin v. Löwis8482ef92009-05-05 16:14:30 +00001226 r'"[TARGETDIR]pythonw.exe" "[TARGETDIR]Lib\idlelib\idle.pyw" -e "%1"',
Martin v. Löwiseac02e62004-11-18 08:00:33 +00001227 "REGISTRY.tcl"),
1228 ("pyw.IDLE", -1, pat % (testprefix, "NoCon", ewi), "",
Martin v. Löwis8482ef92009-05-05 16:14:30 +00001229 r'"[TARGETDIR]pythonw.exe" "[TARGETDIR]Lib\idlelib\idle.pyw" -e "%1"',
Martin v. Löwiseac02e62004-11-18 08:00:33 +00001230 "REGISTRY.tcl"),
1231 ]
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001232 add_data(db, "Registry",
1233 [# Extensions
1234 ("py.ext", -1, r"Software\Classes\."+ext, "",
1235 "Python.File", "REGISTRY.def"),
1236 ("pyw.ext", -1, r"Software\Classes\."+ext+'w', "",
1237 "Python.NoConFile", "REGISTRY.def"),
1238 ("pyc.ext", -1, r"Software\Classes\."+ext+'c', "",
1239 "Python.CompiledFile", "REGISTRY.def"),
1240 ("pyo.ext", -1, r"Software\Classes\."+ext+'o', "",
1241 "Python.CompiledFile", "REGISTRY.def"),
1242 # MIME types
1243 ("py.mime", -1, r"Software\Classes\."+ext, "Content Type",
1244 "text/plain", "REGISTRY.def"),
1245 ("pyw.mime", -1, r"Software\Classes\."+ext+'w', "Content Type",
1246 "text/plain", "REGISTRY.def"),
1247 #Verbs
1248 ("py.open", -1, pat % (testprefix, "", "open"), "",
1249 r'"[TARGETDIR]python.exe" "%1" %*', "REGISTRY.def"),
1250 ("pyw.open", -1, pat % (testprefix, "NoCon", "open"), "",
1251 r'"[TARGETDIR]pythonw.exe" "%1" %*', "REGISTRY.def"),
1252 ("pyc.open", -1, pat % (testprefix, "Compiled", "open"), "",
1253 r'"[TARGETDIR]python.exe" "%1" %*', "REGISTRY.def"),
Martin v. Löwiseac02e62004-11-18 08:00:33 +00001254 ] + tcl_verbs + [
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001255 #Icons
1256 ("py.icon", -1, pat2 % (testprefix, ""), "",
Thomas Wouters477c8d52006-05-27 19:21:47 +00001257 r'[DLLs]py.ico', "REGISTRY.def"),
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001258 ("pyw.icon", -1, pat2 % (testprefix, "NoCon"), "",
Thomas Wouters477c8d52006-05-27 19:21:47 +00001259 r'[DLLs]py.ico', "REGISTRY.def"),
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001260 ("pyc.icon", -1, pat2 % (testprefix, "Compiled"), "",
Thomas Wouters477c8d52006-05-27 19:21:47 +00001261 r'[DLLs]pyc.ico', "REGISTRY.def"),
Martin v. Löwisdff68d02004-09-10 09:20:10 +00001262 # Descriptions
1263 ("py.txt", -1, pat3 % (testprefix, ""), "",
1264 "Python File", "REGISTRY.def"),
1265 ("pyw.txt", -1, pat3 % (testprefix, "NoCon"), "",
1266 "Python File (no console)", "REGISTRY.def"),
1267 ("pyc.txt", -1, pat3 % (testprefix, "Compiled"), "",
1268 "Compiled Python File", "REGISTRY.def"),
Martin v. Löwisbfda5442008-11-07 18:54:51 +00001269 # Drop Handler
1270 ("py.drop", -1, pat4 % (testprefix, ""), "",
1271 "{60254CA5-953B-11CF-8C96-00AA00B8708C}", "REGISTRY.def"),
1272 ("pyw.drop", -1, pat4 % (testprefix, "NoCon"), "",
1273 "{60254CA5-953B-11CF-8C96-00AA00B8708C}", "REGISTRY.def"),
1274 ("pyc.drop", -1, pat4 % (testprefix, "Compiled"), "",
1275 "{60254CA5-953B-11CF-8C96-00AA00B8708C}", "REGISTRY.def"),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001276 ])
Tim Peters66cb0182004-08-26 05:23:19 +00001277
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001278 # Registry keys
1279 prefix = r"Software\%sPython\PythonCore\%s" % (testprefix, short_version)
1280 add_data(db, "Registry",
1281 [("InstallPath", -1, prefix+r"\InstallPath", "", "[TARGETDIR]", "REGISTRY"),
1282 ("InstallGroup", -1, prefix+r"\InstallPath\InstallGroup", "",
1283 "Python %s" % short_version, "REGISTRY"),
1284 ("PythonPath", -1, prefix+r"\PythonPath", "",
Georg Brandl6e47a332008-05-17 19:15:58 +00001285 r"[TARGETDIR]Lib;[TARGETDIR]DLLs", "REGISTRY"),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001286 ("Documentation", -1, prefix+r"\Help\Main Python Documentation", "",
Alexandre Vassalotti6461e102008-05-15 22:09:29 +00001287 "[TARGETDIR]Doc\\"+docfile , "REGISTRY.doc"),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001288 ("Modules", -1, prefix+r"\Modules", "+", None, "REGISTRY"),
1289 ("AppPaths", -1, r"Software\Microsoft\Windows\CurrentVersion\App Paths\Python.exe",
Martin v. Löwis45a6b9f2008-11-30 11:12:00 +00001290 "", r"[TARGETDIR]Python.exe", "REGISTRY.def"),
1291 ("DisplayIcon", -1,
1292 r"Software\Microsoft\Windows\CurrentVersion\Uninstall\%s" % product_code,
Martin v. Löwis95c46012009-06-28 09:36:14 +00001293 "DisplayIcon", "[TARGETDIR]python.exe", "REGISTRY")
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001294 ])
1295 # Shortcuts, see "Shortcut Table"
1296 add_data(db, "Directory",
1297 [("ProgramMenuFolder", "TARGETDIR", "."),
1298 ("MenuDir", "ProgramMenuFolder", "PY%s%s|%sPython %s.%s" % (major,minor,testprefix,major,minor))])
1299 add_data(db, "RemoveFile",
1300 [("MenuDir", "TARGETDIR", None, "MenuDir", 2)])
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001301 tcltkshortcuts = []
1302 if have_tcl:
1303 tcltkshortcuts = [
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001304 ("IDLE", "MenuDir", "IDLE|IDLE (Python GUI)", "pythonw.exe",
Martin v. Löwisac191da2004-12-22 12:55:44 +00001305 tcltk.id, r'"[TARGETDIR]Lib\idlelib\idle.pyw"', None, None, "python_icon.exe", 0, None, "TARGETDIR"),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001306 ("PyDoc", "MenuDir", "MODDOCS|Module Docs", "pythonw.exe",
Martin v. Löwisac191da2004-12-22 12:55:44 +00001307 tcltk.id, r'"[TARGETDIR]Tools\scripts\pydocgui.pyw"', None, None, "python_icon.exe", 0, None, "TARGETDIR"),
Martin v. Löwise0f780d2004-09-01 14:51:06 +00001308 ]
1309 add_data(db, "Shortcut",
1310 tcltkshortcuts +
1311 [# Advertised shortcuts: targets are features, not files
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001312 ("Python", "MenuDir", "PYTHON|Python (command line)", "python.exe",
1313 default_feature.id, None, None, None, "python_icon.exe", 2, None, "TARGETDIR"),
Martin v. Löwis141f41a2005-03-15 00:39:40 +00001314 # Advertising the Manual breaks on (some?) Win98, and the shortcut lacks an
1315 # icon first.
1316 #("Manual", "MenuDir", "MANUAL|Python Manuals", "documentation",
1317 # htmlfiles.id, None, None, None, None, None, None, None),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001318 ## Non-advertised shortcuts: must be associated with a registry component
Martin v. Löwis141f41a2005-03-15 00:39:40 +00001319 ("Manual", "MenuDir", "MANUAL|Python Manuals", "REGISTRY.doc",
Alexandre Vassalotti6461e102008-05-15 22:09:29 +00001320 "[#%s]" % docfile, None,
Martin v. Löwis141f41a2005-03-15 00:39:40 +00001321 None, None, None, None, None, None),
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001322 ("Uninstall", "MenuDir", "UNINST|Uninstall Python", "REGISTRY",
1323 SystemFolderName+"msiexec", "/x%s" % product_code,
1324 None, None, None, None, None, None),
1325 ])
1326 db.Commit()
1327
Martin v. Löwisa5e31092010-09-04 14:38:09 +00001328def build_pdbzip():
1329 pdbexclude = ['kill_python.pdb', 'make_buildinfo.pdb',
1330 'make_versioninfo.pdb']
1331 path = "python-%s%s-pdb.zip" % (full_current_version, msilib.arch_ext)
1332 pdbzip = zipfile.ZipFile(path, 'w')
1333 for f in glob.glob1(os.path.join(srcdir, PCBUILD), "*.pdb"):
1334 if f not in pdbexclude and not f.endswith('_d.pdb'):
1335 pdbzip.write(os.path.join(srcdir, PCBUILD, f), f)
1336 pdbzip.close()
1337
Martin v. Löwis0077b652010-03-16 18:53:33 +00001338db,msiname = build_database()
Martin v. Löwis8ffe9ab2004-08-22 13:34:34 +00001339try:
1340 add_features(db)
1341 add_ui(db)
1342 add_files(db)
1343 add_registry(db)
1344 remove_old_versions(db)
1345 db.Commit()
1346finally:
1347 del db
Martin v. Löwis0077b652010-03-16 18:53:33 +00001348
1349# Merge CRT into MSI file. This requires the database to be closed.
1350mod_dir = os.path.join(os.environ["ProgramFiles"], "Common Files", "Merge Modules")
1351if msilib.Win64:
1352 modules = ["Microsoft_VC90_CRT_x86_x64.msm", "policy_9_0_Microsoft_VC90_CRT_x86_x64.msm"]
1353else:
1354 modules = ["Microsoft_VC90_CRT_x86.msm","policy_9_0_Microsoft_VC90_CRT_x86.msm"]
1355
1356for i, n in enumerate(modules):
1357 modules[i] = os.path.join(mod_dir, n)
1358
1359def merge(msi, feature, rootdir, modules):
1360 cab_and_filecount = []
1361 # Step 1: Merge databases, extract cabfiles
1362 m = msilib.MakeMerge2()
1363 m.OpenLog("merge.log")
1364 m.OpenDatabase(msi)
1365 for module in modules:
1366 print module
1367 m.OpenModule(module,0)
1368 m.Merge(feature, rootdir)
1369 print "Errors:"
1370 for e in m.Errors:
1371 print e.Type, e.ModuleTable, e.DatabaseTable
1372 print " Modkeys:",
1373 for s in e.ModuleKeys: print s,
1374 print
1375 print " DBKeys:",
1376 for s in e.DatabaseKeys: print s,
1377 print
1378 cabname = tempfile.mktemp(suffix=".cab")
1379 m.ExtractCAB(cabname)
1380 cab_and_filecount.append((cabname, len(m.ModuleFiles)))
1381 m.CloseModule()
1382 m.CloseDatabase(True)
1383 m.CloseLog()
1384
1385 # Step 2: Add CAB files
1386 i = msilib.MakeInstaller()
1387 db = i.OpenDatabase(msi, constants.msiOpenDatabaseModeTransact)
1388
1389 v = db.OpenView("SELECT LastSequence FROM Media")
1390 v.Execute(None)
1391 maxmedia = -1
1392 while 1:
1393 r = v.Fetch()
1394 if not r: break
1395 seq = r.IntegerData(1)
1396 if seq > maxmedia:
1397 maxmedia = seq
1398 print "Start of Media", maxmedia
1399
1400 for cabname, count in cab_and_filecount:
1401 stream = "merged%d" % maxmedia
1402 msilib.add_data(db, "Media",
1403 [(maxmedia+1, maxmedia+count, None, "#"+stream, None, None)])
1404 msilib.add_stream(db, stream, cabname)
1405 os.unlink(cabname)
1406 maxmedia += count
1407 # The merge module sets ALLUSERS to 1 in the property table.
1408 # This is undesired; delete that
1409 v = db.OpenView("DELETE FROM Property WHERE Property='ALLUSERS'")
1410 v.Execute(None)
1411 v.Close()
1412 db.Commit()
1413
1414merge(msiname, "SharedCRT", "TARGETDIR", modules)
1415
1416# certname (from config.py) should be (a substring of)
1417# the certificate subject, e.g. "Python Software Foundation"
1418if certname:
1419 os.system('signtool sign /n "%s" /t http://timestamp.verisign.com/scripts/timestamp.dll %s' % (certname, msiname))
Martin v. Löwisa5e31092010-09-04 14:38:09 +00001420
1421if pdbzip:
1422 build_pdbzip()