From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "struct" |
|---|
| subject | "Format:PYC (Python compiled bytecode)" |
|---|
| claim | "Header of a hash-based pyc (PEP 552) in Python 3.7+: 16 bytes, magic, flags with bit 0 set (bit 1 = check the source), then the 8-byte SipHash of the source instead of mtime and size. Flag bits other than 0 and 1 are rejected with ImportError 'invalid flags'." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:PYC (Python compiled bytecode)" |
|---|
| observed_in | |
|---|
|
|---|
| data | | name | "pyc_header_hash" |
|---|
| size | 16 |
|---|
| alignment | 4 |
|---|
| fields | | offset | "0x0" |
|---|
| size | 2 |
|---|
| type | "uint16_t" |
|---|
| name | "magic" |
|---|
|
| offset | "0x2" |
|---|
| size | 2 |
|---|
| type | "uint8_t[2]" |
|---|
| name | "crlf" |
|---|
| notes | "always 0D 0A" |
|---|
|
| offset | "0x4" |
|---|
| size | 4 |
|---|
| type | "uint32_t" |
|---|
| name | "flags" |
|---|
| bits | | bit | "0" |
|---|
| name | "hash_based" |
|---|
| notes | "1 = bytes 8-15 are a source hash" |
|---|
|
| bit | "1" |
|---|
| name | "check_source" |
|---|
| notes | "1 = CHECKED_HASH (rehash the .py on import); 0 = UNCHECKED_HASH (never look at the source)" |
|---|
|
|
|---|
|
| offset | "0x8" |
|---|
| size | 8 |
|---|
| type | "uint8_t[8]" |
|---|
| name | "source_hash" |
|---|
| notes | "importlib.util.source_hash(source bytes), little endian" |
|---|
|
|
|---|
| endianness | "little" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "_classify_pyc rejects flags & ~0b11 ('invalid flags')" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "Lib/importlib/_bootstrap_external.py" |
|---|
| lines | "416-446" |
|---|
|
| type | "source" |
|---|
| detail | "_validate_hash_pyc compares data[8:16] with the source hash" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "Lib/importlib/_bootstrap_external.py" |
|---|
| lines | "477-495" |
|---|
|
| type | "source" |
|---|
| detail | "_code_to_hash_pyc writes flags = 0b1 | checked << 1" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "Lib/importlib/_bootstrap_external.py" |
|---|
| lines | "524-532" |
|---|
|
| type | "runtime_test" |
|---|
| detail | "py_compile CHECKED_HASH gives flags 03 00 00 00 and UNCHECKED_HASH 01 00 00 00 on 3.11.15 and 3.12.8, with bytes 8-15 equal to importlib.util.source_hash" |
|---|
|
| type | "source" |
|---|
| detail | "_pack_uint32 and _unpack_uint32 use to_bytes/from_bytes(..., 'little'); MAGIC_NUMBER also 'little'" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "Lib/importlib/_bootstrap_external.py" |
|---|
| lines | "82-100, 227" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "pyc_header_hash (3.7+)" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-17T05:12:29.403Z" |
|---|
| verifications | |
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T12:52:45.996Z" |
|---|
| summary | "Byte order set: importlib packs/unpacks the pyc fields as little-endian" |
|---|
| changed | |
|---|
|
|
|---|