https://github.com/teran/go-docker-testsuite
Library to run any third-party dependency in Docker on any platform Docker supports
https://github.com/teran/go-docker-testsuite
docker go go-test go-test-helper go-testing golang test-automation testing-tools
Last synced: 4 months ago
JSON representation
Library to run any third-party dependency in Docker on any platform Docker supports
- Host: GitHub
- URL: https://github.com/teran/go-docker-testsuite
- Owner: teran
- License: apache-2.0
- Created: 2024-05-12T17:39:47.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2025-01-20T17:20:13.000Z (4 months ago)
- Last Synced: 2025-01-20T18:27:09.480Z (4 months ago)
- Topics: docker, go, go-test, go-test-helper, go-testing, golang, test-automation, testing-tools
- Language: Go
- Homepage:
- Size: 276 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-docker-testsuite
[](https://goreportcard.com/report/github.com/teran/go-docker-testsuite)
[](https://pkg.go.dev/github.com/teran/go-docker-testsuite)
Library to run any third-party dependency in Docker on any platform Docker supports
The main purpose is to allow runnings integration tests against almost any
database or other dependency running right within docker and available via
network.
## Applications
The test suite provides some of applications, i.e. wrappers for particular
docker image, here's the list:
* MinIO
* MySQL/MariaDB/Percona Server
* PostgreSQL
* Redis
* ScyllaDB
Each application could provide its own interface to interact so please refer
to applications package for some examples.
## Example usage
Go Docker Testsuite provides its own interface for each application aiming to
make it clean and easy to use each particular application.
Here's an example for MySQL database:
```go
package main
import (
"context"
"database/sql"
_ "github.com/go-sql-driver/mysql"
"github.com/teran/go-docker-testsuite/applications/mysql"
)
func main() {
ctx := context.Background()
app, err := mysql.New(ctx, "index.docker.io/library/mysql:8.0.4")
if err != nil {
panic(err)
}
defer app.Close(ctx)
if err := app.CreateDB(ctx, "important_database"); err != nil {
panic(err)
}
db, err := sql.Open("mysql", app.MustDSN("important_database"))
if err != nil {
panic(err)
}
if err := db.Ping(); err != nil {
panic(err)
}
if _, err := db.ExecContext(ctx, "SELECT 1"); err != nil {
panic(err)
}
}
```