When Tempest is used in customer site, often we are required to
provide a testcase list including testcase names and descriptions.
Now no this kind of doc is available, so we can add descriptions
with the format of doc string for every testcase, so later we
can generata such a testcase description list.

There are hundreds of testcases missing descriptions, so we can
add them gradually, and limit the modified files in one patch
for the convenience of reviewing.

Change-Id: I20744e4957fbd5b039fdd52ac530f11ac6d72319
partially-implements: blueprint testcase-description

1. Some limits fields are removed from Microversion 2.35/2.38/2.56,
   so we should check limits fields according to microversion.
2. In test_max_metadata_exceed_limit, maxImageMeta is deprecated from
   Microversion 2.38, so maxServerMeta is used instead, btw, maxServerMeta
   seems to be more suitable for this testcase.
   Besides, test_max_metadata_exceed_limit is not used in interop, so we
   can safely change its name.

ref: https://developer.openstack.org/api-ref/compute/#show-rate-and-absolute-limits

Implements blueprint: clear-deprecated-api

Change-Id: I53e2ee82c9c52afb0a56526c655eb9b3b6b8f483

This commit makes to use assert(Not)Empty() or assertIsNotNone() instead
of assert(Not)Equal(0, len(LIST),..) or assertGreaterEqual(0, len()...).
The original code asserts the specified list is empty or not. And we
already have assert(Not)Empty() for it. The method names
"assert(Not)Empty" are straightforward and easy to understand. It makes
the code clean and the assert message could be easier to understand what
is happen than original ones.

Change-Id: I715ec84d9139b1d196275e91212ab40d52a545e1

So many modules are using test.idempotent_id and this is for
switching to decorators.idempotent_id on compute.*.

Change-Id: Ib4ace375a41b9607d1b1cea7dda296fb601a0264
Related-Bug: #1616913

Limits about server groups are missing in test_absLimits_get,
see
http://developer.openstack.org/api-ref/compute/?expanded=
show-rate-and-absolute-limits-detail#show-rate-and-absolute-limits

This is to add missing limit items about server group.

Change-Id: If7f62293daa82cdca848d141216dd75386d452ed

Currently compute limits and migration client returns Response by
removing top key from Response.
For example-
 return service_client.ResponseBody(resp, body['limits'])

As service clients are in direction to move to Tempest-lib, all
service clients should return Response without any truncation.
One good example is Resource pagination links which are lost with current
way of return value. Resource pagination links are present in parallel
(not inside) to top key of Response.

This patch makes compute limits and migration client to return complete
Response body.

Change-Id: Ice3665e91ff34409f6f105303213303d1fca1816
Implements: blueprint method-return-value-and-move-service-clients-to-lib

limits client should be just for getting a resource "limits",
it is not necessary to specify key 'absolute' at all as the library
method.
In addition, this patch removes get_specific_absolute_limit because
the method was just wrapper. That should be implemented on test side.

Change-Id: I5c0ffc136939d0aeb8574c180353715f2a0e2665

[GET /resources] methods should be "list_<resource name>s"
or "show_<resource name>", so this patch applies the rule
to compute clients which name is "limits".

Partially implements blueprint consistent-service-method-names

Change-Id: Ibe30d01057936cea68f38984064dff107cdcbe5c

This removes all bare gate attribute tags from functions, the gate tag
was a never fully implemented idea in the past, and it's existence in
the code mostly just confuses people.

Change-Id: I462ca7a8cadeb5013e2bce44ed1e69bcf8f9d968

Adds uuid4 as a decorator of the form:
@test.idempotent_id('12345678-1234-1234-1234-123456789abc')
to every test in the Tempest tree. Includes a gate check to
ensure the existence and uniqueness of the ids.

Modify check tool to ignore Tempest unit tests.

Change-Id: I19e3c7dd555a3ea09d585fb9091c357a300e6559
Co-Authored-By: Sergey Slipushenko <sslypushenko@mirantis.com>
Implements: bp test-uuid