DICE is a black-box random testing framework.

• Standardize software random testing activity.
• Provides professional random testing.
• Apply to your project with minimal effort.
• Human friendly configuration process.
• Universally applicable to many aspect of software testing.

DICE is currently in experimental stage and not ready for release yet. So easy-install or pip way of installation is not available now. The only way to install DICE is from the source code.

To install DICE from git repository, clone the source code to local first:

git clone https://github.com/code-dice/dice
cd dice

Then install dependencies from pip:

sudo pip install -r requirements.txt

Install DICE:

sudo python setup.py install

Build the example binary from source:

cd examples/pyramid
gcc pyramid.c -o pyramid

Run DICE on the example project:

dice

This will open a curses TUI shows the statistics of results by generating the option randomly.

The left panel is a stat panel shows the stat of error message patterns categorized by the exit status and whether error message matches expectation defined in the constraint file.

The central panel is a list panel lists recent called command lines matches the error message pattern selecting in the stat panel.

The right panel is a detail panel show the detailed information of the selected command in list panel includes command line, standard output and standard error.

The follow key press allowing navigation through the panels.

All documentation is online at https://dice.readthedocs.org/en/latest/.

Bug reporting, issues and patches to both code and documentation are welcome on Github.

`Contribution Guideline`: http://dice.readthedocs.org/en/latest/contribute.html