py2dis - A disassembly engine & library for Python

Last update: Feb 04, 2022

Related tags

Overview

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

py2dis - A disassembly engine & library for Python

Related tags

Overview

py2dis - A disassembly engine & library for Python.

Features

Disassembling Classes

Disassembling Functions

Disassembling Raw Bytecode

Disassembling Source Code Strings

Looking up Opcodes

Looking up Instructions

Exporting Bytecode from a Function

Requirements

Screenshots

Credits

Contributions 🎉

All contributions are accepted, simply open an Issue / Pull request.

Owner

BlueBorne Dockerized

Auto check in via GitHub Actions

A Way to Use Python, Easier.

Companion Web site for Fluent Python, Second Edition

An experimental Python-to-C transpiler and domain specific language for embedded high-performance computing

A reference implementation for processing the content.log files found at opendata.dwd.de/weather

A wrapper around the python Tkinter library for customizable and modern ui-elements in Tkinter

Retrieve bank transactions and categorize for budgeting use

Box CRUD API With Python

Handwrite - Type in your Handwriting!

Rotating cube with hand

This is a database of 180.000+ symbols containing Equities, ETFs, Funds, Indices, Futures, Options, Currencies, Cryptocurrencies and Money Markets.

Modern API wrapper for Genshin Impact built on asyncio and pydantic.

Subcert is an subdomain enumeration tool, that finds all the subdomains from certificate transparency logs.

Multitrack exporter for OP-Z

This app is to use algorithms to find the root of the equation

On this repo, you'll find every codes I made during my NSI classes (informatical courses)

Scripts used in the RayStation medical radiation dosimetry treatment planning system

Make creating Excel XLSX files fun again

Paprika is a python library that reduces boilerplate. Heavily inspired by Project Lombok.