Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/exasol/exasol-testcontainers

Test container for Exasol on Docker
https://github.com/exasol/exasol-testcontainers

docker exasol exasol-integration integration-testing junit test-automation test-containers

Last synced: about 1 month ago
JSON representation

Test container for Exasol on Docker

Host: GitHub
URL: https://github.com/exasol/exasol-testcontainers
Owner: exasol
License: mit
Created: 2019-10-28T07:09:39.000Z (about 5 years ago)
Default Branch: main
Last Pushed: 2024-08-05T09:55:13.000Z (5 months ago)
Last Synced: 2024-08-06T05:42:43.456Z (5 months ago)
Topics: docker, exasol, exasol-integration, integration-testing, junit, test-automation, test-containers
Language: Java
Homepage:
Size: 603 KB
Stars: 9
Watchers: 7
Forks: 2
Open Issues: 5
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # exasol-testcontainers



[![Build Status](https://github.com/exasol/exasol-testcontainers/actions/workflows/ci-build.yml/badge.svg)](https://github.com/exasol/exasol-testcontainers/actions/workflows/ci-build.yml)

[![Maven Central – Test containers for Exasol on Docker](https://img.shields.io/maven-central/v/com.exasol/exasol-testcontainers)](https://search.maven.org/artifact/com.exasol/exasol-testcontainers)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=alert_status)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=security_rating)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=reliability_rating)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=sqale_rating)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=sqale_index)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=code_smells)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=coverage)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-testcontainers&metric=ncloc)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-testcontainers)

This project provides an abstraction to Exasol running on Docker for the purpose of integration testing based on [Java Testcontainers](https://www.testcontainers.org).

You can create a dockerized instance of Exasol with a few Java commands from within the test framework (e.g. [JUnit](https://junit.org)).

## Scope

This software is intended for use in automated integration tests of Java software that uses Exasol. It sets up and runs a disposable Docker container and lets users access the interfaces of the Exasol instance inside that container with minimum effort.

**Don't use testcontainers for production environments or with confidential data.** To make testing as convenient as possible, the handling of the disposable containers is not up to the same security standards as a production system.

## Features

* Download, start and stop an Exasol docker container automatically

* JUnit integration via annotations

* JDBC connection to the database inside the container

* BucketFS access

* EXAoperation emulation

* Optional container reuse

* Detection for access via `docker exec` and fallback to SSH

## Table of Contents

### Information for Users

"Users" from the perspective of this project are software developers integrating the Exasol test container into their test environment, not database end users.

* [User Guide](doc/user_guide/user_guide.md)

* [Changelog](doc/changes/changelog.md)

### Information for Contributors

Requirement, design documents and coverage tags are written in [OpenFastTrace](https://github.com/itsallcode/openfasttrace) format.

* [System Requirement Specification](doc/system_requirements.md)

* [Design](doc/design.md)

* [Dependencies](dependencies.md)