Skip to main content

Fuzzinator

Random Testing Framework

https://badge.fury.io/py/fuzzinator.svg https://travis-ci.org/renatahodovan/fuzzinator.svg?branch=master https://ci.appveyor.com/api/projects/status/mhdvgk65p0r7fkxr/branch/master?svg=true https://readthedocs.org/projects/fuzzinator/badge/?version=latest

Fuzzinator is a fuzzing framework that helps you to automate tasks usually needed during a fuzz session:

  • run your favorite test generator and feed the test cases to the system-under-test,

  • catch and save the unique issues,

  • reduce the failing test cases,

  • ease the reporting of issues in bug trackers (e.g., Bugzilla or GitHub),

  • regularly update SUTs if needed, and

  • schedule multiple SUTs and generators without overloading your workstation.

All the above features are fully customizable either by writing a simple config file or by implementing Python snippets to cover special needs. Check out some slides about Fuzzinator for a general overview, or see the Tutorial for a detailed walk-through on the config files.

To help tracking the progress of the fuzzing, Fuzzinator provides two interfaces:

  • an interactive TUI (supported on Linux and Mac OS X) that gives a continuously updated overview about the currently running tasks, statistics about the efficacy of the test generators, and the found issues (and also supports reporting them); and

  • a dump-mode (supported on every platform) that displays the news on line-based consoles.

Although Fuzzinator itself doesn’t come with test generators (except for an example random character sequence generator), you can find a list of useful generators in the wiki.

Requirements

  • Python >= 3.4

  • pip and setuptools Python packages (the latter is automatically installed by pip)

  • MongoDB (either local installation or access to remote database)

Install

The quick way:

pip install fuzzinator

Alternatively, by cloning the project and running setuptools:

python setup.py install

Usage

A common form of Fuzzinator’s usage:

fuzzinator --tui -U <path/to/the/config.ini>

Compatibility

Fuzzinator was tested on:

  • Linux (Ubuntu 14.04 / 15.10 / 16.04)

  • Mac OS X (OS X El Capitan - 10.11).

Acknowledgements

The authors are immensely grateful to Dr. Heinz Doofenshmirtz for the continuous inspiration.

Metadata

Release files for fuzzinator 18.3.1

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

Source distribution (sdist)

Source distribution for fuzzinator 18.3.1
File Size Uploaded Provenance
fuzzinator-18.3.1.tar.gz 53.9 kB Without provenance Details

Release files / fuzzinator-18.3.1.tar.gz

Download URL fuzzinator-18.3.1.tar.gz
Size 53.9 kB
Tags Source
SHA-256 checksum
How to use checksums
786980a40cfa62e85fbbc187e79af41d2a32ada4166dbe446bf0e1a2134f2a97
BLAKE2b-256 checksum
How to use checksums
e45c4bad36155f2f132ac257c659b90ed34e429c49cc6d8feaae67aae9b96b50
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for fuzzinator 18.3.1

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.

Release history Release notifications | RSS feed

This release

18.3.1 This release

1 release file No provenance

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