Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Transforms pep8 or flake8 output into an HTML report.

Project Description

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 && cd pepper8 && python install


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



Expand pepper8 to account for all possible alphanumeric violation codes on a [A-Z][0-9]{3,4} format. Updated broken link to flake8-readthedocs.


Fixed a Python 2 and 3 compatibility issue. Added changelog to README.


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


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.


A few bugfixes


Initial release

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(11.4 kB) Copy SHA256 Hash SHA256
py2.py3 Wheel Oct 25, 2016
(8.4 kB) Copy SHA256 Hash SHA256
Source Oct 25, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting