compose-go

Go reference library for parsing and loading Compose files as specified by the Compose specification.

Usage

package main
import (
	"context"
	"fmt"
	"log"
"github.com/compose-spec/compose-go/v2/cli"
)
func main() {
	composeFilePath := "docker-compose.yml"
	projectName := "my_project"
	ctx := context.Background()
options, err := cli.NewProjectOptions(
		[]string{composeFilePath},
		cli.WithOsEnv,
		cli.WithDotEnv,
		cli.WithName(projectName),
	)
	if err != nil {
		log.Fatal(err)
	}
project, err := options.LoadProject(ctx)
	if err != nil {
		log.Fatal(err)
	}
// Use the MarshalYAML method to get YAML representation
	projectYAML, err := project.MarshalYAML()
	if err != nil {
		log.Fatal(err)
	}
fmt.Println(string(projectYAML))
}

Build the library

To build the library, you could either use the makefile

make build

go build ./...

Run the tests

make test

gotestsum ./...

Other helpful make commands

make lint

Check the license headers

make check-license

Used by

• compose
• containerd/nerdctl
• tilt.dev
• kompose
• kurtosis
• testcontainers-go's Compose module
• compose2nix
• Defang
• score-compose
• CasaOS