Metadata-Version: 1.1
Name: python-tempestconf
Version: 1.1.3
Summary: python-tempestconf will automatically generates the tempest configuration based on your cloud.
Home-page: http://www.redhat.com/
Author: Red Hat
Author-email: rdo-list@redhat.com
License: UNKNOWN
Description-Content-Type: UNKNOWN
Description: python-tempestconf
        ==================
        
        Overview
        --------
        
        python-tempestconf will automatically generate the tempest configuration
        based on your cloud.
        
        -  Free software: Apache license
        -  Documentation:
           https://github.com/redhat-openstack/python-tempestconf/blob/master/README.rst
        -  Source: https://github.com/redhat-openstack/python-tempestconf
        -  Bugs: https://github.com/redhat-openstack/python-tempestconf/issues
        
        Usage
        -----
        
        Git
        ~~~
        
        1. Clone and change to the directory:
        
        .. code-block:: shell-session
        
            $ git clone https://github.com/redhat-openstack/python-tempestconf
            $ cd python-tempestconf
        
        2. Create virtual environment using virtualenv:
        
        .. code-block:: shell-session
        
            $ virtualenv .venv
            $ source .venv/bin/activate
        
        3. Source the newly created virtual environment and install
           requirements:
        
        .. code-block:: shell-session
        
            (.venv) $ pip install -r requirements.txt
            (.venv) $ pip install -r test-requirements.txt
        
        4. Source cloud credentials, for example:
        
        .. code-block:: shell-session
        
            (py27) $ source cloudrc
        
        5. Run python-tempestconf to generate tempest configuration file:
        
        .. code-block:: shell-session
        
            (py27) $ python config_tempest/config_tempest.py --debug identity.uri $OS_AUTH_URL \
                        identity.admin_password  $OS_PASSWORD --create
        
        After this, ``./etc/tempest.conf`` is generated.
        
        RPM Installation (RDO)
        ~~~~~~~~~~~~~~~~~~~~~~
        
        1. python-tempestconf is installed together with openstack-tempest, as
           a new dependency (starting from the Ocata release)
        
        .. code-block:: shell-session
        
            # yum -y install openstack-tempest
        
        2. Source cloud credentials, initialize tempest and run the discovery
           tool:
        
        .. code-block:: shell-session
        
            $ source cloudrc
            $ tempest init testingdir
            $ cd testingdir
            $ discover-tempest-config --debug identity.uri $OS_AUTH_URL \
                  identity.admin_password  $OS_PASSWORD --create
        
        .. note::
           In Ocata release new features were presented.
           ``discover-tempest-config`` is the new name of the **old**
           ``config_tempest.py`` script and it **accepts the same parameters.**
           More about new features can be found
           `here <https://www.rdoproject.org/blog/2017/02/testing-rdo-with-tempest-new-features-in-ocata/>`__
        
        
        os-client-config support
        ~~~~~~~~~~~~~~~~~~~~~~~~
        
        python-tempestconf supports `os-client-config <https://github.com/openstack/os-client-config>`__
        so instead of sourcing openstackrc files you can use clouds.yml files. Location where
        these files should be stored and syntax which is used to specify cloud.yaml files
        can be found `here <https://github.com/openstack/os-client-config#config-files>`__
        
        In case of git usage:
        
        .. code-block:: shell-session
        
            (py27) $ python config_tempest/config_tempest.py --debug --create --os-cloud <name of cloud>
        
        In case of RPM:
        
        .. code-block:: shell-session
        
            $ tempest init testingdir
            $ cd testingdir
            $ discover-tempest-config --debug --create --os-cloud <name of cloud>
        
        
Platform: UNKNOWN
Classifier: Environment :: OpenStack
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
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
