pytest-md-report 0.0.6

A pytest plugin to make a test results report with Markdown table format.

pytest-md-report

• Summary

• Installation

• Usage

  • Other examples

• Options

  • Command options

  • ini-options

• Dependencies

Summary

A pytest plugin to make a test results report with Markdown table format.

Installation

pip install pytest-md-report

Usage

$ pytest --md-report examples/

Output example

Other examples

Increase verbosity level (--md-report-verbose option):

$ pytest --md-report --md-report-verbose=1 examples/

Output example (verbose)

Not rendering results of zero value (--md-report-zeros emmpty option):

$ pytest --md-report --md-report-zeros empty --md-report-color never examples/

|         filepath         | passed | failed | error | skipped | xfailed | xpassed |
|--------------------------|-------:|-------:|------:|--------:|--------:|--------:|
| examples/test_error.py   |        |        |     2 |         |         |         |
| examples/test_failed.py  |        |      2 |       |         |         |         |
| examples/test_pass.py    |      2 |        |       |         |         |         |
| examples/test_skipped.py |        |        |       |       2 |         |         |
| examples/test_xfailed.py |        |        |       |         |       2 |         |
| examples/test_xpassed.py |        |        |       |         |         |       2 |
| TOTAL                    |      2 |      2 |     2 |       2 |       2 |       2 |

Options

Command options

make test results report with markdown table format:
  --md-report           create markdown report. you can also specify the value
                        with PYTEST_MD_REPORT environment variable.
  --md-report-verbose=VERBOSITY_LEVEL
                        verbosity level for pytest-md-report. if not set, using
                        verbosity level of pytest. defaults to 0. you can also
                        specify the value with PYTEST_MD_REPORT_VERBOSE
                        environment variable.
  --md-report-color={auto,text,never}
                        auto: display colored (text and background) reports by
                        using ANSI escape codes. text: display colored (text)
                        reports by using ANSI escape codes. never: display
                        report without color. defaults to 'auto'. you can also
                        specify the value with PYTEST_MD_REPORT_COLOR
                        environment variable.
  --md-report-margin=MARGIN
                        margin size for each cells. defaults to 1. you can also
                        specify the value with PYTEST_MD_REPORT_MARGIN
                        environment variable.
  --md-report-zeros={number,empty}
                        rendering method for results of zero values. number:
                        render as a digit number (0). empty: not rendering.
                        defaults to number. you can also specify the value with
                        PYTEST_MD_REPORT_ZEROS environment variable.

ini-options

[pytest] ini-options in the first pytest.ini|tox.ini|setup.cfg file found:

md_report (bool):     create markdown report.
md_report_verbose (string):
                      verbosity level for pytest-md-report. if not set, using
                      verbosity level of pytest. defaults to 0.
md_report_color (string):
                      auto: display colored (text and background) reports by
                      using ANSI escape codes. text: display colored (text)
                      reports by using ANSI escape codes. never: display
                      report without color. defaults to 'auto'.
md_report_margin (string):
                      margin size for each cells. defaults to 1.
md_report_zeros (string):
                      rendering method for results of zero values. number:
                      render as a digit number (0). empty: not rendering.
                      defaults to number.

Example of setup.cfg:

[tool:pytest]
md_report = True
md_report_verbose = 0
md_report_color = auto

Dependencies

Python 3.5+

• pytablewriter

• pytest

• typepy