Registry / database / exasol-integration-test-docker-environment

exasol-integration-test-docker-environment

library6.2.0pypypiunverified

The Exasol Integration Test Docker Environment (ITDE) provides a Python API and CLI to easily spawn and manage Exasol database instances within Docker for integration testing. It ensures a consistent and isolated environment for running tests against various Exasol DB versions. The current version is 6.1.0, with frequent minor/patch releases and occasional major releases driven by Exasol DB updates or significant API changes.

database testing devops data

pip install exasol-integration-test-docker-environment

github ↗package ↗

INSTALL

IMPORT

SIG · EXASOL-INTEGRATION

exasol-integration-test-docker-environment

databasepythonv6.2.0

Install

9.4s avg

Import

—

Disk

99MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v6.2.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 95.9MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 9.4s · import 0.000s · 96MB

99MB installed

● package 99MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

DockerTestEnvironment

✓ from exasol_integration_test_docker_environment import DockerTestEnvironment

✗ from exasol_integration_test_docker_environment import DockerTestEnvironment

This quickstart demonstrates how to use `DockerTestEnvironment` to launch an Exasol database instance in Docker. It automatically pulls the specified Docker image, configures the environment, and provides connection details. The `with` statement ensures the environment is properly shut down afterwards.

from exasol_integration_test_docker_environment.environment.docker_test_environment import DockerTestEnvironment # Configure with a supported Exasol Docker DB version. (e.g., 2025.1.8, 8.29.13) # Check the library's GitHub for currently supported versions. EXASOL_DB_VERSION = "8.34.0" # Or '2025.1.8' try: with DockerTestEnvironment( docker_db_version=EXASOL_DB_VERSION, name="my_integration_test" ) as environment: connection_info = environment.get_connection_info() print(f"Exasol DB IP: {connection_info.host}") print(f"Exasol DB Port: {connection_info.port}") print(f"Exasol DB User: {connection_info.user}") print(f"Exasol DB Password: {connection_info.password}") print(f"Exasol DB Schema: {connection_info.schema}") # Your test code goes here, using connection_info to connect to the DB print("Exasol test environment is running.") except Exception as e: print(f"Failed to spawn Exasol Docker environment: {e}")

itde --version

Debug

Known issues

breakingStarting from v6.0.0, the Docker image tag format has changed to support platform-specific builds. This may affect CI/CD pipelines or scripts relying on a specific tag naming convention.

fix

Review existing scripts that interact directly with Docker image tags. The ITDE API should handle this transparently, but direct Docker CLI calls may need adjustment.

affects: >=6.0.0

breakingVersion 5.0.0 removed support for older Exasol Docker DB versions (e.g., those prior to 2025.1.8, 8.29.13, 7.1.30) because Exasol removed them from Docker Hub. Attempting to use these versions will result in a `DockerVersionNotSupportedError`.

fix

Update your `docker_db_version` parameter to a currently supported Exasol Docker DB version (e.g., '2025.1.8' or '8.29.13'). Check the ITDE GitHub repository for the latest supported versions.

affects: >=5.0.0

breakingMinimum Python version was updated to 3.10 in v4.4.0. Running the library on Python 3.9 or older will lead to compatibility errors or crashes.

fix

Upgrade your Python environment to version 3.10 or newer. The library currently supports Python up to 3.14.

affects: >=4.4.0

breakingVersion 4.0.0 introduced significant API refactorings, specifically splitting `api/common.py` into more granular modules. This changes import paths for core classes and functions like `DockerTestEnvironment` and `spawn_test_environment`.

fix

Update your Python import statements. For example, `from exasol_integration_test_docker_environment.api.common import DockerTestEnvironment` should become `from exasol_integration_test_docker_environment.environment.docker_test_environment import DockerTestEnvironment`.

affects: >=4.0.0

gotchaPrior to v4.4.1, the deprecated `bucketfs` property returned the wrong HTTP port. If you were using this property and expecting HTTP access, connections would fail.

fix

Upgrade to `exasol-integration-test-docker-environment` v4.4.1 or newer. It's recommended to use the `connection_info.bucketfs_port` or similar attributes for accurate port information.

affects: <4.4.1

Upgrade

Version history

6.2.0latest on PyPI · released May 29, 2026

Audit

Dependencies

pythonrequiredRequires Python 3.10 to <3.15.

dockerrequiredCore dependency for interacting with Docker daemon.

clickrequiredUsed for the command-line interface.

Agent activity

15 hits · last 30 days

node

Resources

githubhttps://github.com/exasol/integration-test-docker-environment ↗

packagehttps://pypi.org/project/exasol-integration-test-docker-environment/ ↗