Running Tests

This repo currently has 3 type of tests but more may follow

First unit tests can be run with your envs default python like this

``tox -e py3``  or  ``tox -e unit``

it also possible to you a non default python version by specifying a version sufix

tox -e py312

The second type of testing is functional testing. Where as unit tests should be short and test individual functions. Functional tests should avoid mocking code in the plugin but can use fixtures or other fakes/proxy to replace external systems like a fake datasoures that returns static data or emulates an openstack service like keystone.

functional tests can be run in a similar way to unit tests

``tox -e functional`` or ``tox -e functional-py312``

The third type of testing we have today are style/lint checks. there are 3 ways to run these checks first with tox

``tox -e pep8`` or ``tox -e lint``

by convention in openstack we use a pep8 tox env to execute all our style and linting checks not just pep8. in many other communities this is often called lint so we support both.

internally both targets are identical and call pre-commit to run the style checks. So the third way to run the style checks is with pre-commit directly:

``pre-commit run -a``

or if you have the hooks installed they will run automatically when you commit a change. If you ever want to override that behavior you can do:

 #skip all checks
 git commit --no-verify

 or

 # skip a single check
 SKIP=hacking git commit

.. NOTE::

   unit, functional and style checks are enforced by our zuul
   CI system so if they don't pass your code cant merge.
   CI just run the tox command the same as you can do locally
   so its encouraged to run them locally first.

DOCS

docs are built via tox envs that wrap a tool called sphinx. At present we have two types of docs, general docs are stored in the doc folder and release notes that are generated by the reno tool are stored in the releasenotes directory. As can be seen form this README we use a format called reStructuredText to write all our docs.

The main docs can be built with either tox -e docs or tox -e pdf-docs depending on the desired format. Note that to be able to build PDF docs in particular you may need to install binary depencies on your system. These can be found in bindep.txt in the doc and pdf-docs profiles.

The second type of docs we have are the release notes. New release-notes can be added by executing tox -e venv -- reno new your-note-name-here and built with tox -e releasenotes