pickletools —- pickle 開發(fā)者工具集

源代碼: Lib/pickletools.py

---

此模塊包含與 pickle 模塊內(nèi)部細節(jié)有關的多個常量，一些關于具體實現(xiàn)的詳細注釋，以及一些能夠分析封存數(shù)據(jù)的有用函數(shù)。 此模塊的內(nèi)容對需要操作 pickle 的 python 核心開發(fā)者來說很有用處；pickle 的一般用戶則可能會感覺 pickletools 模塊與他們無關。

命令行語法

3.2 新版功能.

當從命令行發(fā)起調(diào)用時，python -m pickletools 將對一個或更多 pickle 文件的內(nèi)容進行拆解。 請注意如果你查看 pickle 中保存的 Python 對象而非 pickle 格式的細節(jié)，你可能需要改用 -m pickle。 但是，當你想檢查的 pickle 文件來自某個不受信任的源時，-m pickletools 是更安全的選擇，因為它不會執(zhí)行 pickle 字節(jié)碼。

例如，對于一個封存在文件 x.pickle 中的元組 (1, 2):

 
 
 
 

  
  
  
  
$ python -m pickle x.pickle
  
  
  
  
(1, 2)
  
  
  
  

  
  
  
  
$ python -m pickletools x.pickle
  
  
  
  
 0: \x80 PROTO 3
  
  
  
  
 2: K BININT1 1
  
  
  
  
 4: K BININT1 2
  
  
  
  
 6: \x86 TUPLE2
  
  
  
  
 7: q BINPUT 0
  
  
  
  
 9: . STOP
  
  
  
  
highest protocol among opcodes = 2
 
 
 
 

命令行選項

-a, —annotate

使用簡短的操作碼描述來標注每一行。

-o, —output=

輸出應當寫入到的文件名稱。

-l, —indentlevel=

一個新的 MARK 層級所需縮進的空格數(shù)。

-m, —memo

當反匯編多個對象時，保留各個反匯編的備忘記錄。

-p, —preamble=

當指定一個以上的 pickle 文件時，在每次反匯編之前打印給定的前言。

編程接口

pickletools.dis(pickle, out=None, memo=None, indentlevel=4, annotate=0)

將 pickle 的符號化反匯編數(shù)據(jù)輸出到文件類對象 out，默認為 sys.stdout。 pickle 可以是一個字符串或一個文件類對象。 memo 可以是一個將被用作 pickle 的備忘記錄的 Python 字典；它可被用來對由同一封存器創(chuàng)建的多個封存對象執(zhí)行反匯編。 由 MARK 操作碼指明的每個連續(xù)級別將會縮進 indentlevel 個空格。 如果為 annotate 指定了一個非零值，則輸出中的每個操作碼將以一個簡短描述來標注。 annotate 的值會被用作標注所應開始的列的提示。

3.2 新版功能: annotate 參數(shù)。

pickletools.genops(pickle)

提供包含 pickle 中所有操作碼的 iterator，返回一個 (opcode, arg, pos) 三元組的序列。 opcode 是 OpcodeInfo 類的一個實例；arg 是 Python 對象形式的 opcode 參數(shù)的已解碼值；pos 是 opcode 所在的位置。 pickle 可以是一個字符串或一個文件類對象。

pickletools.optimize(picklestring)

在消除未使用的 PUT 操作碼之后返回一個新的等效 pickle 字符串。 優(yōu)化后的 pickle 將更為簡短，耗費更為的傳輸時間，要求更少的存儲空間并能更高效地解封。

文章題目：創(chuàng)新互聯(lián)Python教程：pickletools—-pickle開發(fā)者工具集
鏈接地址：http://m.5511xx.com/article/dhiseod.html