From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Format:Python zipapp" |
|---|
| claim | "zipapp.create_archive writes '#!' + interpreter + newline before the ZIP data (only if an interpreter is given). For a directory source it stores the files plus a __main__.py (generated from -m module:fn as 'import module' / 'module.fn()', only when the directory has no __main__.py of its own, else ZipAppError) and uses ZIP_STORED unless compressed=True; for an existing archive source it copies the bytes after dropping any old shebang line and ignores main/compressed. get_interpreter() recognises a shebang by the first two bytes '#!'." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:Python zipapp" |
|---|
| observed_in | |
|---|
|
|---|
| data | | effect | "zip with optional shebang prefix" |
|---|
| trigger | "python -m zipapp" |
|---|
| condition | "directory source: __main__.py generated only if -m is given and none exists; archive source: only the shebang line changes" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "MAIN_TEMPLATE, _write_file_prefix writes b'#!' + interpreter + b'\n', compression selection ZIP_DEFLATED if compressed else ZIP_STORED, get_interpreter reads b'#!'" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "7dbc7975db8e34db8be8e4a10bd10784ab49b07a" |
|---|
| path | "Lib/zipapp.py" |
|---|
| lines | "12-30, 46-51, 160-180" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Shebang prefix and __main__.py" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T22:49:38.849Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T07:34:48.340Z" |
|---|
| result | "confirmed" |
|---|
| method | "Fetched Lib/zipapp.py at cpython 7dbc7975db8e and read all of it: _write_file_prefix, _copy_archive (drops old shebang, copies the rest), create_archive (ZipAppError for main+__main__.py and for no entry point, ZIP_STORED unless compressed, MAIN_TEMPLATE), get_interpreter. The CLI additionally refuses --main when copying an archive; the library function ignores main for an archive source as stated." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T04:02:36.755Z" |
|---|
| summary | "Added the two source cases: only a directory source is zipped (ZIP_STORED/DEFLATED and generated __main__.py apply there); an existing archive source is copied byte for byte with the shebang line…" |
|---|
| changed | |
|---|
|
|
|---|