.. image:: docs/img/fuzzinator-black-on-trans-289x49.png
Fuzzinator: Random Testing Framework
.. image:: https://img.shields.io/pypi/v/fuzzinator?logo=python&logoColor=white :target: https://pypi.org/project/fuzzinator/ .. image:: https://img.shields.io/pypi/l/fuzzinator?logo=open-source-initiative&logoColor=white :target: https://pypi.org/project/fuzzinator/ .. image:: https://img.shields.io/travis/renatahodovan/fuzzinator/master?logo=travis&logoColor=white :target: https://travis-ci.org/renatahodovan/fuzzinator .. image:: https://img.shields.io/readthedocs/fuzzinator?logo=read-the-docs&logoColor=white :target: http://fuzzinator.readthedocs.io/en/latest/
.. start included documentation
Fuzzinator is a fuzzing framework that helps you to automate tasks usually needed during a fuzz session:
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 <docs/tutorial.rst>_ for a detailed walk-through on the config files.
To help tracking the progress of the fuzzing, Fuzzinator provides two interfaces:
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_.
.. _Tutorial: docs/tutorial.rst .. _slides: http://www.slideshare.net/hodovanrenata/fuzzinator-in-bug-we-trust .. _wiki: https://github.com/renatahodovan/fuzzinator/wiki
The quick way::
pip install fuzzinator
Alternatively, by cloning the project and running setuptools::
python setup.py install
A common form of Fuzzinator's usage::
fuzzinator --tui --utf8 <path/to/the/config.ini>
Fuzzinator was tested on:
The authors are immensely grateful to Dr. Heinz Doofenshmirtz for the continuous inspiration.
Background on Fuzzinator is published in (R. Hodovan, A. Kiss: "Fuzzinator: An Open-Source Modular Random Testing Framework", ICST 2018).
.. end included documentation
Licensed under the BSD 3-Clause License_.
.. _License: LICENSE.rst