This patch updates/adds the contributor documentation to follow
the guidelines of the Ussuri cycle community goal[1].

[1] https://governance.openstack.org/tc/goals/selected/ussuri/project-ptl-and-contrib-docs.html

Story: #2007236
Task: #38517
Change-Id: I8a5dbb8b2614119d19c37ef197db3809d2d5a50d

UPPER_CONSTRAINTS_FILE is old name and deprecated
This allows to use upper-constraints file as more
readable way instead of UPPER_CONSTRAINTS_FILE=<lower-constraints file>.

Change-Id: I378644df79feae8f90b4eba60bb979f5c9fbc60a

Setuptools v54.1.0 introduces a warning that the use of dash-separated
options in 'setup.cfg' will not be supported in a future version [1].
Get ahead of the issue by replacing the dashes with underscores. Without
this, we see 'UserWarning' messages like the following on new enough
versions of setuptools:

  UserWarning: Usage of dash-separated 'description-file' will not be
  supported in future versions. Please use the underscore name
  'description_file' instead

[1] https://github.com/pypa/setuptools/commit/a2e9ae4cb

Change-Id: I47bfd89850444ba894f54d373658bea2a1573ac0

We have stable/victoria and stable/wallaby released so we
should add their job on master gate to keep branchless
tempest plugins compatible to those branch.

This also removes the stable/stein job as that is in EM
state now.

Ref: Tempest plugins guide for stable branch testing:
- https://docs.openstack.org/tempest/latest/stable_branch_testing_policy.html

Change-Id: I2bd157aab1ec857fcb2acc0dcffc23b0cf1bab8f

Moving on py3 as the default runtime for tox to avoid to update this at
each new cycle.

Wallaby support officially the following runtimes [1]:
- Python 3.6
- Python 3.8

During Victoria Python 3.7 was used as the default runtime [2] however this
version isn't longer officially supported.

[1] https://governance.openstack.org/tc/reference/runtimes/wallaby.html#python-runtimes-for-wallaby
[2] https://governance.openstack.org/tc/reference/runtimes/victoria.html#python-runtimes-for-victoria

Change-Id: Ifa518bcfbb42030faa847d7d808d25c51ec3b69c

We need to specify doc requirements in doc/requirements.txt
to avoid problems with the pip resolver [1] for the release team [2][3].
Removed specific doc requirements from test-requirements.txt.

The problem here is that this repos haven't doc/requirements.txt file
and by default in this case zuul will use the test-requirements.txt file
to pull requirements [4].

This requirements file contains extra requirements like flake8 that
collided with those allowed in our job environment and so the new pip
resolver fails to install these requirements and the job exits in error.

This project meet the conditions leading to the bug however it doesn't
produce any doc or releasenotes, but uniformization can't hurt and help
us in the future.

/!\/!\/!\
Notice that I voluntarily added the doc directory even if no docs
are generated here because zuul will try to pull this requirements from
there first and the contained requirements are needed for reno but AFAIK
the releasenotes dir is ignored by zuul. c.f [4] for further details.
/!\/!\/!\

[1] http://lists.openstack.org/pipermail/release-job-failures/2021-January/001500.html
[2] http://lists.openstack.org/pipermail/openstack-discuss/2021-January/019611.html
[3] http://lists.openstack.org/pipermail/openstack-discuss/2021-January/019612.html
[4] https://opendev.org/zuul/zuul-jobs/src/branch/master/roles/ensure-sphinx/tasks/main.yaml#L36

Change-Id: I18fdf133b6c3ea9b60e784c0e1dfb7ce1217eda5

tempest.Manager has been deprecated for more than 4 years already
and will be removed by [1].
Tempest plugins are expected to consume
tempest.lib.services.clients.ServiceClients directly.

[1] https://review.opendev.org/c/openstack/tempest/+/767628

Change-Id: Ibd04c38c084f63e9129f0bfef1df988e410695db

pep8 job is failing because the version of flake8
(flake8<2.7.0,>=2.6.0) requested by hacking<1.2.0 is not
compatible with pyflakes>=2.1.1. Therefore the patch increases
the max version of hacking.

Change-Id: I04635509cc8b794f9aaad8ac43a25bf6ddd9b9e1

As per victoria cycle testing runtime and community goal[1]
we need to migrate upstream CI/CD to Ubuntu Focal(20.04).

Fixing:
- bug#1886296
Bump the pyflakes to 2.1.1 as min version to run pep8 jobs
on py3.8 which is default python vesion in ubuntu focal.

Story: #2007865
Task: #40180

Closes-Bug: #1886296
[1] https://governance.openstack.org/tc/goals/selected/victoria/migrate-ci-cd-jobs-to-ubuntu-focal.html

