Crate marshal_parser

Parser for the “marshal” binary de/serialization format used by CPython

This crate implements a parser and some utilities for reading files in the “marshal” de/serialization format used internally in CPython. The exact format is not stable and can change between minor versions of CPython.

This crate supports parsing “marshal” dumps and pyc files that were written by CPython versions >= 3.6 and < 3.14.

There is a high-level and a low-level API, depending on how much access to the underlying data structures is needed. The low-level API also provides more flexibility since it does not require files, but can operate on plain bytes (Vec<u8>).

Reading a pyc file from disk:

use marshal_parser::{MarshalFile, Object};

let pyc = MarshalFile::from_pyc_path("mod.cpython-310.pyc").unwrap();
let object: Object = pyc.into_inner();

Reading a “marshal” dump (i.e. a file without pyc header):

use marshal_parser::{MarshalFile, Object};

let dump = MarshalFile::from_dump_path("dump.marshal", (3, 11)).unwrap();
let object: Object = dump.into_inner();

Structs

CodeObject

Code objects as represented in the binary “marshal” format

MarshalFile

High-level parser for pyc and “marshal dump” files

MarshalObject

Parsed contents of a pyc file or “marshal dump”

Enums

Error

Custom error type for distinguishing different failure modes

Object

Python objects as represented in the binary “marshal” format

ObjectType

Object type flag in the binary “marshal” format

StringType

String type flag for string-like objects