tobiko/doc/source/miscellaneous/from-tempest-to-tobiko.rst
Omer b785dee6c1 Add a doc which will help tempest contributors
This patch adds a document which is supposed to help tempest
contributors to start with tobiko.

The doc mentions some big differences between tempest and tobiko.

In order to see the changed docs, please access:
Zull run -> openstack-tox-docs -> Logs tab -> docs (raw).

Change-Id: Ie757041d49199213641b347f898ea97f72c96fce
2022-06-24 14:39:23 +02:00

1.7 KiB
Raw Blame History

From Tempest to Tobiko

This doc might help programmers to embrace/join the Tobiko project, after having some experience with the Tempest project.

A few differences between Tobiko and Tempest:

  • Tobiko uses heat template stacks
    • A stack is being created "lazily" (only when it is needed in the code), unlike “resource setup” in Tempest that always creates all the resources.
  • Tobiko re-uses its resources
    • Tobiko will reuse the same resources in any possible test it can.

      Ex: if one test will create a stack, and the same stack is going to be used in different tests, Tobiko will simply reuse it. It will also reuse the same stacks during other executions of the same Tobiko tests.

  • Tobikos tests structure:
    • Tests do not require idempotent_id, each method which starts with the prefix “test” is considered to be a test which will be run.
    • After a Tobiko test suite finishes, it does not delete Tobikos resources (no teardown), and this is by design.
  • Tobiko uses a client stack
    • Traffic is being sent from a client stack that the tester may create (or a default one might be created).
  • Tobiko uses Typing:
    • Mainly as a means of code readability and consistency.

      But additional doc strings are welcome!

  • Tobiko tests workflow:
    • Tobiko uses the following workflow for its sequential test execution process:

      resource-creation->disruptive-actions->resource-verification.