hookedtest

package

v0.5.0 Latest Latest Go to latest Published: Oct 4, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Documentation ¶

Overview ¶

Package hookedtest provisions sandboxes from a hooked image — one whose `ENV BASH_ENV` file is sandboxtest.BannerHook: it prints on both streams without ending its lines, leaves the directory the shell started in, and sets an EXIT trap that prints on both after whatever the shell ran — on both sandbox backends: the Docker daemon and the Kubernetes cluster the tests run against. It is how a platform script that parses an exec's output is held to answer through an image's startup output on each (#860; sandbox.Frame).

A missing daemon or cluster is a hard failure, as it is for the backends' own contract tests. On a kind cluster the image is loaded into its nodes and removed from them afterwards (sandboxtest.LoadIntoKind, KindLoad.Remove); a cluster that shares the Docker daemon's image store (Docker Desktop's) needs neither.

Index ¶

func DockerImage(t *testing.T, hook string) string
func Image(t *testing.T, hook string) string
func KindMissing(t *testing.T, image string) (missing []string, loaded bool)
func KindRefs(t *testing.T, image string) (refs []string, loaded bool)
type Backend
- func Backends(t *testing.T) []Backend
- func BackendsFor(t *testing.T, hook string) []Backend
- func (b Backend) Provision(t *testing.T, h sandbox.Hardening) (sandbox.Sandbox, domain.ID)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func DockerImage ¶

func DockerImage(t *testing.T, hook string) string

DockerImage is Image on the Docker daemon alone, for a test of the Docker backend that has no cluster to show it to.

func Image ¶

func Image(t *testing.T, hook string) string

Image builds an image whose `ENV BASH_ENV` file is hook, on the base the backends' contract tests run, makes it visible to the Kubernetes cluster the tests run against, and removes it from both when the test is done.

Each call builds an image of its own: the same Dockerfile would build the same image ID in every package that asks at once, sharing layers through the build cache, and removing one package's from a kind node takes the image ID, every package's tag with it, out from under pods still running from it. A label carrying a nonce makes the ID this call's alone, its layers still shared, so the removal when the test ends takes this call's image and nothing another package runs.

func KindMissing ¶

func KindMissing(t *testing.T, image string) (missing []string, loaded bool)

KindMissing is what of an image Image built a kind node does not hold (sandboxtest.KindLoad.Missing) — its tag, and its import record where the archive named one — with loaded as KindRefs has it.

func KindRefs ¶

func KindRefs(t *testing.T, image string) (refs []string, loaded bool)

KindRefs is every image reference the kind cluster's nodes hold of an image Image built — none once the test that built it is done — and whether Image loaded it onto a kind cluster at all: false where the cluster is not kind's, so that a check of what is held can tell "nothing to look at" from "nothing found".

Types ¶

type Backend ¶

type Backend struct {
	Name     string
	Provider sandbox.Provider
	Image    string
}

Backend is one sandbox backend with the hooked image visible to it.

func Backends ¶

func Backends(t *testing.T) []Backend

Backends builds the hooked image (Image, with sandboxtest.BannerHook) and returns the Docker backend and the Kubernetes one (MAP_K8S_CONTEXT, else the kubeconfig's current context; MAP_K8S_NAMESPACE), each able to run it.

func BackendsFor ¶

func BackendsFor(t *testing.T, hook string) []Backend

BackendsFor is Backends with hook as the image's BASH_ENV file.

func (Backend) Provision ¶

func (b Backend) Provision(t *testing.T, h sandbox.Hardening) (sandbox.Sandbox, domain.ID)

Provision provisions a sandbox from the hooked image on b, with h as its hardening, destroyed when the test ends. The session id is the sandbox's.

Source Files ¶

View all Source files

hookedtest.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL