Skip to content
A Python application for tracking, reporting on timing and complexity in Python code
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs bump version and update docs Jan 25, 2019
test skip on windows Jan 25, 2019
wily update version with patch Mar 14, 2019
.gitignore fix: reduced used fonts and removed .DS_Store-file Dec 24, 2018
.pre-commit-config.yaml update pc config Nov 16, 2018 update version with patch Mar 14, 2019
LICENSE skip on windows Jan 25, 2019


A command-line application for tracking, reporting on complexity of Python tests and applications.

Build Status codecov Documentation Status PyPI version black

wily [a]:
quick to think of things, having a very good understanding of situations and possibilities, 
and often willing to use tricks to achieve an aim.

Wily uses git to go through each revision (commit) in a branch and run complexity and code-analysis metrics over the code. You can use this to limit your code or report on trends for complexity, length etc.


See the Documentation Site for full usage guides.

Wily can be used via a command line interface, wily.

 $ wily --help


pre-commit plugin

You can install wily as a pre-commit plugin by adding the following to .pre-commit-config.yaml

-   repo: local
    -   id: wily
        name: wily
        entry: wily diff
        verbose: true
        language: python
        additional_dependencies: [wily]

Command line usage

wily build

The first step to using wily is to build a wily cache with all of the statistics of your project.

Usage: build [OPTIONS] [TARGETS]...

  Build the wily cache

  -n, --max-revisions INTEGER  The maximum number of historical commits to
  -o, --operators TEXT         List of operators, separated by commas
  --help                       Show this message and exit.

By default, wily will assume your project folder is a git directory. Wily will not build a cache if the working copy is dirty (has changed files not commited).

 $ wily build src/

Limit the number of revisions (defaults to 50).


wily report

Show a specific metric for a given file, requires that .wily/ exists

wily report will print the metric and the delta between each revision.


wily graph

Similar to wily report but instead of printing in the console, wily will print a graph in a browser.


wily index

Show information about the build directory. Requires that .wily/ exists.

wily index will print the configuration to the screen and list all revisions that have been analysed and the operators used.


wily list-metrics

List the metrics available in the Wily operators. Each one of the metrics can be used in wily graph and wily report

 $ wily list-metrics
mccabe operator:
No metrics available
raw operator:
│                 │ Name                 │ Description   │ Type                     │
│ loc             │ Lines of Code        │ <class 'int'> │ MetricType.Informational │
│ lloc            │ L Lines of Code      │ <class 'int'> │ MetricType.Informational │
│ sloc            │ S Lines of Code      │ <class 'int'> │ MetricType.Informational │
│ comments        │ Multi-line comments  │ <class 'int'> │ MetricType.Informational │
│ multi           │ Multi lines          │ <class 'int'> │ MetricType.Informational │
│ blank           │ blank lines          │ <class 'int'> │ MetricType.Informational │
│ single_comments │ Single comment lines │ <class 'int'> │ MetricType.Informational │
cyclomatic operator:
No metrics available
maintainability operator:
│      │ Name                    │ Description     │ Type                     │
│ rank │ Maintainability Ranking │ <class 'str'>   │ MetricType.Informational │
│ mi   │ Maintainability Index   │ <class 'float'> │ MetricType.AimLow        │


You can put a wily.cfg file in your project directory and wily will override the runtime settings. Here are the available options:

# list of operators, choose from cyclomatic, maintainability, mccabe and raw
operators = cyclomatic,raw
# archiver to use, defaults to git
archiver = git
# path to analyse, defaults to .
path = /path/to/target
# max revisions to archive, defaults to 50
max_revisions = 20

You can also override the path to the configuration with the --config flag on the command-line.



  • @wcooley (Wil Cooley)
  • @DahlitzFlorian (Florian Dahlitz)

"cute animal doing dabbing" Designed by Freepik

You can’t perform that action at this time.