No project description provided
Project description
pytest-exasol-saas Plugin
The pytest-exasol-saas
plugin is a pytest plugin designed to facilitate the integration
testing of projects using the exasol-saas-api.
Features
- Integration with exasol-saas-api: Designed to work closely with the exasol-saas-api.
- Ease of Use: Simplifies the configuration and execution of tests by leveraging the pytest framework, making it accessible to developers familiar with pytest conventions.
Installation
To install the pytest-exasol-saas plugin, you can use pip:
pip install pytest-exasol-saas
Database Instances
Using an Existing Database Instance
By default the fixtures in pytest-exasol-saas Plugin will create instances of Exasol SaaS database with scope session
.
If you want to use an existing instance instead, then you can provide the instance's ID with the command line option --saas-database-id <ID>
to pytest.
Keeping Database Instances After the Test Session
By default the fixtures in pytest-exasol-saas Plugin will remove the created database instances after the session or in case of errors.
However, if you provide the command line option --keep-saas-database
then the pytest-exasol-saas plugin will keep these instances for subsequent inspection or reuse.
Please note hat long-running instances will cause significant costs.
Naming Database Instances
pytest-exasol-saas Plugin will name the database instances using 3 components
- Project Short Tag: Abbreviation of the current project, see below for different options for providing the project short tag.
- Timestamp: Number of seconds since epoc, see Unix Time.
- A dash character
-
- User Name: Login name of the current user.
A database instances might for example have the name 1715155224SAPIPY-run
indicating it was
- created on Wednesday, May 8, 2024
- in the context of a project with short tag
SAPIPY
- by a user with login name starting with
run
Please note that Exasol SaaS limits the length of database names to 10 characters only. So pytest-exasol-saas plugin will shorten the constructed name to 10 characters max.
If running your tests on a server for Continuous Integration (CI) then the name of the user might be not very expressive.
Options for providing the Project Short Tag
- In yaml file
error_code_config.yml
in the project's root directory - CLI option
--project-short-tag <short tag>
to pytest - Environment variable
PROJECT_SHORT_TAG
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pytest_exasol_saas-0.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d55090a47f856b626f66fc993e5ce8935b3d3633fb630cd492ac9e55a2bd698e |
|
MD5 | 3e2670147ce06423abd823819da86737 |
|
BLAKE2b-256 | 2401521de2eed3bc094aae384ea8b8c5fb2d4fe106fa2cc7393682713ae62e54 |