py2dis - A disassembly engine & library for Python.
py2dis is a disassembly library for Python that does not use any modules/libraries other than colorama, comes with a miniature built-in disassembler engine, and features to assist in disassembling classes, functions, raw bytecode, source code strings, and more!
Features
- Opcode lookups
- Dumping bytecode
- Instruction lookups
- Disassembling Classes
- Disassembling Functions
- Disassembling raw bytecode (passed to function)
- Disassembling source code strings (passed to function)
Disassembling Classes
from lib.py2dis import *
# example.py
# Date: 01/09/22
# Author: 0x80000000
class Target:
def __init__(self: None, message: str) -> None:
self.message = message
def function(self: None) -> None:
print(self.message)
class Example:
def __init__(self: None, Class: None) -> None:
self.Class = Class
def execute(self: None) -> None:
py2dis.disassemble_class(self.Class)
if __name__ == "__main__":
Example(Target).execute()
Disassembling Functions
None: self.function = function def execute(self: None) -> None: py2dis.disassemble_function(self.function) if __name__ == "__main__": Example(LoginSystem).execute() ">
from lib.py2dis import * # example.py # Date: 01/09/22 # Author: 0x80000000 def LoginSystem() -> bool: if input("Enter the secret code: ") == "1337": print("You have successfully authenticated!") return True return False class Example: def __init__(self: None, function: None) -> None: self.function = function def execute(self: None) -> None: py2dis.disassemble_function(self.function) if __name__ == "__main__": Example(LoginSystem).execute()
Disassembling Raw Bytecode
from lib.py2dis import *
# example.py
# Date: 01/09/22
# Author: 0x80000000
class Example:
def __init__(self: None, bytecode: bytes) -> None:
self.bytecode = bytecode
def execute(self: None) -> None:
py2dis.disassemble_bytecode(self.bytecode)
if __name__ == "__main__":
Example(b"t\x00d\x01\x83\x01\x01\x00d\x00S\x00").execute()
Disassembling Source Code Strings
from lib.py2dis import *
# example.py
# Date: 01/09/22
# Author: 0x80000000
class Example:
def __init__(self: None, code: str) -> None:
self.code = code
def execute(self: None) -> None:
py2dis.disassemble_source_code(self.code)
if __name__ == "__main__":
Example("print('Hello, World!')").execute()
Looking up Opcodes
from lib.py2dis import *
# example.py
# Date: 01/09/22
# Author: 0x80000000
class Example:
def __init__(self: None, opcode: int) -> None:
self.opcode = opcode
def execute(self: None) -> None:
return py2dis.opcode_lookup(self.opcode)
if __name__ == "__main__":
print(Example(123).execute())
Looking up Instructions
from lib.py2dis import *
# example.py
# Date: 01/09/22
# Author: 0x80000000
class Example:
def __init__(self: None, instruction: str) -> None:
self.instruction = instruction
def execute(self: None) -> None:
return py2dis.instruction_lookup(self.instruction)
if __name__ == "__main__":
print(Example("SEND").execute())
Exporting Bytecode from a Function
None: self.function = function def execute(self: None) -> None: return py2dis.export_raw_bytecode(self.function) if __name__ == "__main__": print(Example(LoginSystem).execute())">
from lib.py2dis import * # example.py # Date: 01/09/22 # Author: 0x80000000 def LoginSystem() -> bool: if input("Enter the secret code: ") == "1337": print("You have successfully authenticated!") return True return False class Example: def __init__(self: None, function: None) -> None: self.function = function def execute(self: None) -> None: return py2dis.export_raw_bytecode(self.function) if __name__ == "__main__": print(Example(LoginSystem).execute())
Requirements
pip3 install colorama
Screenshots
Credits
https://github.com/0x80000000
0 Dec 13, 2021
12 Nov 24, 2022
50 Jan 06, 2023
8 Nov 12, 2022
2 May 22, 2022
3 Nov 15, 2022
22 Sep 27, 2022
2 Nov 03, 2022
7 Sep 19, 2022
1 Jan 09, 2022
7 Oct 17, 2022
1 Dec 07, 2021
4 Oct 11, 2022
132 Dec 11, 2022
1 Dec 17, 2021
1k Dec 16, 2022
195 Dec 13, 2022
2 Oct 16, 2021
2 Jun 15, 2022
106 Dec 19, 2022