icicle-python

本项目是一个易于使用的 Python 封装库，封装了 icicle-emu。你可以在论文中了解更多关于 Icicle 的信息：Icicle: A Re-designed Emulator for Grey-Box Firmware Fuzzing。

安装

你可以从 PyPI 安装最新版本：

pip install icicle-emu

开发

注意：从源码构建需要安装 Rust 1.90 或更高版本。

安装 uv

# On Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# On macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

构建项目

# Clone the repository with submodules
git clone --recursive https://github.com/icicle-emu/icicle-python
cd icicle-python

# Install dependencies and build
uv sync
uv run maturin develop

运行测试

tests 文件夹中包含的测试同时也可作为独立示例使用。在函数名前加上 test_ 前缀即可自动运行它：

uv run pytest -v

或者，你可以使用 uv run tests/example.py 来运行/调试独立示例。

构建 wheel

uv build