Metadata-Version: 2.1
Name: pytest-rpc
Version: 0.8.0rc0
Summary: Extend py.test for RPC OpenStack testing.
Home-page: https://github.com/rcbops/pytest-rpc
Author: rpc-automation
Author-email: rpc-automation@rackspace.com
License: Apache Software License 2.0
Keywords: py.test pytest pytest-rpc
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Requires-Dist: pytest (>=3.5.0)
Requires-Dist: setuptools
Requires-Dist: sh

==========
pytest-rpc
==========

.. image:: https://travis-ci.org/rcbops/pytest-rpc.svg?branch=master
    :target: https://travis-ci.org/rcbops/pytest-rpc
    :alt: See Build Status on Travis CI

Extend py.test for RPC OpenStack testing.

Quick Start Guide
-----------------

1. You can install "pytest-rpc" via `pip`_ from `PyPI`_ ::

    $ pip install pytest-rpc

2. Or you can install "pytest-rpc" via `pip`_ from disk (assumes you're in the root of the repo)::

    $ pip install -e .

Usage
-----

Once installed the plug-in will automatically be loaded by all ``py.test`` test runs executed in the Python environment
in which the ``pytest-rpc`` was installed.

Features
--------

JUnitXML RPC Specific Properties
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

If a user executes ``py.test`` tests with the ``--junitxml`` and with this plug-in installed, the resulting XML log file
will contain a test suite properties element. The properties element will contain information gathered about the test
run fetched from the local environment.

Configuration
^^^^^^^^^^^^^

You can configure this plugin to tell it which 'ci-environment' you are using when you execute this test.  This will let
pytest-rpc know what information to collect inside of the junit.xml.  If no configuration is found it will assume
that you are using asc.

1. You can configure in an ini file that is readable by pytest (setup.cfg, pytest.ini, tox.ini)::

    [pytest]
    ci-environment=mk8s

2. You can configure via the command line::

    pytest /path/to/test_test.py --ci-environment=asc

3. The current available options are 'asc' & 'mk8s'

Contributing
------------

See `CONTRIBUTING.rst`_ for more details on developing for the "pytest-rpc" project.

Release Process
---------------

See `release_process.rst`_ for information on the release process for 'pytest-rpc'

Credits
-------

This `Pytest`_ plugin was generated with `Cookiecutter`_ along with `@hackebrot`_'s `Cookiecutter-pytest-plugin`_ template.

.. _CONTRIBUTING.rst: CONTRIBUTING.rst
.. _release_process.rst: docs/release_process.rst
.. _`Cookiecutter`: https://github.com/audreyr/cookiecutter
.. _`@hackebrot`: https://github.com/hackebrot
.. _`MIT`: http://opensource.org/licenses/MIT
.. _`BSD-3`: http://opensource.org/licenses/BSD-3-Clause
.. _`GNU GPL v3.0`: http://www.gnu.org/licenses/gpl-3.0.txt
.. _`Apache Software License 2.0`: http://www.apache.org/licenses/LICENSE-2.0
.. _`cookiecutter-pytest-plugin`: https://github.com/pytest-dev/cookiecutter-pytest-plugin
.. _`pytest`: https://github.com/pytest-dev/pytest
.. _`tox`: https://tox.readthedocs.io/en/latest/
.. _`pip`: https://pypi.python.org/pypi/pip/
.. _`PyPI`: https://pypi.python.org/pypi


=======
History
=======