Change-Id: I5628be1786bc098232db44d0b74b1b2d0b828bbd

Change-Id: I60c05d6978ac8e230bc661abaaefeae6e9d2f364

Supported stable branches in maintenance state
(stein, train, ussuri) use the Tempest and plugins master
version for their testing. To make sure master version (new
tests or any changes) is compatible with stable branch testing,
we need to add the stable branches job on the plugins master gate.
Tempest and many other plugins are already testing the stable
branches in same way[1].

Ussuri onwards, Tempest or plugins are py3 only, so we are
running only python3 version of stable jobs

Tempest plugins guide for stable branch testing:
- https://docs.openstack.org/tempest/latest/stable_branch_testing_policy.html

 [1] https://opendev.org/openstack/tempest/src/commit/e8f1876aa6772077f85f380677b30251c2454505/.zuul.yaml#L646

Change-Id: Ib55ee338e788fe9c529bdc0f12bc91899d6c8618

This commit removes .testr.conf since this repo already has
.stestr.conf. We just need .stestr.conf instead of .testr.conf.

Change-Id: Ia718139547f7435db3146fd8a9cb6f9a40185f52

This commit cleanup requirement file and add
ignore_basepython_conflict flag into tox to avoid
python version conflct.

Change-Id: Ie7a80ac58dc425e66cf2b7334b99e22a07759dbc

This drops python2.7 support for cloudkitty-tempest-plugin. The lowest python
version now supported by cloudkitty-tempest-plugin is 3.6.

Depends-On: https://review.opendev.org/#/c/694434/
Change-Id: I2b4a57dae3f150b22c38cc2b83747ee4231b31fe

For convenience we split the tests between the two current versions
of CloudKitty.

Change-Id: Ib10a6ffe9e0dd6c628f05588b463230139bf42c8
Story: 2006578
Task: 36895

This updates the cloudkitty tempest jobs. Work items:

* Rename existing jobs
* Add jobs introduced by https://review.opendev.org/#/c/679085/

Change-Id: Iec6ae6ca8ff1d4f956081daed08d8ae534fa10aa

For more detail, see http://lists.openstack.org/pipermail/openstack-discuss/2019-May/006478.html

Change-Id: I4d5d24e96715b80b29a1996715a59f2a840ee22c

Change-Id: I999f3d4108151992e791ec179b52e956f7de3d39

1. Sync sphinx dependency with global requirements. It caps python 2 since
sphinx 2.0 no longer supports Python 2.7.
2. Update some URLs to latest

Change-Id: I6c1ed891087602ec0a9bf8b53445fa4aef2b1f6c

Change-Id: Ifde285715ea5618e6c1fc5135a9996deed2cc0ba

Change-Id: I837c7c1aff4d58ca36639a5e82340ef756ab6a47

This commit was bulk generated and pushed by the OpenDev sysadmins
as a part of the Git hosting and code review systems migration
detailed in these mailing list posts:

http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html
http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html

Attempts have been made to correct repository namespaces and
hostnames based on simple pattern matching, but it's possible some
were updated incorrectly or missed entirely. Please reach out to us
via the contact information listed at https://opendev.org/ with any
questions you may have.

Depends-On: https://review.openstack.org/#/c/634885/
Change-Id: I9dc8f53ae3a8f5e3d56d5f236c0ec9c3e4929441

The response body must be converted to a string before replacing characters in
it.

Depends-On: 634885
Change-Id: I078e7571179e3ef209c104a0a5426ae6fb9b63d8

Change-Id: Ic7dd0993dbd424e55228ccc8d28315624566ebc3

Change-Id: Iec776464a9b2b2760e31bbb1f1ba892bce3e504a

Change-Id: I17e8a6861e61624e31d7e93c3598749f2d18e145

In setup.cfg file the python 3.5 is added
In tox.ini the python 3.5 is added

Change-Id: I0b5d3002486ff43a36f7fabec30e7884c67abdd9

This is a mechanically generated patch to complete step 1 of moving
the zuul job settings out of project-config and into each project
repository.

Because there will be a separate patch on each branch, the branch
specifiers for branch-specific jobs have been removed.

Because this patch is generated by a script, there may be some
cosmetic changes to the layout of the YAML file(s) as the contents are
normalized.

See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html

Change-Id: I327a903cee4741b9ff5ce68213893a990cd2ad0e
Story: #2002586
Task: #24289

We want to default to running all tox environments under python 3, so
set the basepython value in each environment.

We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.

We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.

Change-Id: I7332a020602c3171825e842df7d23dc4950eb597