Testing on Kolena is conducted using the
kolena-clientPython package. You use the client to create and run tests from your infrastructure that can be explored in our web platform.
The first step to start testing with Kolena is to install
kolena-client. From the developer page (
</>) on Kolena, generate an API token and set the
Client builds can be installed with any Python package manager such as
pip3 install --extra-index-url "https://$KOLENA_TOKEN@gateway.kolena.cloud/repositories" kolena-client
- 1.Configure the
kolenarepository in Poetry:poetry config repositories.kolena https://gateway.kolena.cloud/repositoriespoetry config http-basic.kolena "$KOLENA_TOKEN" ""
- 2.Add the
kolenasource to your project by adding this block to your
pyproject.toml:[[tool.poetry.source]]name = "kolena"url = "https://gateway.kolena.cloud/repositories"secondary = true
- 3.Install:poetry add kolena-client
Poetry overhauled its credential handling in 1.2 to fix various issues with private repositories. Consider updating your Poetry installation to the latest stable release.
Before using the
kolena-clientto create or run tests, initialize a client session:
By default, sessions have static scope and persist until the interpreter is exited.
Additional logging can be configured by specifying
initialize(..., verbose=True). All logging events are emitted as Python standard library
loggingevents from the
"kolena"logger as well as to stdout/stderr directly.
kolena-clientis compatible with all active Python versions.
Compatible Client Versions