marshal --- 內部 Python 對象序列化?
此模塊包含一此能以二進制格式來讀寫 Python 值的函數。 這種格式是 Python 專屬的，但是獨立于特定的機器架構（即你可以在一臺 PC 上寫入某個 Python 值，將文件傳到一臺 Sun 上并在那里讀取它）。 這種格式的細節有意不帶文檔說明；它可能在不同 Python 版本中發生改變（但這種情況極少發生）。 1
這不是一個通用的“持久化”模塊。 對于通用的持久化以及通過 RPC 調用傳遞 Python 對象，請參閱 pickle 和 shelve 等模塊。 marshal 模塊主要是為了支持讀寫 .pyc 文件形式“偽編譯”代碼的 Python 模塊。 因此，Python 維護者保留在必要時以不向下兼容的方式修改 marshal 格式的權利。 如果你要序列化和反序列化 Python 對象，請改用 pickle 模塊 -- 其執行效率相當，版本獨立性有保證，并且 pickle 還支持比 marshal 更多樣的對象類型。
警告
marshal 模塊對于錯誤或惡意構建的數據來說是不安全的。 永遠不要 unmarshal 來自不受信任的或未經驗證的來源的數據。
不是所有 Python 對象類型都受支持；一般來說，此模塊只能寫入和讀取不依賴于特定 Python 調用的對象。 下列類型是受支持的：布爾值、整數、浮點數、復數、字符串、字節串、字節數組、元組、列表、集合、凍結集合、字典和代碼對象，需要了解的一點是元組、列表、集合、凍結集合和字典只在其所包含的值也是這些值時才受支持。 單例對象 None, Ellipsis and StopIteration 也可以被 marshal 和 unmarshal。 對于 version 低于 3 的格式，遞歸列表、集合和字典無法被寫入（見下文）。
有些函數可以讀/寫文件，還有些函數可以操作字節類對象。
這個模塊定義了以下函數：
-
marshal.dump(value, file[, version])? 向打開的文件寫入值。 值必須為受支持的類型。 文件必須為可寫的 binary file。
如果值具有（或所包含的對象具有）不受支持的類型，則會引發
ValueError--- 但是將向文件寫入垃圾數據。 對象也將不能正確地通過load()重新讀取。version 參數指明
dump應當使用的數據格式（見下文）。
-
marshal.load(file)? 從打開的文件讀取一個值并返回。 如果讀不到有效的值（例如由于數據為不同 Python 版本的不兼容 marshal 格式），則會引發
EOFError,ValueError或TypeError。 文件必須為可讀的 binary file。
-
marshal.dumps(value[, version])? 返回將通過
dump(value, file)被寫入一個文件的字節串對象。 值必須屬于受支持的類型。 如果值屬于（或包含的對象屬于）不受支持的類型則會引發ValueError。version 參數指明
dumps應當使用的數據類型（見下文）。
-
marshal.loads(bytes)? 將 bytes-like object 轉換為一個值。 如果找不到有效的值，則會引發
EOFError,ValueError或TypeError。 輸入的額外字節串會被忽略。
此外，還定義了以下常量：
-
marshal.version? 指明模塊所使用的格式。 第 0 版為歷史格式，第 1 版為共享固化的字符串，第 2 版對浮點數使用二進制格式。 第 3 版添加了對于對象實例化和遞歸的支持。 目前使用的為第 4 版。
備注
- 1
此模塊的名稱來源于 Modula-3 (及其他語言) 的設計者所使用的術語，他們使用術語 "marshal" 來表示以自包含的形式傳輸數據。 嚴格地說，將數據從內部形式轉換為外部形式 (例如用于 RPC 緩沖區) 稱為 "marshal" 而其逆過程則稱為 "unmarshal"。