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: 24 days 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 (8 months ago)
• Default Branch: master
• Last Pushed: 2024-11-25T17:46:51.000Z (about 1 month ago)
• Last Synced: 2024-11-25T18:35:17.637Z (about 1 month ago)
• Topics: docker, go, go-test, go-test-helper, go-testing, golang, test-automation, testing-tools
• Language: Go
• Homepage:
• Size: 276 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-docker-testsuite

![Test & Build status](https://github.com/teran/go-docker-testsuite/actions/workflows/verify.yml/badge.svg)

[![Go Report Card](https://goreportcard.com/badge/github.com/teran/go-docker-testsuite)](https://goreportcard.com/report/github.com/teran/go-docker-testsuite)

[![Go Reference](https://pkg.go.dev/badge/github.com/teran/go-docker-testsuite.svg)](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)

    }

}

```