icicle-emu/icicle-python
GitHub: icicle-emu/icicle-python
该项目为 Icicle 固件模拟器提供 Python 绑定，使用户能在 Python 中便捷地进行二进制模拟与灰盒模糊测试。
Stars: 43 | Forks: 5
# icicle-python
该项目是一个易于使用的 [icicle-emu](https://github.com/icicle-emu/icicle-emu) Python 封装库。您可以在论文 [Icicle: A Re-designed Emulator for Grey-Box Firmware Fuzzing](https://arxiv.org/pdf/2301.13346.pdf) 中阅读有关 Icicle 的更多信息。
## 安装
您可以从 [PyPI](https://pypi.org/project/icicle-emu) 安装 [最新版本](https://github.com/icicle-emu/icicle-python/releases)：
```
pip install icicle-emu
```
## 开发
_注意_：您需要安装 [Rust 1.90](https://rustup.rs) 或更高版本才能从源码构建。
### 安装 uv
```
# 在 Windows 上
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# 在 macOS/Linux 上
curl -LsSf https://astral.sh/uv/install.sh | sh
```
### 构建项目
```
# 使用 submodules 克隆 repository
git clone --recursive https://github.com/icicle-emu/icicle-python
cd icicle-python
# 安装 dependencies 并构建
uv sync
uv run maturin develop
```
### 运行测试
`tests` 文件夹中包含既可作为独立示例又可用于测试的文件。在函数名前加上 `test_` 前缀即可自动运行它：
```
uv run pytest -v
```
或者，您也可以使用 `uv run tests/example.py` 来运行/调试独立示例。
### 构建 wheel
```
uv build
```
标签：Hakrawler, Python绑定, Rust, 云资产清单, 可视化界面, 系统运维工具, 网络流量审计, 逆向工具, 逆向工程, 通知系统