Installing Fandango#

Installing Fandango for Normal Usage#

Fandango comes as a Python package. To install Fandango, run the following command:

$ pip install fandango-fuzzer

To test if everything worked well, try

$ fandango --help

which should give you a list of options:

usage: fandango [-h] [--version] [--verbose | --quiet]
                [--parser {python,cpp,legacy,auto}]
                {fuzz,parse,talk,convert,clear-cache,shell,help,copyright,version} ...

The access point to the Fandango framework

options:
  -h, --help            show this help message and exit
  --version             Show version number.
  --verbose, -v         Increase verbosity. Can be given multiple times (-vv).
  --quiet, -q           Decrease verbosity. Can be given multiple times (-qq).
  --parser {python,cpp,legacy,auto}
                        Parser implementation to use (default: 'auto': use C++
                        parser code if available, otherwise Python).

commands:
  {fuzz,parse,talk,convert,clear-cache,shell,help,copyright,version}
                        The command to execute.
    fuzz                Produce outputs from .fan files and test programs.
    parse               Parse input file(s) according to .fan spec.
    talk                Interact with programs, clients, and servers.
    convert             Convert given external spec to .fan format.
    clear-cache         Clear the Fandango parsing cache.
    shell               Run an interactive shell (default).
    help                Show this help and exit.
    copyright           Show copyright.
    version             Show version.

Use `fandango help` to get a list of commands.
Use `fandango help COMMAND` to learn more about COMMAND.
See https://fandango-fuzzer.github.io/ for more information.

Installing Fandango for Development#

Caution

This will get you the very latest version of Fandango, which may be unstable. Use at your own risk.

Refer to the Getting Started with Development Guide for instructions on how to prepare an environment to work on Fandango.