openstack
/
python-glanceclient
Code Issues Proposed changes
python-glanceclient/glanceclient/tests/functional
History
Andreas Jaeger 82da2378ea Update hacking for Python3 
The repo is Python 3 now, so update hacking to version 3.0 which
supports Python 3.

Fix problems found.

Remove hacking and friends from lower-constraints, they are not needed
for installation.

Change-Id: I5ae47a7b11ff29a301e440c15daf30db7738485b
 		2020-04-02 15:48:09 +02:00
..
v1 Update hacking for Python3 2020-04-02 15:48:09 +02:00
v2 Update hacking for Python3 2020-04-02 15:48:09 +02:00
README.rst Revise functional testing README file 2017-12-15 16:03:45 -05:00
__init__.py Create functional test base 2015-04-18 17:43:01 +00:00
base.py Split glanceclient functional tests 2018-03-28 22:32:44 -04:00

README.rst

python-glanceclient functional testing

Idea

Run real client/server requests in the gate to catch issues which are difficult to catch with a purely unit test approach.

Many projects (nova, keystone...) already have this form of testing in the gate.

Testing Theory

Since python-glanceclient has two uses, CLI and python API, we should have two sets of functional tests. CLI and python API. The python API tests should never use the CLI. But the CLI tests can use the python API where adding native support to the CLI for the required functionality would involve a non trivial amount of work.

Functional Test Guidelines

The functional tests require:

  1. A working Glance/Keystone installation (for example, devstack)
  2. A yaml file containing valid credentials

If you are using devstack, a yaml file will have been created for you with the name /etc/openstack/clouds.yaml. The test code knows where to find it, so if you're using devstack, you don't need to do anything else.

If you are not using devstack you should create a yaml file with the following format:

clouds:
devstack-admin:
auth:

auth_url: http://10.0.0.1:35357/v2.0 password: example project_domain_id: default project_name: admin user_domain_id: default username: admin

identity_api_version: '2.0' region_name: RegionOne

The tests will look for a file named 'clouds.yaml' in the following locations (in this order, first found wins):

  • current directory
  • ~/.config/openstack
  • /etc/openstack

You may also set the environment variable OS_CLIENT_CONFIG_FILE to the absolute pathname of a file and that location will be inserted at the front of the search list.