Metadata-Version: 1.1
Name: pytest-html
Version: 1.9.0
Summary: pytest plugin for generating HTML reports
Home-page: https://github.com/pytest-dev/pytest-html
Author: Dave Hunt
Author-email: dhunt@mozilla.com
License: Mozilla Public License 2.0 (MPL 2.0)
Description: pytest-html
        ===========
        
        pytest-html is a plugin for `py.test <http://pytest.org>`_ that generates a
        HTML report for the test results.
        
        .. image:: https://img.shields.io/badge/license-MPL%202.0-blue.svg
           :target: https://github.com/pytest-dev/pytest-html/blob/master/LICENSE
           :alt: License
        .. image:: https://img.shields.io/pypi/v/pytest-html.svg
           :target: https://pypi.python.org/pypi/pytest-html/
           :alt: PyPI
        .. image:: https://img.shields.io/travis/pytest-dev/pytest-html.svg
           :target: https://travis-ci.org/pytest-dev/pytest-html/
           :alt: Travis
        .. image:: https://img.shields.io/github/issues-raw/pytest-dev/pytest-html.svg
           :target: https://github.com/pytest-dev/pytest-html/issues
           :alt: Issues
        .. image:: https://img.shields.io/requires/github/pytest-dev/pytest-html.svg
           :target: https://requires.io/github/pytest-dev/pytest-html/requirements/?branch=master
           :alt: Requirements
        
        Outreachy
        ---------
        
        Mozilla is participating in the `Outreachy <http://www.outreachy.org>`_ program
        helping people from groups underrepresented in free and open source software
        to get involved. For the round running `May 23 to August 23, 2016 <https://wiki.gnome.org/Outreachy/2016/MayAugust>`_,
        there is `a project <https://wiki.mozilla.org/Outreachy#Enhancements_to_Python_testing_tool_plugin_for_generation_of_HTML_reports>`_
        to work on `several enhancements <https://github.com/pytest-dev/pytest-html/labels/outreachy>`_ to pytest-html.
        
        Requirements
        ------------
        
        You will need the following prerequisites in order to use pytest-html:
        
        - Python 2.6, 2.7, 3.3, 3.4, 3.5, PyPy, or PyPy3
        - py.test 2.7 or newer
        
        Installation
        ------------
        
        To install pytest-html:
        
        .. code-block:: bash
        
          $ pip install pytest-html
        
        Then run your tests with:
        
        .. code-block:: bash
        
          $ py.test --html=report.html
        
        Enhancing reports
        -----------------
        
        You can add change the *Environment* section of the report by modifying
        ``request.config._html.environment`` from a fixture:
        
        .. code-block:: python
        
          @pytest.fixture(autouse=True)
          def _environment(request):
              request.config._environment.append(('foo', 'bar'))
        
        You can add details to the HTML reports by creating an 'extra' list on the
        report object. The following example adds the various types of extras using a
        :code:`pytest_runtest_makereport` hook, which can be implemented in a plugin or
        conftest.py file:
        
        .. code-block:: python
        
          import pytest
          @pytest.mark.hookwrapper
          def pytest_runtest_makereport(item, call):
              pytest_html = item.config.pluginmanager.getplugin('html')
              outcome = yield
              report = outcome.get_result()
              extra = getattr(report, 'extra', [])
              if report.when == 'call':
                  # always add url to report
                  extra.append(pytest_html.extras.url('http://www.example.com/'))
                  xfail = hasattr(report, 'wasxfail')
                  if (report.skipped and xfail) or (report.failed and not xfail):
                      # only add additional html on failure
                      extra.append(pytest_html.extras.html('<div>Additional HTML</div>'))
                  report.extra = extra
        
        Screenshots
        -----------
        
        .. image:: https://cloud.githubusercontent.com/assets/122800/11952194/62daa964-a88e-11e5-9745-2aa5b714c8bb.png
           :target: https://cloud.githubusercontent.com/assets/122800/11951695/f371b926-a88a-11e5-91c2-499166776bd3.png
           :alt: Enhanced HTML report
        
        Resources
        ---------
        
        - `Release Notes <http://github.com/pytest-dev/pytest-html/blob/master/CHANGES.rst>`_
        - `Issue Tracker <http://github.com/pytest-dev/pytest-html/issues>`_
        - `Code <http://github.com/pytest-dev/pytest-html/>`_
        
Keywords: py.test pytest html report
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Operating System :: POSIX
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
