utfuzz 0.1.10

No project description provided

utfuzz

utfuzz is a Python fuzzing engine. It supports fuzzing of Python code and generation reproducing code for error and regression suites.

Installation

utfuzz supports Python versions 3.8-3.11

You can install it from source code:

$ python -m pip install git+https://github.com/tamarinvs19/utfuzz

or

$ git clone https://github.com/tamarinvs19/utfuzz
$ cd utfuzz
$ python -m pip install -e ./

To run utfuzz you can use module python -m utfuzz or command utfuzz with active python environment.

Java installation

utfuzz depends on Java 17 and newer. If you don't have an installed Java utfuzz will try to install it or your can install Java by yourself using these instructions:

Java installation instruction for Linux

Java installation instruction for Windows

Java installation instruction for MacOS

Using utfuzz

To run:

$ python -m utfuzz

or

$ utfuzz

You can use utfuzz one of three modes:

• dialog mode (default)
• config file mode
• CLI arguments mode

After each test generation settings will be saved to file utfuzz_config.json

Priority:

• if --use_config_file default values will be from config file
• if not --use_config_file default values will be from cli-arguments
• then if not --skip-dialog new values will be from dialog

usage: utfuzz [options]

utfuzz is a Python fuzzing engine. It supports fuzzing of Python code and generation reproducing code for error and regression suites

options:
  -h, --help            show this help message and exit
  --skip_dialog         Do not ask parameters before execution
  --use_config_file     Use config file in current directory
  --generate_only_error_suite
                        Generate only error suite
  -j JAVA, --java JAVA  Path to Java executable file or JAVA_HOME
  -t TIMEOUT, --timeout TIMEOUT
                        Timeout in seconds for test generation process per one class or group of top-level functions from one file
  -p PROJECT_DIR, --project_dir PROJECT_DIR
                        Root directory with your code for testing (will be used for imports and dependencies resolving)
  -o OUTPUT_DIR, --output_dir OUTPUT_DIR
                        Directory for generated tests collecting
  --sys_paths [SYS_PATHS ...]
                        Additional path to find imports(will be added to `sys.path`, default = project directory) [optional]
  --analyze_targets [ANALYZE_TARGETS ...]
                        List of files or directories for testing, empty means <<test all>> [optional]
  --requirements_file REQUIREMENTS_FILE
                        Path to requirements.txt [optional]
  --debug               Use debug mode

See also main website of UnitTestBot project: utbot.org

UnitTestBot sources

You can change UnitTestBot source java file by changing jar-file utfuzz/utbot-cli-python.jar (Note: don't change the file name).

After replacing jar-file you should reinstall this module.

See also main website of UnitTestBot project and GitHub repository.