icicle-python

이 프로젝트는 icicle-emu를 위한 사용하기 쉬운 Python 래퍼입니다. 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