gompose
所属分类：Docker
开发工具：GO
文件大小：0KB
下载次数：0
上传日期：2023-09-12 15:16:58
上 传 者：
sh-1993
说明： 在Go测试中使用docker编程编写的Straightforward库。没有第三方依赖项。
(Straightforward library to use docker-compose programatically in Go tests. No third-party dependencies.)
文件列表:
LICENSE (35149, 2023-10-31)
SECURITY.md (310, 2023-10-31)
go.work (23, 2023-10-31)
v2/ (0, 2023-10-31)
v2/alias.go (915, 2023-10-31)
v2/alias_test.go (289, 2023-10-31)
v2/command.go (234, 2023-10-31)
v2/command_test.go (666, 2023-10-31)
v2/common.go (2290, 2023-10-31)
v2/common_test.go (1084, 2023-10-31)
v2/down.go (1097, 2023-10-31)
v2/down_test.go (698, 2023-10-31)
v2/go.mod (44, 2023-10-31)
v2/go.sum (0, 2023-10-31)
v2/helpers_test.go (3085, 2023-10-31)
v2/integration_test.go (1795, 2023-10-31)
v2/options.go (3073, 2023-10-31)
v2/readyonhttp.go (1339, 2023-10-31)
v2/readyonhttp_test.go (2213, 2023-10-31)
v2/readyonlog.go (764, 2023-10-31)
v2/readyonlog_test.go (699, 2023-10-31)
v2/readyonstdout.go (1297, 2023-10-31)
v2/readyonstdout_test.go (2089, 2023-10-31)
v2/testdata/ (0, 2023-10-31)
v2/testdata/docker-compose.yml (172, 2023-10-31)
v2/testing.go (441, 2023-10-31)
v2/testing_test.go (1469, 2023-10-31)
v2/up.go (2103, 2023-10-31)
v2/up_test.go (1808, 2023-10-31)
# gompose
[](https://coveralls.io/github/bkosm/gompose)
[](https://godoc.org/github.com/bkosm/gompose/v2)
[](https://github.com/bkosm/gompose/actions/workflows/ci.yml)
[](https://github.com/bkosm/gompose/actions/workflows/codeql.yml)
[](https://goreportcard.com/report/github.com/bkosm/gompose/v2)
Straightforward library to use `docker-compose` programmatically in Go tests.
Unlike other (deprecated) libraries, this one relies on `os/exec` instead of
heavy docker libraries and others.
It's just enough so that you can set up and clean your environment for some automated tests.
The only hard requirement is `docker-compose` executable on system path.
## example
```go
package main
import (
"log"
"os"
"testing"
g "github.com/bkosm/gompose/v2"
)
func TestMain(m *testing.M) {
// Let's say we have a postgres container in the spec
err := g.Up(
g.Wait(
g.ReadyOnLog("database system is ready to accept connections", g.Times(2)),
),
g.SignalCallback(func(_ os.Signal) { // any action to be taken on SIGINT, SIGTERM
_ = g.Down()
}),
)
if err != nil {
log.Fatal(err)
}
code := m.Run()
if err = g.Down(); err != nil {
log.Fatal(err)
}
os.Exit(code)
}
```
When you run `go test ./...` you will see that the container is starting and running before any tests.
After the tests conclude, `compose down` is performed.
In case of a system interrupt (`SIGINT`, `SIGTERM`), the library allows for custom callbacks to ensure that no dangling
containers are left after the user requested a stop.
#### but I have things to do in the meantime
Waiting is done the idiomatic way - you can await the ready channel without passing it to `Up` whenever:
```go
//...
err := g.Up(g.SignalCallback(func(_ os.Signal) { _ = g.Down() }))
if err != nil {
log.Fatal(err)
}
// do stuff
readyOrErr := g.ReadyOnLog("database system is ready to accept connections", g.Times(2))
if err := <-readyOrErr; err != nil {
log.Fatal(err)
}
code := m.Run()
//...
```
#### but I want to wait until service passes health-checks
This can be done by using the `ReadyOnHttp` wait channel:
```go
hc, _ := http.NewRequest(http.MethodGet, "http://localhost:5432", nil)
err := g.Up(g.Wait(g.ReadyOnHttp(*hc)))
```
And you can customize what it means to be healthy too:
```go
err := g.Up(g.Wait(
g.ReadyOnHttp(
*hc,
g.ResponseVerifier(func (r *http.Response) (bool, error) {
return r.StatusCode == http.StatusUnauthorized, nil
})
),
))
```
#### miscellaneous
##### skip down non-programmatically
When an environment variable of `GOMPOSE_SKIP` is set with a value including `down`
(as a comma delimited string), the invocation of `docker-compose down` is skipped, leaving out the
environment in the state it was during the tests. This can be helpful while debugging and
during development, in cases where the services needed require significant effort to start.
##### all the commands with all their options - as examples
```go
package main
import (
"bytes"
"fmt"
"net/http"
"os"
"os/exec"
"time"
g "github.com/bkosm/gompose/v2"
)
func main() {
// ready on stdout
cmd := exec.Command("echo", "1")
wait := g.Wait(
g.ReadyOnStdout(
cmd,
"1",
g.Times(1),
g.Timeout(time.Minute),
g.PollInterval(time.Second),
),
)
// ready on log
wait = g.Wait(
g.ReadyOnLog(
"log line",
g.CustomFile("other/compose.yaml"),
g.Times(3),
g.Timeout(2*time.Minute),
g.PollInterval(3*time.Second),
),
)
// ready on http
payload := `{
"is_fine": true
}`
req, _ := http.NewRequest(
http.MethodPut,
"http://myservice/api",
bytes.NewReader([]byte(payload)),
)
wait = g.Wait(
g.ReadyOnHttp(
*req,
g.Times(1),
g.Timeout(time.Minute),
g.PollInterval(time.Second),
g.ResponseVerifier(func(_ *http.Response) (bool, error) {
return true, nil
}),
),
)
// Up
_ = g.Up(
g.CustomFile("other/compose.yaml"),
g.CustomServices("s1", "s2"),
g.SignalCallback(func(s os.Signal) {
fmt.Println("interrupt!")
}),
g.RetryCommand(3, time.Second*10),
wait,
)
// Down
_ = g.Down(
g.CustomFile("other/compose.yaml"),
)
}
```
## contributing
This is the absolute bare-bone of a library and contributions are welcome.
List of things to do in priority:
1. Covering a larger portion of CLI's capabilities
1. More wait conditions
When contributing, be mindful that the purpose of this library is to be
self-contained, lean and easy to use.
## licensing
This software is open-source. See [license](LICENSE).
近期下载者：
相关文件：
收藏者：