/testing-tools

A set of projects that make it easy to execute test, specially with docker. It is heavily used by ToroDB, but can be useful on third party projects.

Apache License 2.0Apache-2.0

ToroDB Testing utilities

License Maven Central

This repository contains several Maven projects used to test ToroDB projects that are general enough to be useful on third party software, so they have been released under Apache 2.0 licese to make it easier to use on any enviroment.

The projects contained on this repository are:

  • testing-core: which contains some utilities used by other projects.
  • core-junit5: which contains some utilities to create JUnit 5 tests.
  • docker-core: which contains some utilities to instanciate Docker containers.
  • sql-docker: which contains interfaces to generalize Docker containers that can be used to run SQL databases.
  • postgres-docker: which contains classes that can be used to run PostgreSQL on a Docker container.
  • postgres-junit-5: which contains JUnit5 extensions and annotations to automatically run a PostgreSQL instance each time a test or test case is executed.
  • mongodb-docker: which contains classes that can be used to run MongoDB on Docker containers. Single mongod, replica sets and sharded topologies are provided out of the box.
  • mongodb-junit-5: which contains JUnit5 extensions and annotations to automatically run MongoDB instances, replica sets or shard each time a test or test case is executed.

How to use it

This utilities are built with Maven. Released artifacts are hosted on Maven Central and snapshot artifacts on Nexus Repository Management. You may build the source code by running "mvn package" on the root directory.

Currently the project is on beta version, there are no released versions and the code is on the devel branch. Please use consider it the main branch of this repository until the first release is done.

Code QA

  • Master branch: Build Status Codacy Badge Codacy Coverage
  • Devel branch: Build Status Codacy Badge Codacy Coverage