[openstack-dev] [qa][tempest] "kwargs" of service clients for POST/PUT methods

Ken'ichi Ohmichi ken1ohmichi at gmail.com
Thu Jul 9 00:39:35 UTC 2015

2015-07-08 16:42 GMT+09:00 Ken'ichi Ohmichi <ken1ohmichi at gmail.com>:
> 2015-07-08 14:07 GMT+09:00 GHANSHYAM MANN <ghanshyammann at gmail.com>:
>> On Wed, Jul 8, 2015 at 12:27 PM, Ken'ichi Ohmichi <ken1ohmichi at gmail.com> wrote:
>>> By defining all parameters on each method like update_quota_set(), it
>>> is easy to know what parameters are available from caller/programer
>>> viewpoint.
>> I think this can be achieved with former approach also by defining all
>> expected param in doc string properly.
> You are exactly right.
> But current service clients contain 187 methods *only for Nova* and
> most methods don't contain enough doc string.
> So my previous hope which was implied was we could avoid writing doc
> string with later approach.

I am thinking it is very difficult to maintain doc string of REST APIs
in tempest-lib because APIs continue changing.
So instead of doing it, how about putting the link of official API
document[1] in tempest-lib and concentrating on maintaining official
API document?
OpenStack APIs are huge now and It doesn't seem smart to maintain
these docs at different places.

Ken Ohmichi

[1]: http://developer.openstack.org/api-ref.html

More information about the OpenStack-dev mailing list