Metadata-Version: 2.0
Name: goodplay
Version: 0.5.0
Summary: goodplay enables you to test your deployments and distributed software infrastructure by reusing your existing knowledge of ansible.
Home-page: https://goodplay.io/
Author: Benjamin Schwarze
Author-email: benjamin.schwarze@mailboxd.de
License: Apache License 2.0
Keywords: goodplay,good,play,test,deployment,ansible,playbook,role,integration,system,tdd,configuration,management
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Requires-Dist: ansible (>=2.0.0)
Requires-Dist: cached-property (>=1.3.0)
Requires-Dist: docker-py (>=1.6.0,<=1.7.0)
Requires-Dist: py (>=1.4.31)
Requires-Dist: pytest (>=2.8.5)
Requires-Dist: sarge (>=0.1.4)

goodplay
========

|gitter| |build-status| |version| |docs| |license| |code-climate| |code-coverage| |dependencies-status| |donate|

goodplay is an Apache2-licensed test framework for testing Ansible 2.x roles
and playbooks as well as running full integration tests for your software.

.. |build-status| image:: https://img.shields.io/travis/goodplay/goodplay/master.svg
    :alt: Build Status
    :scale: 100%
    :target: https://travis-ci.org/goodplay/goodplay

.. |code-climate| image:: https://img.shields.io/codeclimate/github/goodplay/goodplay.svg
    :alt: Code Climate
    :scale: 100%
    :target: https://codeclimate.com/github/goodplay/goodplay

.. |code-coverage| image:: https://img.shields.io/codecov/c/github/goodplay/goodplay.svg
    :alt: Code Coverage
    :scale: 100%
    :target: https://codecov.io/github/goodplay/goodplay

.. |dependencies-status| image:: https://img.shields.io/requires/github/goodplay/goodplay.svg?label=dependencies
    :alt: Dependencies Status
    :scale: 100%
    :target: https://requires.io/github/goodplay/goodplay/requirements/

.. |docs| image:: https://img.shields.io/badge/docs-latest-brightgreen.svg
    :alt: Documentation
    :scale: 100%
    :target: https://docs.goodplay.io/

.. |donate| image:: https://img.shields.io/badge/donate_via_paypal-$5-yellow.svg
    :alt: Donate via PayPal
    :scale: 100%
    :target: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=SDQVYJQBMHVX2

.. |gitter| image:: https://badges.gitter.im/goodplay/goodplay.svg
    :alt: Join the chat at https://gitter.im/goodplay/goodplay
    :scale: 100%
    :target: https://gitter.im/goodplay/goodplay?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

.. |license| image:: https://img.shields.io/pypi/l/goodplay.svg
    :alt: License
    :scale: 100%
    :target: https://github.com/goodplay/goodplay/blob/master/LICENSE

.. |version| image:: https://img.shields.io/pypi/v/goodplay.svg
    :alt: Version
    :scale: 100%
    :target: https://pypi.python.org/pypi/goodplay


Features
--------

* define your test environments as `Ansible inventories`_
* write your tests as `Ansible 2.x playbook tasks`_
* resolve and auto-install Ansible role dependencies prior to test run
* run your tests within Docker_ container(s) or on localhost
* built as a pytest_ plugin, so you can run your goodplay tests together with your other tests

.. _`Ansible 2.x playbook tasks`: https://docs.ansible.com/playbooks.html
.. _`Ansible inventories`: https://docs.ansible.com/ansible/intro_inventory.html
.. _Docker: https://www.docker.com/
.. _pytest: https://pytest.org/


Versioning
----------

goodplay will use `Semantic Versioning`_ when reaching v1.0.0.
Until then, the minor version is used for backwards-incompatible changes.

.. _`Semantic Versioning`: http://semver.org/


Installation
------------

Installing goodplay is simple with pip_, just run this in your terminal:

.. code-block:: bash

    $ pip install goodplay

.. _pip: https://pip.readthedocs.org/


Documentation
-------------

Documentation is available at https://docs.goodplay.io/.


Roadmap
-------

- better error messages, without the clutter
- support to keep test environment running for debugging purposes
- support full-fledged virtual machine within a Docker container (see `RancherVM`_)

.. _`RancherVM`: https://github.com/rancher/vm


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

#. Check for open issues or open a fresh issue to start a discussion around a
   feature idea or bug.
#. Fork `the repository`_ on GitHub to start making your changes to the
   ``master`` branch (or branch off of it).
#. Write a test which shows that the bug was fixed or that the feature works
   as expected.
#. Send a pull request. Make sure to add yourself to AUTHORS_.

Just don't forget to check out our `CONTRIBUTING`_ guidelines — it includes
few technical details that will make the process a lot smoother.

.. _`the repository`: https://github.com/goodplay/goodplay
.. _AUTHORS: https://github.com/goodplay/goodplay/blob/master/AUTHORS.rst
.. _CONTRIBUTING: https://github.com/goodplay/goodplay/blob/master/CONTRIBUTING.rst


