Skip to content

Commit 0bdc939

Browse files
authored
version bump -> 0.1.9 (#20)
1 parent f169eef commit 0bdc939

File tree

6 files changed

+302
-263
lines changed

6 files changed

+302
-263
lines changed

.github/workflows/build.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ on:
1010

1111
env:
1212
NB_CPU: 1
13-
VERSION: '0.1.8'
13+
VERSION: '0.1.9'
1414

1515
jobs:
1616
bochscpu:

CMakeLists.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ set(CMAKE_INTERPROCEDURAL_OPTIMIZATION True)
77
project(
88
bochscpu-python
99
LANGUAGES CXX
10-
VERSION 0.1.8
10+
VERSION 0.1.9
1111
DESCRIPTION "Python bindings for BochsCPU"
1212
HOMEPAGE_URL https://github.com/hugsy/bochscpu-python
1313
)

README.md

Lines changed: 48 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
[![python 3](https://img.shields.io/badge/python-3.8+-cyan)](https://python.org)
44
[![Python 3.8+](https://img.shields.io/pypi/v/bochscpu-python.svg)](https://pypi.org/project/bochscpu-python/)
55
[![Downloads](https://static.pepy.tech/badge/bochscpu-python)](https://pepy.tech/project/bochscpu-python)
6-
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
6+
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
77
[![Licence MIT](https://img.shields.io/packagist/l/doctrine/orm.svg?maxAge=2592000?style=plastic)](https://github.com/hugsy/bochscpu-python/blob/main/LICENSE)
88

99
Python bindings for [@yrp](https://github.com/yrp604/)'s [BochsCPU](https://github.com/yrp604/bochscpu) using [FFI](https://github.com/yrp604/bochscpu-ffi) to easily and accurately emulate x86 code.
@@ -53,7 +53,7 @@ Note that this approach will require you to have all the building tools necessar
5353
* Python 3.8+ (with development kit)
5454
* `cmake`
5555
* `pip`
56-
* a C++20 compatible compiler (tested `cl` for Windows, `clang++` for MacOS and `g++` Linux)
56+
* a C++20 compatible compiler (tested `cl` for Windows, `clang++` for MacOS and `g++` Linux)
5757

5858
### Steps
5959

@@ -66,29 +66,68 @@ Note that this approach will require you to have all the building tools necessar
6666
* ... Alternatively you can also generate a `.whl` from the root of the project:
6767

6868
```bash
69-
python -m pip wheel .
69+
python -m pip wheel .
7070
```
7171

7272
## Usage
7373

7474
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.
7575

7676

77-
## Gallery
77+
## Some Examples
7878

79-
### Emulate a Fibonascii sequence in x64 long mode
79+
<details>
8080

81-
![image](https://github.com/hugsy/bochscpu-python/assets/590234/037e581f-c57d-4b0b-a136-6925ceecfbca)
81+
<summary>
82+
Emulate a Fibonascii sequence in x64 long mode
83+
</summary>
8284

8385

84-
### Emulate code from a Windows 11 x64 memory dump
86+
87+
88+
https://github.com/hugsy/bochscpu-python/assets/590234/adc5ac5a-a8eb-4982-9537-5ece3f32f8f8
89+
90+
91+
[Code](examples/long_mode_fibonacci.py)
92+
</details>
93+
94+
95+
<details>
96+
97+
<summary>
98+
Emulate code from a Windows 11 x64 memory dump
99+
</summary>
85100

86101
![image](https://github.com/hugsy/bochscpu-python/assets/590234/2ea77b17-cf59-4ec3-a38b-602d63e201f8)
87102

103+
[Code](examples/long_mode_emulate_windows_kdump.py)
104+
</details>
105+
106+
107+
<details>
108+
<summary>
109+
Emulate a <code>print("hello world")</code>-like assembly code in 16 bit real mode
110+
</summary>
111+
112+
113+
https://github.com/hugsy/bochscpu-python/assets/590234/eb06af06-4b10-490e-ae40-a1d0aed333ca
114+
115+
116+
[Code](examples/real_mode_print_hello_world.py)
117+
</details>
118+
119+
<details>
120+
<summary>
121+
Emulate Linux Glibc's <code>rand()</code> function on x64
122+
</summary>
123+
124+
125+
https://github.com/hugsy/bochscpu-python/assets/590234/2486adbc-0878-46f5-83ed-3bcf9774fd26
126+
88127

89-
### Emulate a `print("hello world")`-like assembly code in 16 bit real mode
128+
[Code](examples/long_mode_emulate_linux_udump.py)
90129

91-
![image](https://github.com/hugsy/bochscpu-python/assets/590234/1a49d9ef-f18a-4943-b483-4c59e64ffa82)
130+
</details>
92131

93132
## Enjoy 🍻
94133

0 commit comments

Comments
 (0)