bochscpu-python 0.1.6

Python bindings for BochsCPU.

bochscpu-python

Python bindings for @yrp's BochsCPU using FFI

Install

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

Via PyPI (preferred)

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

Via the generated builds

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

From the source repository

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)

Build

Requirements

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

Steps

• 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 . 

Usage

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.

Enjoy 🍻

TODO

• Add more complete examples
• Add basic usage examples
• Add API docs