2023-08-21 21:04:28 +00:00
# Testcontainers
2020-03-01 16:06:34 +00:00
2023-08-21 21:04:28 +00:00
[![Open in GitHub Codespaces ](https://github.com/codespaces/badge.svg )](https://github.com/codespaces/new?hide_repo_select=true& ref=main& repo=141451032& machine=standardLinux32gb& devcontainer_path=.devcontainer%2Fdevcontainer.json& location=EastUs)
2020-03-01 16:06:34 +00:00
2023-08-21 21:04:28 +00:00
[![Main pipeline ](https://github.com/testcontainers/testcontainers-go/actions/workflows/ci.yml/badge.svg?branch=main )](https://github.com/testcontainers/testcontainers-go/actions/workflows/ci.yml)
[![Go Report Card ](https://goreportcard.com/badge/github.com/testcontainers/testcontainers-go )](https://goreportcard.com/report/github.com/testcontainers/testcontainers-go)
[![GoDoc Reference ](https://camo.githubusercontent.com/8609cfcb531fa0f5598a3d4353596fae9336cce3/68747470733a2f2f676f646f632e6f72672f6769746875622e636f6d2f79616e6777656e6d61692f686f772d746f2d6164642d62616467652d696e2d6769746875622d726561646d653f7374617475732e737667 )](https://pkg.go.dev/github.com/testcontainers/testcontainers-go)
2020-03-01 16:06:34 +00:00
2023-08-21 21:04:28 +00:00
_Testcontainers for Go_ is a Go package that makes it simple to create and clean up container-based dependencies for
automated integration/smoke tests. The clean, easy-to-use API enables developers to programmatically define containers
that should be run as part of a test and clean up those resources when the test is done.
2020-03-01 16:06:34 +00:00
2023-08-21 21:04:28 +00:00
You can find more information about _Testcontainers for Go_ at [golang.testcontainers.org ](https://golang.testcontainers.org ), which is rendered from the [./docs ](./docs ) directory.
2020-03-01 16:06:34 +00:00
2023-08-21 21:04:28 +00:00
## Using _Testcontainers for Go_
2020-03-01 16:06:34 +00:00
2023-08-21 21:04:28 +00:00
Please visit [the quickstart guide ](https://golang.testcontainers.org/quickstart ) to understand how to add the dependency to your Go project.