blob: 53cb54b785fc2b3fe4fe985aa5b8cb0fdff54d30 [file] [log] [blame]
Masayuki Igawac268dd62013-09-18 00:51:05 +09001Tempest Field Guide to Third Party API tests
2============================================
Sean Dague09761f62013-05-13 15:20:40 -04003
4
5What are these tests?
Attila Fazekas58d23302013-07-24 10:25:02 +02006---------------------
Sean Dague09761f62013-05-13 15:20:40 -04007
8Third party tests are tests for non native OpenStack APIs that are
9part of OpenStack projects. If we ship an API, we're really required
10to ensure that it's working.
11
12An example is that Nova Compute currently has EC2 API support in tree,
13which should be tested as part of normal process.
14
15
16Why are these tests in tempest?
Attila Fazekas58d23302013-07-24 10:25:02 +020017-------------------------------
Sean Dague09761f62013-05-13 15:20:40 -040018
19If we ship an API in an OpenStack component, there should be tests in
20tempest to exercise it in some way.
21
22
23Scope of these tests
Attila Fazekas58d23302013-07-24 10:25:02 +020024--------------------
Sean Dague09761f62013-05-13 15:20:40 -040025
26Third party API testing should be limited to the functional testing of
27third party API compliance. Complex scenarios should be avoided, and
28instead exercised with the OpenStack API, unless the third party API
29can't be tested without those scenarios.
30
31Whenever possible third party API testing should use a client as close
32to the third party API as possible. The point of these tests is API
33validation.