De longe, a maneira mais simples de colocar tudo em funcionamento é usar a versão empacotada estável no PyPI

Através dos builds gerados

Baixe o artefato funcional mais recente na aba de Github Actions do repositório. Extraia o arquivo ZIP e instale o arquivo .whl que você encontrará dentro da pasta wheel.

A partir do repositório de origem

Bem simples:

Ou sem clonar

Observe que essa abordagem exigirá que você tenha todas as ferramentas de compilação necessárias instaladas (conforme descrito abaixo)

Compilação

Requisitos

• Python 3.8+ (com kit de desenvolvimento)
• cmake
• pip
• um compilador compatível com C++20 (testado cl no Windows, clang++ no MacOS e g++ no Linux)

Passos

• Compile o BochsCPU, BochsCPU-FFI e BochsCPU-Build seguindo as instruções em suas respectivas páginas
• ... Alternativamente, os arquivos objeto das bibliotecas do BochsCPU-FFI para Windows e Linux podem ser baixados das Github Actions de build
• Mova os *.lib para bochscpu/lib/<BuildType> (onde BuildType pode ser Debug, Release, RelWithDebInfo, etc.)
• Instale os requisitos: python -m pip install -r requirements.txt
• Compile com cmake Isso gerará o arquivo pyd do bochscpu (e seu PDB) que você pode importar de uma sessão Python com import bochscpu.
• ... Alternativamente, você também pode gerar um .whl a partir da raiz do projeto:

Uso

Basta importar o módulo bochscpu e deixe a diversão começar! A instalação do pacote também instalará arquivos de interface, permitindo que IDEs modernas (VSCode, PyCharm, etc.) ofereçam preenchimento útil.

Um modelo bastante simples pode ser feito assim:

Isso criará uma sessão bochscpu, definirá o estado da CPU para o modo real e pré-populará os hooks com callbacks básicos (que apenas executam um print quando são acionados). Observe que este exemplo não fará nada na prática, pois não alocamos páginas de código nem configuramos corretamente os registradores para apontar para elas.

Um modelo mais completo pode ser encontrado na pasta examples/

Alguns Exemplos

Aproveite 🍻