Debian Codegraph @

Lib/test/archivetestdata/README.md

raw
1 # Test data for `test_zipfile`, `test_tarfile` (and even some others)
2
3 ## `test_zipfile`
4
5 The test executables in this directory are created manually from `header.sh` and
6 the `testdata_module_inside_zip.py` file. You must have Info-ZIP's zip utility
7 installed (`apt install zip` on Debian).
8
9 ### Purpose of `exe_with_zip` and `exe_with_z64`
10
11 These are used to test executable files with an appended zipfile, in a scenario
12 where the executable is _not_ a Python interpreter itself so our automatic
13 zipimport machinery (that'd look for `__main__.py`) is not being used.
14
15 ### Updating the test executables
16
17 If you update header.sh or the testdata_module_inside_zip.py file, rerun the
18 commands below. These are expected to be rarely changed, if ever.
19
20 #### Standard old format (2.0) zip file
21
22 ```
23 zip -0 zip2.zip testdata_module_inside_zip.py
24 cat header.sh zip2.zip >exe_with_zip
25 rm zip2.zip
26 ```
27
28 #### Modern format (4.5) zip64 file
29
30 Redirecting from stdin forces Info-ZIP's zip tool to create a zip64.
31
32 ```
33 zip -0 <testdata_module_inside_zip.py >zip64.zip
34 cat header.sh zip64.zip >exe_with_z64
35 rm zip64.zip
36 ```