pepper8

Transform pep8 or flake8 output to HTML

To install pepper8, simply use pip.

pip install pepper8

Or you can clone the latest master branch and build using setuptools

git clone git@github.com:myth/pepper8.git && cd pepper8 && python setup.py install

Usage

pepper8 operates in two different input modes and two different output modes. To read pep8 / flake8 status reports from file use

pepper8 -o report.html <filename>

or you can pipe output from another file or process

cat flake8.out | pepper8 > report.html

If no output file is specified with -o, the HTML report is written to stdout, allowing output redirection or piping

pepper8 <filename> | less

Build statistics

When pepper8 is run using an output file -o <filename>, it will check its run environment and print out available build statistics to stdout.

Currently, only TeamCity build statistics are supported with keys pepper8warnings and pepper8errors.

If you wish to enable full parsing of all PEP 8 / Flake8 errors as failures in TeamCity, there already exists a package called TeamCity-messages which will be treated as build errors in TeamCity.

The TeamCity build statistics provided by pepper8 is only intended to provide statistical data for use in custom build report graphs in addition to the HTML report.

Screenshots from TeamCity integration

Pepper8 PEP 8 HTML Report

TeamCity custom chart data using custom buildStatistics messages if run under TeamCity

Changelog

1.0.3

Fixed a bug causing missed statistics for last file. Split the title summary stats into the Flake8 plugins.

1.0.2

Changed links in HTML report to default to new window. This prevents TeamCity to display blank page due to loading of "unsafe scripts" inside the iframe.

1.0.1

A few bugfixes

1.0.0

Initial release