Metadata-Version: 2.2
Name: pytest-beakerlib
Version: 0.7.1
Summary: A pytest plugin that reports test results to the BeakerLib framework
Home-page: https://pagure.io/python-pytest-beakerlib
Author: Petr Viktorin
Author-email: pviktori@redhat.com
License: GPL
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Quality Assurance
License-File: COPYING
Requires-Dist: pytest
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: summary

A pytest plugin that reports test results to the BeakerLib framework.

* pytest: http://pytest.org/latest/
* BeakerLib: https://fedorahosted.org/beakerlib/

Once installed, this plugin can be activated via the ``--with-beakerlib`` option.
This requires a BeakerLib session (i.e. ``rlJournalStart`` should have been run,
so that ``$BEAKERLIB`` is set)


Downloading
-----------

Release tarballs are available for download from Fedora Hosted:
    https://pagure.io/releases/python-pytest-beakerlib/

You can also install using pip:
    https://pypi.python.org/pypi/pytest-beakerlib/0.2

The plugin is also available in Fedora repositories as
``python3-pytest-beakerlib``.


Operation
---------

A Bash process is run on the side, and BeakerLib commands (``rlPhaseStart``,
``rlPhaseEnd``, ``rlPass``, ``rlFail``, ...) are fed to it.
This is not very elegant, but since BeakerLib commands are Bash functions,
there is no way around running Bash.


Integration
-----------

Other plugins may integrate with this using pytest's
``config.pluginmanager.getplugin('BeakerLibPlugin')``. If this is ``None``,
BeakerLib integration is not active, otherwise the result's
``run_beakerlib_command`` method can be used to run additional commands.


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

The project is happy to accept patches!
Please file any patches as Pull Requests on the project's `Pagure repo`_.
Any development discussion should be in Pagure Pull Requests and Issues.


Developer links
---------------

  * Bug tracker: https://pagure.io/python-pytest-beakerlib/issues
  * Code browser: https://pagure.io/python-pytest-beakerlib/tree/master
  * git clone https://pagure.io/python-pytest-beakerlib.git
  * Unstable packages for Fedora: https://copr.fedoraproject.org/coprs/pviktori/pytest-plugins/

To release, update version in setup.py, add a Git tag like "v0.3",
and run `make tarball`.
Running `make upload` will put the tarball to Fedora Hosted and PyPI,
and a SRPM on Fedorapeople, if you have the rights.
Running `make release` will upload and fire a COPR build.

.. _Pagure repo: https://pagure.io/python-pytest-beakerlib
