systest

|buildstatus|_

Installation

.. code-block:: python

pip install systest

Description

Execute a sequence of test cases in serial and/or parallel.

Test cases in a list are executed in serial and test cases in a tuple are executed in parallel, in separate Python threads.

This framework is created with integration/system test in mind. The framework is not intended as a replacement for unittest, but rather to be a complement to it.

Documentation: http://systest.readthedocs.org/en/latest

Example usage

See the test suite: https://github.com/eerimoq/systest/blob/master/tests/test_systest.py

For example, the sequence below starts with test case MyTestCase("1"). When MyTestCase("1") has been executed, MyTestCase("2") and the list of MyTestCase("3") and MyTestCase("4") are executed in parallel. When both MyTestCase("2") and the list of MyTestCase("3") and MyTestCase("4") has been executed, MyTestCase("5") is executed. Then the sequence ends.

.. code-block:: python

import logging import systest

LOGGER = logging.getLogger(name)

Define a testcase.

class MyTestCase(systest.TestCase): """Test case description.

   """

   def __init__(self, name):
       super(MyTestCase, self).__init__()
       self.name = "my_testcase_" + name

   def run(self):
       LOGGER.info("Hello!")
       self.assert_equal(1, 1)
       self.assert_true(1 == 1)
       self.assert_in(1 in [1, 2])
       self.assert_none(None)

       with self.assert_raises(RuntimeError) as cm:
           raise RuntimeError('foo')

       self.assert_equal(str(cm.exception), 'foo')

sequencer = systest.setup("my_sequence")

sequencer.run(MyTestCase("1"), ( MyTestCase("2"), [ MyTestCase("3"), MyTestCase("4") ] ), MyTestCase("5"))

sequencer.report_and_exit()

The output is:

.. code-block:: text

Name: my_sequence Date: 2020-05-30 11:41:49.712832 Node: erik-GR8 User: erik

---

Name: my_testcase_1 Description:

   Test case description.

Hello!

my_testcase_1: PASSED in 0 seconds

---

Name: my_testcase_2 Description:

   Test case description.

Hello!

my_testcase_2: PASSED in 0 seconds

---

Name: my_testcase_3 Description:

   Test case description.

Hello!

my_testcase_3: PASSED in 0 seconds

---

Name: my_testcase_4 Description:

   Test case description.

Hello!

my_testcase_4: PASSED in 0 seconds

---

Name: my_testcase_5 Description:

   Test case description.

Hello!

my_testcase_5: PASSED in 0 seconds

---------------------- Test summary begin ----------------------

[ my_testcase_1: PASSED in 0 seconds, ( my_testcase_2: PASSED in 0 seconds, [ my_testcase_3: PASSED in 0 seconds, my_testcase_4: PASSED in 0 seconds ] ), my_testcase_5: PASSED in 0 seconds ]

Execution time: 0.02 seconds Result: PASSED (5 passed, 5 total)

----------------------- Test summary end -----------------------

.. |buildstatus| image:: https://travis-ci.org/eerimoq/systest.svg .. _buildstatus: https://travis-ci.org/eerimoq/systest