pickletools — 피클 개발자를 위한 도구¶
소스 코드: Lib/pickletools.py
이 모듈은 pickle 모듈의 깊은 세부 사항과 관련된 다양한 상수, 구현에 대한 긴 주석, 그리고 피클 된 데이터를 분석하기 위한 몇 가지 유용한 함수를 포함합니다. 이 모듈의 내용은 pickle에서 작업하는 파이썬 코어 개발자에게 유용합니다; 아마도 pickle 모듈의 일반 사용자는 pickletools 모듈을 적절한 용도를 찾지 못할 것입니다.
명령 줄 사용법¶
버전 3.2에 추가.
명령 줄에서 호출될 때, python -m pickletools는 하나 이상의 피클 파일의 내용을 역 어셈블합니다. 피클 형식의 세부 사항이 아닌 피클에 저장된 파이썬 객체를 보려면, 대신 -m pickle을 사용하는 것이 좋습니다. 그러나, 검사하려는 피클 파일이 신뢰할 수 없는 소스에서 왔을 때, 피클 바이트 코드를 실행하지 않으므로 -m pickletools가 더 안전한 옵션입니다.
예를 들어, 튜플 (1, 2)가 파일 x.pickle에 피클 된 경우:
$ 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¶
각 줄에 짧은 opcode 설명으로 주석을 답니다.
- -o, --output=<file>¶
출력이 기록되어야 하는 파일의 이름.
- -l, --indentlevel=<num>¶
새 MARK 수준을 들여쓰기하는 공백의 수.
- -m, --memo¶
여러 객체가 역 어셈블될 때, 역 어셈블리 간에 메모를 보존합니다.
- -p, --preamble=<preamble>¶
하나 이상의 피클 파일이 지정될 때, 각 역 어셈블리 전에 주어진 프리앰블을 인쇄합니다.
프로그래밍 인터페이스¶
- pickletools.dis(pickle, out=None, memo=None, indentlevel=4, annotate=0)¶
피클의 기호적인 역 어셈블리를 기본값이
sys.stdout인 파일류 객체 out으로 출력합니다. pickle는 문자열이나 파일류 객체가 될 수 있습니다. memo는 피클의 메모로 사용될 파이썬 딕셔너리일 수 있습니다; 같은 피클러로 만들어진 여러 피클에 걸쳐 역 어셈블리를 수행하는 데 사용할 수 있습니다. 스트림의MARK옵코드로 표시된 연속 수준은 indentlevel개의 스페이스로 들여쓰기 됩니다. 0이 아닌 값이 annotate에 주어지면, 출력의 각 옵코드에 짧은 설명이 주석으로 표시됩니다. annotate 값은 주석을 시작해야 하는 열의 힌트로 사용됩니다.버전 3.2에서 변경: Added the annotate parameter.
- pickletools.genops(pickle)¶
피클의 모든 옵코드에 대해
(opcode, arg, pos)트리플을 반환하는 이터레이터를 제공합니다. opcode는OpcodeInfo클래스의 인스턴스입니다; arg는 옵코드 인자의 파이썬 객체로 디코딩된 값입니다; pos는 이 옵코드의 위치입니다. pickle은 문자열이나 파일류 객체가 될 수 있습니다.
- pickletools.optimize(picklestring)¶
사용되지 않는
PUT옵코드를 제거한 후 새로운 동등한 피클 문자열을 반환합니다. 최적화된 피클은 더 짧고, 전송 시간이 덜 걸리며, 저장 공간이 덜 필요하고, 역 피클이 더 효율적입니다.