{"id":20207778,"url":"https://github.com/exasol/exasol-test-setup-abstraction-java","last_synced_at":"2026-01-04T01:36:45.717Z","repository":{"id":39710184,"uuid":"355108989","full_name":"exasol/exasol-test-setup-abstraction-java","owner":"exasol","description":"Common interface for testing with an Exasol database in local and AWS environments using Java.","archived":false,"fork":false,"pushed_at":"2024-05-22T07:26:11.000Z","size":344,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-05-22T13:37:46.462Z","etag":null,"topics":["exasol-integration","integration-testing","testing"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/exasol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-06T08:08:53.000Z","updated_at":"2022-09-19T14:05:02.000Z","dependencies_parsed_at":"2023-11-09T15:28:12.991Z","dependency_job_id":"2e342e7a-846f-4e8c-af23-6e8b039abecd","html_url":"https://github.com/exasol/exasol-test-setup-abstraction-java","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fexasol-test-setup-abstraction-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fexasol-test-setup-abstraction-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fexasol-test-setup-abstraction-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/exasol%2Fexasol-test-setup-abstraction-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/exasol","download_url":"https://codeload.github.com/exasol/exasol-test-setup-abstraction-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244160048,"owners_count":20408021,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["exasol-integration","integration-testing","testing"],"created_at":"2024-11-14T05:32:05.551Z","updated_at":"2026-01-04T01:36:45.679Z","avatar_url":"https://github.com/exasol.png","language":"Java","readme":"# Exasol Test Setup Abstraction\n\n[![Build Status](https://github.com/exasol/exasol-test-setup-abstraction-java/actions/workflows/ci-build.yml/badge.svg)](https://github.com/exasol/exasol-test-setup-abstraction-java/actions/workflows/ci-build.yml)\n[![Maven Central \u0026ndash; exasol-test-setup-abstraction-java](https://img.shields.io/maven-central/v/com.exasol/exasol-test-setup-abstraction-java)](https://search.maven.org/artifact/com.exasol/exasol-test-setup-abstraction-java)\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=security_rating)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=reliability_rating)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=sqale_rating)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=sqale_index)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n\n[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=code_smells)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=coverage)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=com.exasol%3Aexasol-test-setup-abstraction-java\u0026metric=ncloc)](https://sonarcloud.io/dashboard?id=com.exasol%3Aexasol-test-setup-abstraction-java)\n\nThis repository defines a standardized interface for accessing an Exasol database for testing.\n\nThat allows you to write tests where you can switch the test-backend. For example you can switch between an Exasol cluster in the cloud or a local docker-db.\n\nIn addition, it contains implementations for this interface for the following test-backends:\n\n* Local - Docker (via Testcontainers)\n* With an Exasol cluster on AWS\n\n## Usage\n\n```java\nclass MyTest {\n    private static final ExasolTestSetup EXASOL = new ExasolTestSetupFactory(\"cloudSetup/generated/testConfig.json\").getTestSetup();\n\n    @Test\n    void test() {\n        var sqlConnection = EXASOL.createConnection();\n        //...\n    }\n\n    @AfterAll\n    static void afterAll() {\n        EXASOL.close();\n    }\n}\n```\n\nThe `ExasolTestSetupFactory` in the example returns a test setup for an AWS cluster if the specified config file (`cloudSetup/generated/testConfig.json`) exists. Otherwise, it returns a test setup based on a local running Exasol-Testcontainer.\n\nUsually you generate the `testConfig.json` using the Terraform module [terraform-aws-exasol-test-setup \u003e= 1.0.0](https://github.com/exasol/terraform-aws-exasol-test-setup/). For details see the [guide for setting up a project with cloud resources](doc/user_guide/setup_project_with_cloud_resources.md).\n\nYou can also select a specific test-setup in code. For that simply replace `new ExasolTestSetupFactory().getTestSetup()` by `new ExasolTestcontainerTestSetup()`.\n\nTo change the Exasol Docker DB version being used you can define the `com.exasol.dockerdb.image` system property,  e.g: `mvn verify -Dcom.exasol.dockerdb.image=${{ matrix.docker_db_version }}`.\n\n## Information for Users of This Library\n\n* [Guide for Setting up a Project With Cloud Resources](doc/user_guide/setup_project_with_cloud_resources.md)\n* [Changelog](doc/changes/changelog.md)\n\n## Information for Developers of This Library\n\n* [Developer Guide](doc/developer_guide/developer_guide.md)\n* [Dependencies](dependencies.md)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexasol%2Fexasol-test-setup-abstraction-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexasol%2Fexasol-test-setup-abstraction-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexasol%2Fexasol-test-setup-abstraction-java/lists"}