e3-testsuite: User’s Manual
e3-testsuite
is a Python library built on top of e3-core
. Its purpose
it to provide building blocks for software projects to create testsuites in a
simple way. This library is generic: for instance, the tested software does not
need to use Python.
Note that this manual assumes that readers are familiar with the Python language (Python3, to be specific) and how to run scripts using its standard interpreter CPython.
Installation
e3-testsuite
is available on Pypi, so installing it is as simple as
running:
pip install e3-testsuite
How to read this documentation
The Core concepts and Tutorial sections are must read: the former introduces notions required to understand most of the documentation and the latter put them in practice, as a step-by-step guide to write a simple, but real world testsuite.
From there, brave/curious readers can go on until the end of the documentation, while readers with time/energy constraints can just go over the sections of interest for their needs.
Topics
- Core concepts
- Tutorial
e3.testsuite.result
: Create test resultse3.testsuite.driver
: Core test driver APIe3.testsuite.driver.classic
: Common test driver facilitiese3.testsuite.driver.diff
: Test driver for actual/expected outputse3.testsuite.control
: Control test executione3.testsuite
: Testsuite APIe3.testsuite.testcase_finder
: Control testcase discoverye3.testsuite.report
: reading/writing reports- Compatibility for AdaCore’s legacy testsuites
- Multiprocessing: leveraging many cores
- API Reference