bochscpu-python

Python bindings for @yrp's BochsCPU using FFI to easily and accurately emulate x86 code.

bochscpu-python requires a Python environment of 3.8 or more recent only.

By far the simplest way to get things up and running is using the stable packaged version on PyPI

python -m pip install bochscpu-python

Download the latest working artifact from the repository Github Actions tab. Extract the ZIP file, install the .whl file you'll find inside the wheel folder.

python -m pip install wheel/bochscpu-$version-$os-$arch.whl

Fairly straight forward:

python -m pip install .

Or without cloning

python -m pip install git+https://github.com/hugsy/bochscpu-python.git#egg=bochscpu-python

Note that this approach will require you to have all the building tools necessary installed (as described below)

• Python 3.8+ (with development kit)
• cmake
• pip
• a C++20 compatible compiler (tested cl for Windows, clang++ for MacOS and g++ Linux)

• Build BochsCPU, BochsCPU-FFI, and BochsCPU-Build following the instructions on their respective pages
• ... Alternatively BochsCPU-FFI for Windows & Linux libraries object files can be downloaded from the build Github Actions
• Move the *.lib in bochscpu/lib/<BuildType> (where BuildType can be Debug, Release, RelWithDebInfo, etc.)
• Install the requirements: python -m pip install -r requirements.txt
• Build with cmake This will generate the bochscpu pyd file (and its PDB) which you can import from a Python session with import bochscpu.
• ... Alternatively you can also generate a .whl from the root of the project:

python -m pip wheel . 

Just import the bochscpu module and let the fun begin! Installing the package will also install interface files, allowing modern IDEs (VSCode, PyCharm, etc.) to offer useful completion.