test

Documentation

Index

• Constants
• Variables
• func AContext() gomock.Matcher
• func AssertContentToFile(t *testing.T, gotContent, wantFile string)
• func AssertFilesEquals(t *testing.T, gotPath, wantPath string)
• func Bundle() *releasev1.Bundles
• func Bundles(t *testing.T) *releasev1alpha1.Bundles
• func CAPICluster(opts ...CAPIClusterOpt) *clusterv1.Cluster
• func EksdRelease() *eksdv1.Release
• func EksdReleaseFromTestData(t *testing.T) *eksdv1alpha1.Release
• func FakeNow() time.Time
• func MatchFile(file string) gomock.Matcher
• func Namespace(name string) *corev1.Namespace
• func NewClusterSpec(opts ...ClusterSpecOpt) *cluster.Spec
• func NewFullClusterSpec(t *testing.T, clusterConfigFile string) *cluster.Spec
• func NewHTTPServerForFile(t *testing.T, filePath string) *httptest.Server
• func NewNullLogger() logr.Logger
• func NewWriter(t *testing.T) (dir string, writer filewriter.FileWriter)
• func OfType(t string) gomock.Matcher
• func RandString(n int) string
• func ReadFile(t *testing.T, file string) string
• func ReadFileAsBytes(t *testing.T, file string) []byte
• func RemoveFileIfExists(t *testing.T, filename string)
• func SanitizePath(s string) string
• func SetTag(image *releasev1alpha1.Image, tag string)
• func UseEnvTest(t *testing.T) *rest.Config
• func WithFakeFile(t *testing.T) (f *os.File)
• func WithFakeFileContents(t *testing.T, r io.Reader) (f *os.File)
• type CAPIClusterOpt
• type ClusterSpecOpt
• type KubeClient
  • func NewFakeKubeClient(objs ...client.Object) *KubeClient
  • func NewFakeKubeClientAlwaysError(objs ...client.Object) *KubeClient
  • func NewKubeClient(client client.Client) *KubeClient
  • func (c *KubeClient) Get(ctx context.Context, name, namespace string, obj kubernetes.Object) error
• type Reader

Constants

const KubeVipTemplate = `` /* 1091-byte string literal not displayed */

KubeVipTemplate is the default kube-vip pod template for internal testing.

Variables

var UpdateGoldenFiles = flag.Bool("update", false, "update golden files")

Functions

func AContext

func AContext() gomock.Matcher

AContext returns a gomock matchers that evaluates if the receive value can fullfills the context.Context interface.

func AssertContentToFile

func AssertContentToFile(t *testing.T, gotContent, wantFile string)

func AssertFilesEquals

func AssertFilesEquals(t *testing.T, gotPath, wantPath string)

func Bundle

func Bundle() *releasev1.Bundles

Bundle returns a test bundle struct for unit testing.

func Bundles

func Bundles(t *testing.T) *releasev1alpha1.Bundles

func CAPICluster

func CAPICluster(opts ...CAPIClusterOpt) *clusterv1.Cluster

CAPICluster returns a capi cluster which can be configured by passing in opts arguments.

func EksdRelease

func EksdRelease() *eksdv1.Release

EksdRelease returns a test release struct for unit testing.

func EksdReleaseFromTestData

func EksdReleaseFromTestData(t *testing.T) *eksdv1alpha1.Release

EksdReleaseFromTestData returns a test release struct for unit testing from a testdata file. See EksdRelease() for a static struct to test with.

func FakeNow

func FakeNow() time.Time

func MatchFile

func MatchFile(file string) gomock.Matcher

MatchFile returns a gomock matcher that compares []byte input to the content of the given file.

func Namespace

func Namespace(name string) *corev1.Namespace

Namespace returns a test namespace struct for unit testing.

func NewClusterSpec

func NewClusterSpec(opts ...ClusterSpecOpt) *cluster.Spec

func NewFullClusterSpec

func NewFullClusterSpec(t *testing.T, clusterConfigFile string) *cluster.Spec

func NewHTTPServerForFile

func NewHTTPServerForFile(t *testing.T, filePath string) *httptest.Server

func NewNullLogger

func NewNullLogger() logr.Logger

func NewWriter

func NewWriter(t *testing.T) (dir string, writer filewriter.FileWriter)

func OfType

func OfType(t string) gomock.Matcher

func RandString

func RandString(n int) string

func ReadFile

func ReadFile(t *testing.T, file string) string

func ReadFileAsBytes

func ReadFileAsBytes(t *testing.T, file string) []byte

func RemoveFileIfExists

func RemoveFileIfExists(t *testing.T, filename string)

RemoveFileIfExists is a helper for ValidateFilename tests.

func SanitizePath

func SanitizePath(s string) string

SanitizePath sanitizes s so its usable as a path name. For safety, it assumes all characters that are not A-Z, a-z, 0-9, _ or - are illegal and replaces them with _.

func SetTag

func SetTag(image *releasev1alpha1.Image, tag string)

func UseEnvTest

func UseEnvTest(t *testing.T) *rest.Config

UseEnvTest sets up the controller-runtime EnvTest framework.

The test will be skipped if EnvTest framework isn't detected.

EnvTest provides fake k8s control plane components for testing purposes. The process of bringing up and tearing down the EnvTest framework involves running a few binaries, and is not integrated into a vanilla "go test" run, but rather can be run via the unit-test target in Makefile. See https://book.kubebuilder.io/reference/envtest.html for details.

TODO: What could be done to integrate EnvTest with go test, so that "go test" would work?

func WithFakeFile

func WithFakeFile(t *testing.T) (f *os.File)

WithFakeFile returns a throwaway file in a test-specific directory.

The file is automatically closed and removed when the test ends.

func WithFakeFileContents

func WithFakeFileContents(t *testing.T, r io.Reader) (f *os.File)

WithFakeFileContents returns a throwaway file containing some data.

The file is automatically closed and removed when the test ends.

Types

type CAPIClusterOpt

type CAPIClusterOpt func(*clusterv1.Cluster)

CAPIClusterOpt represents an function where a capi cluster is passed as an argument.

type ClusterSpecOpt

type ClusterSpecOpt func(*cluster.Spec)

type KubeClient

type KubeClient struct {
	// contains filtered or unexported fields
}

KubeClient implements kubernetes.Client by using client.Client.

func NewFakeKubeClient

func NewFakeKubeClient(objs ...client.Object) *KubeClient

NewFakeKubeClient returns a KubeClient that uses a fake client.Client under the hood.

func NewFakeKubeClientAlwaysError

func NewFakeKubeClientAlwaysError(objs ...client.Object) *KubeClient

NewFakeKubeClientAlwaysError returns a KubeClient that will always fail in any operation This is achieved by injecting an empty Scheme, which will make the underlying client.Client incapable of determining the resource type for a particular client.Object.

func NewKubeClient

func NewKubeClient(client client.Client) *KubeClient

func (*KubeClient) Get

func (c *KubeClient) Get(ctx context.Context, name, namespace string, obj kubernetes.Object) error

Get retrieves an obj for the given name and namespace from the Kubernetes Cluster.

type Reader

type Reader interface {
	ReadFile(url string) ([]byte, error)
}

Reader is a commonly used interface in multiple packages We are replicating here just to create a single mock we can use in multiple test packages.