____                  ____         ''',
   / __ \____  ____  ____/ / /__    o_)O \)____)"
  / /_/ / __ \/ __ \/ __  / / _ \    \_        )
 / ____/ /_/ / /_/ / /_/ / /  __/      '',,,,,,
/_/    \____/\____/\__,_/_/\___/         ||  ||
Poodle Mutation Tester                  "--'"--'

“A breed so perfect, so elegant, and so intelligent, that people decided to breed them with, well, everything.” - Girl With The Dogs

PyPI - Version Homepage

Poodle is an tool for Mutation Testing your Python projects.

Mutation Testing proves the quality of your test suite by introducing bugs in your application, then verifying if your test cases can find the bug.


The goal of Poodle is to be highly efficient, configurable, and extendable.

  • Multi-Threaded execution

  • Highly Configurable (toml and py)

  • Plug in custom code

Quick Start#


pip install poodle --upgrade
Usage: poodle [OPTIONS] [SOURCES]...

  Poodle Mutation Test Tool.

  -c PATH         Configuration File.
  -q              Quiet mode: q, qq, or qqq
  -v              Verbose mode: v, vv, or vvv
  -w INTEGER      Maximum number of parallel workers.
  --exclude TEXT  Add a regex exclude file filter. Multiple allowed.
  --only TEXT     Glob pattern for files to mutate. Multiple allowed.
  --help          Show this message and exit.

Table of Contents#



If you are having issues, please let us know.

I can be contacted at: pbuschmail-poodle@yahoo.com

Or by opening an issue: https://github.com/WiredNerd/poodle/issues


The project is licensed under the MIT license.