From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Format:Marshal (Python)" |
|---|
| claim | "co_linetable of CPython 3.11+ is a list of entries; each first byte has bit 7 set, bits 3-6 a code and bits 0-2 the length - 1 in 2-byte code units. Codes 0-9: short form, same line, one more byte, column = code*8 + bits 4-6, end column = column + bits 0-3. 10-12: line += code - 10, then start and end column bytes. 13: line += svarint, no columns. 14: line += svarint, end line = line + varint, then column + 1 and end column + 1 as varints (0 = unknown). 15: no location. Lines start from co_firstlineno; varints are 6-bit chunks least significant first with bit 6 = more, svarint has the sign in bit 0." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "Format:Marshal (Python)" |
|---|
| observed_in | |
|---|
|
|---|
| data | | effect | "per code unit (line, end line, column, end column), as returned by code.co_positions()" |
|---|
| condition | "CPython 3.11 and later (3.10 uses the PEP 626 byte-pair table)" |
|---|
| test_vectors | | input | "linetable 80 00 with co_firstlineno 2" |
|---|
| expected | "1 code unit at (2, 2, 0, 0)" |
|---|
|
| input | "next entry F0 02 03 05 14" |
|---|
| expected | "long form, 1 unit: line 3, end line 6, column 4, end column 19" |
|---|
|
|
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "read_varint (LSB first) and read_signed_varint" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "Objects/codeobject.c" |
|---|
| lines | "1133-1157" |
|---|
|
| type | "source" |
|---|
| detail | "advance_with_locations: the five forms; long form columns are read_varint() - 1" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "Objects/codeobject.c" |
|---|
| lines | "1199-1250" |
|---|
|
| type | "documentation" |
|---|
| detail | "Format of the locations table (does not mention the +1 on long-form columns; its encode_varint example clears bit 6 and returns 08 03 for 200, not the 48 03 the text gives)" |
|---|
| repo | "https://github.com/python/cpython" |
|---|
| commit | "010bebbf9fd12bba1e3f40bdbddacd51a9c2bf20" |
|---|
| path | "InternalDocs/code_objects.md" |
|---|
| lines | "67-170" |
|---|
|
| type | "runtime_test" |
|---|
| detail | "An independent decoder reproduces co_positions() for every code unit of every code object in the stdlib pycs of CPython 3.11.15 (24804 code objects, 2.6 M units) and 3.12.8 (285567 code objects, 44 M units); vectors from def f(x) in 3.12.8" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Location table encoding (3.11+)" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-17T05:22:09.117Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T09:29:00.556Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read cpython Objects/codeobject.c at 010bebb read_varint/read_signed_varint (1133-1157) and advance_with_locations (1199-1250): codes 0-9 short, 10-12 one-line with two column bytes, 13 no columns, 14 long with columns read as varint-1, 15 none; LSB-first varints; sign in bit 0." |
|---|
|
|
|---|