testutil

Documentation

Overview

Package testutil is a collection of supporting code to run bldr integration tests.

Index

• func IsBuildkitAvailable() error
• func IsDockerAvailable() error
• type BuildkitRunner
  • func (runner BuildkitRunner) Run(t *testing.T)
• type CommandRunner
• type DockerRunner
  • func (runner DockerRunner) Run(t *testing.T)
• type EvalRunner
  • func (runner EvalRunner) Run(t *testing.T)
• type IntegrationTest
  • func (test IntegrationTest) Run(t *testing.T)
• type LLBRunner
  • func (runner LLBRunner) Run(t *testing.T)
• type Run
• type RunManifest
• type TestCollection
  • func CollectTests() (*TestCollection, error)
  • func (collection *TestCollection) Each(f func(string, func(t *testing.T)))
• type TestManifest
  • func NewTestManifest(path string) (manifest TestManifest, err error)
• type ValidateRunner
  • func (runner ValidateRunner) Run(t *testing.T)

Functions

func IsBuildkitAvailable

func IsBuildkitAvailable() error

IsBuildkitAvailable returns nil if buildkit is ready to use.

func IsDockerAvailable

func IsDockerAvailable() error

IsDockerAvailable returns nil if docker buildx is ready to use.

Types

type BuildkitRunner

type BuildkitRunner struct {
	CommandRunner
	Target   string
	Platform string
}

BuildkitRunner runs bldr via buildctl/buildkit.

func (BuildkitRunner) Run

func (runner BuildkitRunner) Run(t *testing.T)

Run implements Run interface.

type CommandRunner

type CommandRunner struct {
	ExpectStdout *string
	Expect       string
}

CommandRunner is an abstract runner mix-in which processes command result.

type DockerRunner

type DockerRunner struct {
	CommandRunner
	Target   string
	Platform string
}

DockerRunner runs bldr via docker buildx.

func (DockerRunner) Run

func (runner DockerRunner) Run(t *testing.T)

Run implements Run interface.

type EvalRunner

type EvalRunner struct {
	CommandRunner

	Target   string
	Template string
}

EvalRunner runs bldr eval.

func (EvalRunner) Run

func (runner EvalRunner) Run(t *testing.T)

Run implements Run interface.

type IntegrationTest

type IntegrationTest struct {
	Name     string
	Path     string
	Manifest TestManifest
}

IntegrationTest describes single integration set (common testdata).

func (IntegrationTest) Run

func (test IntegrationTest) Run(t *testing.T)

Run executes integration test.

type LLBRunner

type LLBRunner struct {
	CommandRunner
	Target   string
	Platform string
}

LLBRunner runs bldr via bldr llb | buildctl.

func (LLBRunner) Run

func (runner LLBRunner) Run(t *testing.T)

Run implements Run interface.

type Run

type Run interface {
	Run(t *testing.T)
}

Run the integration test.

type RunManifest

type RunManifest struct {
	Name         string  `yaml:"name"`
	Runner       string  `yaml:"runner"`
	Platform     string  `yaml:"platform"`
	Target       string  `yaml:"target"`
	Expect       string  `yaml:"expect"`
	ExpectStdout *string `yaml:"expectStdout"`
	CreateFile   string  `yaml:"createFile"`
	Template     string  `yaml:"template"`
}

RunManifest describes single run of integration test.

type TestCollection

type TestCollection struct {
	Tests []IntegrationTest
}

TestCollection is a set of integration tests.

func CollectTests

func CollectTests() (*TestCollection, error)

CollectTests builds TestCollection from directory structure.

func (*TestCollection) Each

func (collection *TestCollection) Each(f func(string, func(t *testing.T)))

Each iterates over collection providing runner for each test.

type TestManifest

type TestManifest struct {
	Runs []RunManifest `yaml:"run"`
}

TestManifest describes single integration test in test.yaml.

func NewTestManifest

func NewTestManifest(path string) (manifest TestManifest, err error)

NewTestManifest loads TestManifest from test.yaml file.

type ValidateRunner

type ValidateRunner struct {
	CommandRunner
}

ValidateRunner runs bldr validate.

func (ValidateRunner) Run

func (runner ValidateRunner) Run(t *testing.T)

Run implements Run interface.