Embedded integration testing framework.
pykiso is an integration test framework. With it, it is possible to write
- Whitebox integration tests directly on my target device
- Graybox integration tests to make sure the communication-link with my target device is working as expected
- Blackbox integration tests to make sure my external device interfaces are working as expected
The project will contain:
- The core python framework (this repository)
- Framework plugins that are generic enough to be integrated as "native" (this repository)
- Additional "testApps" for different targets platforms (e.g. stm32, ...) or languages (C, C++, ...) . It could be pure SW or also HW (other repositories)
- Python 3.7+
- pip/poetry (used to get the rest of the requirements)
pip install pykiso
Poetry is more appropriate for developers as it automatically creates virtual environments.
cd kiso-testing poetry install poetry shell
To improve code-quality, a configuration of pre-commit hooks are available. The following pre-commit hooks are used:
If you don't have pre-commit installed, you can get it using pip:
pip install pre-commit
Start using the hooks with
Commit message convention
Commits are sorted into multiple categories based on keywords that can occur at any position as part of the commit message. [Category] Keywords
- [BREAKING CHANGES] BREAKING CHANGE
- [Features] feat:
- [Fixes] fix:
- [Docs] docs:
- [Styles] style:
- [Refactors] refactor!:
- [Performances] perf:
- [Tests] test:
- [Build] build:
- [Ci] ci: Each commit is considered only once according to the order of the categories listed above. Merge commits are ignored.
The tool commitizen can help you to create commits which follows these standards.
# if not yet installed: pip install -U commitizen==2.20.4 # helps you to create a commit: cz commit # or use equivalent short variant: cz c
After you installed the dev dependencies from the pipfile you are able to autogenerate the Changelog.
Once installed the application is bound to
pykiso, it can be called with the following arguments:
Usage: pykiso [OPTIONS] Embedded Integration Test Framework - CLI Entry Point. TAG Filters: any additional option to be passed to the test as tag through the pykiso call. Multiple values must be separated with a comma. For example: pykiso -c your_config.yaml --branch-level dev,master --variant delta Options: -c, --test-configuration-file FILE path to the test configuration file (in YAML format) [required] -l, --log-path PATH path to log-file or folder. If not set will log to STDOUT --log-level [DEBUG|INFO|WARNING|ERROR] set the verbosity of the logging --junit enables the generation of a junit report --text default, test results are only displayed in the console --step-report PATH generate the step report at the specified path --failfast stop the test run on the first error or failure -v, --verbose activate the internal framework logs -p, --pattern TEXT test filter pattern, e.g. 'test_suite_1.py' or 'test_*.py'. Or even more granularly 'test_suite_1.py::test_class::test_name' --version Show the version and exit. -h, --help Show this message and exit.
Suitable config files are available in the
Demo using example config
Running the Tests
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.