Metadata-Version: 2.1
Name: pytest-md-report
Version: 0.0.5
Summary: A pytest plugin to make a test results report with Markdown table format.
Home-page: https://github.com/thombashi/pytest-md-report
Author: Tsuyoshi Hombashi
Author-email: tsuyoshi.hombashi@gmail.com
License: MIT License
Project-URL: Source, https://github.com/thombashi/pytest-md-report
Project-URL: Tracker, https://github.com/thombashi/pytest-md-report/issues
Keywords: pytest,plugin,markdown
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.5
Description-Content-Type: text/x-rst
Requires-Dist: pytablewriter (<1,>=0.52.0)
Requires-Dist: pytest (<6,>=3.3.2)
Requires-Dist: typepy (<2,>=1.1.1)
Provides-Extra: test

.. contents:: **pytest-md-report**
   :backlinks: top
   :depth: 2


Summary
============================================
.. image:: https://badge.fury.io/py/pytest-md-report.svg
    :target: https://badge.fury.io/py/pytest-md-report
    :alt: PyPI package version

.. image:: https://img.shields.io/pypi/pyversions/pytest-md-report.svg
    :target: https://pypi.org/project/pytest-md-report
    :alt: Supported Python versions

.. image:: https://img.shields.io/pypi/implementation/pytest-md-report.svg
    :target: https://pypi.org/project/pytest-md-report
    :alt: Supported Python implementations

.. image:: https://img.shields.io/travis/thombashi/pytest-md-report/master.svg?label=Linux/macOS%20CI
    :target: https://travis-ci.org/thombashi/pytest-md-report
    :alt: Linux/macOS CI status

.. image:: https://img.shields.io/appveyor/ci/thombashi/pytest-md-report/master.svg?label=Windows%20CI
    :target: https://ci.appveyor.com/project/thombashi/pytest-md-report/branch/master
    :alt: Windows CI status

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


Installation
============================================
::

    pip install pytest-md-report


Usage
============================================
::

    $ pytest --md-report examples/

.. figure:: ss/pytest_md_report_example.png
    :scale: 80%
    :alt: https://github.com/thombashi/pytest-md-report/blob/master/ss/pytest_md_report_example.png

    Output example

Increase verbosity level:

::

    $ pytest -v --md-report examples/

.. figure:: ss/pytest_md_report_example_verbose.png
    :scale: 80%
    :alt: https://github.com/thombashi/pytest-md-report/blob/master/ss/pytest_md_report_example_verbose.png

    Output example (verbose)


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.


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.


Example of ``setup.cfg``:

::

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


Dependencies
============================================
Python 3.5+

- `pytablewriter <https://github.com/thombashi/pytablewriter>`__
- `pytest <https://docs.pytest.org/en/latest/>`__
- `typepy <https://github.com/thombashi/typepy>`__


