{"repo":"ory/dockertest","free":true,"listed":false,"github":"https://github.com/ory/dockertest","clone":"git clone https://github.com/ory/dockertest.git","description":"Write better integration tests! Dockertest helps you boot up ephermal docker images for your Go tests with minimal work.","language":"Go","stars":4522,"topics":["go","docker","ci","tests","automation","unit-testing","integration-testing"],"license":"Apache-2.0","category":"deployment-docker-iac","readme_excerpt":"Use Docker to run your Go integration tests against third party services on Windows, macOS, and Linux ! Dockertest supports running any Docker image from Docker Hub or from a Dockerfile. - Why should I use Dockertest? - Installation - Quick Start - Migration from v3 - API overview - Pool creation - Running containers - Container configuration - Container reuse - Getting connection info - Waiting for readiness - Executing commands - Container logs - Building from Dockerfile - Networks - Cleanup - Error handling - Examples - Troubleshoot & FAQ - Out of disk space - Running in CI - GitHub Actions - GitLab CI - Shared runners - Custom (group) runners Why should I use Dockertest? When developing applications, it is often necessary to use services that talk to a database system. Unit testing these services can be cumbersome because mocking database/DBAL is strenuous. Making slight changes to the schema implies rewriting at least some, if not all mocks. The same goes for API changes in the DBAL. To avoid this, it is smarter to test these specific services against a real database that is destroyed after testing. Docker is the perfect system for running integration tests as you can spin up containers in a few seconds and kill them when the test completes. The Dockertest library provides easy to use commands for spinning up Docker containers and using them for your tests. Installation Quick Start Migration from v3 Version 4 introduces automatic container reuse, making tests significant","default_branch":null,"files":null,"tree":[],"storefront":"/r/ory","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/ory/dockertest/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}