Skip to main content

icicle-python

This project is an easy-to-use Python wrapper around icicle-emu. You can read more about Icicle in the paper: Icicle: A Re-designed Emulator for Grey-Box Firmware Fuzzing.

Installation

You can install the latest release from PyPI:

pip install icicle-emu

Development

Note: You need to install Rust 1.90 or higher to build from source.

Install 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

Build the project

# 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

Running tests

The tests folder contains tests that double as standalone examples. Prefix a function with test_ to automatically run it:

uv run pytest -v

Alternatively you can uv run tests/example.py to run/debug the standalone example.

Building a wheel

uv build

Metadata

Release files for icicle-emu 0.0.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for icicle-emu 0.0.11
File Size Uploaded Provenance Actions
icicle_emu-0.0.11.tar.gz 1.7 MB Without provenance Details for icicle_emu-0.0.11.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for icicle-emu 0.0.11
File Actions
icicle_emu-0.0.11-cp38-abi3-win_amd64.whl CPython 3.8 abi3 Windows x86-64 Details for icicle_emu-0.0.11-cp38-abi3-win_amd64.whl
icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details for icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details for icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
icicle_emu-0.0.11-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details for icicle_emu-0.0.11-cp38-abi3-macosx_11_0_arm64.whl
icicle_emu-0.0.11-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details for icicle_emu-0.0.11-cp38-abi3-macosx_10_12_x86_64.whl

Total release size: 20.5 MB

Release files / icicle_emu-0.0.11.tar.gz

Download URL icicle_emu-0.0.11.tar.gz
Size 1.7 MB
Tags Source
SHA-256 checksum
How to use checksums
4da97aee28959e4f3f64617eb4c8675758efc7757cd87a50ee1d18c5480b67ea
BLAKE2b-256 checksum
How to use checksums
4fb0a2efc55e93b05e9f734a93ce0287992695bdea1510c4ee0297bf48f1bad8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via maturin/1.9.6

Release files / icicle_emu-0.0.11-cp38-abi3-win_amd64.whl

Download URL icicle_emu-0.0.11-cp38-abi3-win_amd64.whl
Size 3.6 MB
Tags CPython 3.8 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
94e0da6502ae19ba89497ced98fe0f9e881b13deaf070caaca9a4a552e4e9aa6
BLAKE2b-256 checksum
How to use checksums
5c3d98030b959250f5223d697964d987dfa39c65fe4cd4671bb4c00d72738af6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via maturin/1.9.6

Release files / icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 4.2 MB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
f4baf4d20a158e5b7ec3cbebbdbc0745bd4b08a9d17674d14f84473e8280c948
BLAKE2b-256 checksum
How to use checksums
68c4da6271734229a11ebb90c69a5a63a3f6bf941055ca0e7e7535640536fde5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via maturin/1.9.6

Release files / icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL icicle_emu-0.0.11-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 3.6 MB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
45a269da9f644eda711430c192250db1ae0bd34f7b1d86b4363714306ce509f7
BLAKE2b-256 checksum
How to use checksums
a3d729b808876441af7c9f4a39861d9a7a364cc1f4dbba71de9243267f6f20c6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via maturin/1.9.6

Release files / icicle_emu-0.0.11-cp38-abi3-macosx_11_0_arm64.whl

Download URL icicle_emu-0.0.11-cp38-abi3-macosx_11_0_arm64.whl
Size 3.4 MB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
7d41d4d7d69769e908cf2770971ad5651b4f807bb73a694e37d9634e2baaafbd
BLAKE2b-256 checksum
How to use checksums
741f295c69184c4f554244bdf7db55f19434b4340d95aeb5fb3a72b0c56e92d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via maturin/1.9.6

Release files / icicle_emu-0.0.11-cp38-abi3-macosx_10_12_x86_64.whl

Download URL icicle_emu-0.0.11-cp38-abi3-macosx_10_12_x86_64.whl
Size 4.0 MB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
8da50fc6f68c3c85644eabe2162f4ef7eab60a13cba731e2f60632fdcb0e9a9f
BLAKE2b-256 checksum
How to use checksums
518687fa33577643b47231f44d8cbff2218f3b50bb606b831516473d14c04227
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via maturin/1.9.6

Security for icicle-emu 0.0.11

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page