Metadata-Version: 2.1
Name: performa
Version: 0.0.1.dev48
Summary: Performance testing toolkit
Home-page: https://github.com/openstack/performance-docs
Author: OpenStack
Author-email: openstack-dev@lists.openstack.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: pbr (>=1.6)
Requires-Dist: ansible
Requires-Dist: iso8601 (>=0.1.9)
Requires-Dist: oslo.config (>=2.6.0)
Requires-Dist: oslo.i18n (>=1.5.0)
Requires-Dist: oslo.log (>=1.12.0)
Requires-Dist: oslo.serialization (>=1.10.0)
Requires-Dist: oslo.utils (!=2.6.0,>=2.4.0)
Requires-Dist: pygal
Requires-Dist: pymongo
Requires-Dist: PyYAML (>=3.1.0)
Requires-Dist: six (>=1.9.0)

========
Performa
========

What Performa is?
-----------------

Performa is distributed scenario runner, results processor and report generator.
It is the strong mixture of powerful technologies:
 * Ansible_ for easy running modularized code in distributed manner
 * MongoDB_ for storing and transforming data
 * Pygal_ for creating light-weight charts
 * Jinja2_ for templating the world


Example
-------

::

    performa --mongo-url 127.0.0.1 --mongo-db performa --scenario db/sysbench \
        --hosts "{target: [192.168.20.20]}" --remote-user developer --debug \
        --book doc/source/test_results/db/sysbench

This example runs Performa tool with scenario 'sb/sysbench'. It uses MongoDB
located at localhost and database named 'performa'. The scenario is executed
against remote host 192.168.20.20 which can be accessed with user 'developer'.
The report is stored into 'doc/source/test_results/db/sysbench' folder.

.. references:

.. _Ansible: http://docs.ansible.com/
.. _MongoDB: https://docs.mongodb.org/manual/
.. _Pygal: http://www.pygal.org/
.. _Jinja2: http://jinja.pocoo.org/



