bochscpu-python требует только окружение Python 3.8 или новее.

Через PyPI (рекомендуется)

Самый простой способ запустить всё — использовать стабильную упакованную версию на PyPI

Через готовые сборки

Скачайте последний рабочий артефакт со вкладки GitHub Actions репозитория. Распакуйте ZIP-файл и установите .whl-файл из папки wheel.

Из исходного репозитория

Довольно просто:

Или без клонирования

Обратите внимание, что этот подход потребует установки всех необходимых инструментов сборки (описано ниже)

Сборка

Требования

• Python 3.8+ (с комплектом разработчика)
• cmake
• pip
• компилятор, совместимый с C++20 (проверено: cl для Windows, clang++ для macOS и g++ для Linux)

Шаги

• Соберите BochsCPU, BochsCPU-FFI и BochsCPU-Build, следуя инструкциям на их соответствующих страницах
• ... Либо объектные файлы библиотек BochsCPU-FFI для Windows и Linux можно скачать из сборки в GitHub Actions
• Переместите файлы *.lib в bochscpu/lib/<BuildType> (где BuildType может быть Debug, Release, RelWithDebInfo и т.д.)
• Установите зависимости: python -m pip install -r requirements.txt
• Соберите с помощью cmake Это создаст файл bochscpu pyd (и его PDB), который можно импортировать из сессии Python с помощью import bochscpu.
• ... Либо можно также сгенерировать .whl из корня проекта:

Использование

Просто импортируйте модуль bochscpu — и вперёд! Установка пакета также установит файлы интерфейсов, что позволит современным IDE (VSCode, PyCharm и т.д.) предлагать полезные автодополнения.

Очень простой шаблон можно составить так:

Это создаст сессию bochscpu, установит состояние ЦП для реального режима и заполнит хуки базовыми колбэками (которые при выполнении лишь вызывают print). Обратите внимание, что этот пример ничего не сделает, поскольку мы не выделили страницы кода и не настроили регистры, указывающие на него.

Более полный шаблон можно найти в examples/

Некоторые примеры

Приятного использования 🍻