Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/encukou/pytest-beakerlib


https://github.com/encukou/pytest-beakerlib

Last synced: 27 days ago
JSON representation

Awesome Lists containing this project

README

        

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

* pytest: http://pytest.org/latest/
* BeakerLib: https://github.com/beakerlib/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