Sign inDemoInstall


Package Overview
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies



A basic HTML report for pytest using Jinja2 template engine.



========================= pytest-reporter-html-dots

This is a fork of the great template pytest-reporter-html1 <>_ with one detail changed: Instead of grouping the tests and showing only a number how many tests have failed and how many have passed, this template tries to mimic the standard pytest output with one dot for every test. This has the advantages that (1) even without expanding a file it's visible which tests have failed and whether they are the same like in the last run and (2) it gives a better visualization how many tests have failed in a specific file. Hovering over a badge shows the name of the test and it's status (e.g. passed/failed/skipped).

A basic HTML report for pytest_ using Jinja2_ template engine. Based on pytest-reporter_ which provides the data to the template.


  • Overview of files, tests, and phases with expandable sections
  • Includes information about tests such as documentation, markers, and fixtures
  • Fairly mobile friendly
  • Complies with Jenkins default CSP policy (with --split-report)
  • Support for pytest-metadata_ and pytest-rerunfailures_
  • May be used as a base template for customization

.. image:: :alt: Screenshot


You can install "pytest-reporter-html-dots" via pip_ from PyPI_::

$ pip install pytest-reporter-html-dots


Specify the html-dots template and the output path of the report::

$ pytest --template=html-dots/index.html --report=report.html

By default the report is self-contained, but you can separate CSS, images, and JavaScript by specifying the --split-report option.


You can customize this template using template inheritance_.

If you want to add more information to the meta data table, extend the session_metadata block. Create the following file called report-template.html next to your tox.ini:

.. code:: html

{% extends "html-dots/index.html" %}
{% block session_metadata %}
    {{ super() }}
        <th>System under test version</th>
        <td>{{ version }}</td>
{% endblock %}

Add version to the context in the pytest_reporter_context hook <>_ in

.. code:: python

import pytest

@pytest.hookimpl  # type: ignore [misc]  # Untyped decorator makes function "pytest_reporter_context" untyped
def pytest_reporter_context(context: 'dict[str, object]', config: 'pytest.Config') -> None:
    context['version'] = '0.1.2'

Add --template-dir and change --template in tox.ini (I am using bash to insert a timestamp into the report name via command substitution with date):

.. code:: ini

envlist = py3
isolated_build = True

allowlist_externals = bash
deps =
commands =
    mypy src
    bash -c "pytest --template-dir={toxinidir} --template=report-template.html --report={toxinidir}{/}log{/}pytest-`date +%Y-%m-%d_%H-%M`.html {posargs}"

Some additional filters are available for templates to use:

asset(path_or_content, extension) Takes a path to a local file or a raw bytes object and either returns a base64 encoded URL or a new relative URL to a copy depending on if the report is self-contained or not.

.. code:: html

    <img src="{{ 'path/to/image.png'|asset }}">
    <img src="{{ raw_byte_data|asset('png') }}">

ansi(s) Convert ANSI color codes to HTML.

strftime(value, format) Format a Unix timestamp using datetime.strftime_.

.. code:: html

    Started: {{ started|strftime('%Y-%m-%d %H:%M:%S') }}

timedelta(value) Convert a time in seconds to a timedelta_ object.

rst(s) Convert reStructuredText to HTML.

.. _Jinja2: .. _template inheritance: .. _pytest: .. _pytest-reporter: .. _pytest-metadata: .. _pytest-rerunfailures: .. _pip: .. _PyPI: .. _datetime.strftime: .. _timedelta:


Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.


Related posts

SocketSocket SOC 2 Logo


  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc