Fuzzinator Random Testing Framework
.. 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/github/actions/workflow/status/renatahodovan/fuzzinator/main.yml?branch=master&logo=github&logoColor=white :target: https://github.com/renatahodovan/fuzzinator/actions .. image:: https://img.shields.io/readthedocs/fuzzinator?logo=read-the-docs&logoColor=white :target: http://fuzzinator.readthedocs.io/en/latest/ .. image:: https://img.shields.io/gitter/room/inbugwetrust/fuzzinator?color=blueviolet&logo=gitter&logoColor=white :target: https://gitter.im/inbugwetrust/fuzzinator
.. start included documentation
Fuzzinator is a fuzzing framework that helps you to automate tasks usually needed during a fuzz session:
test generator
_ and feed the test cases to the
software-under-test,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. There is also a repository collecting configurations_ for various real-life SUTs and fuzzers.
To help tracking the progress of the fuzzing, Fuzzinator provides three interfaces:
.. _test generator
: https://github.com/renatahodovan/fuzzinator/wiki#list-of-fuzzers-test-generators
.. _reduce: https://github.com/renatahodovan/fuzzinator/wiki#list-of-test-case-reducers
.. _slides: http://www.slideshare.net/hodovanrenata/fuzzinator-in-bug-we-trust
.. _Tutorial: docs/tutorial.rst
.. _configurations: https://github.com/renatahodovan/fuzzinator-configs
.. _Python: https://www.python.org .. _MongoDB: https://www.mongodb.com .. _Java: https://www.oracle.com/java/
To install the latest release of Fuzzinator from PyPI_, use pip_::
pip install fuzzinator
Alternatively, for the development version, clone the project and perform a local install::
pip install .
.. _PyPI: https://pypi.org/ .. _pip: https://pip.pypa.io
A common form of Fuzzinator's usage::
fuzzinator --wui <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:
.. end included documentation
Licensed under the BSD 3-Clause License_.
.. _License: LICENSE.rst