kola

Documentation

Index

• Variables
• func CheckConsole(output []byte, t *register.Test) []string
• func NewCluster(pltfrm string, rconf *platform.RuntimeConfig) (cluster platform.Cluster, err error)
• func RunTests(pattern, pltfrm, outputDir string) error
• func SetupOutputDir(outputDir, platform string) (string, error)
• type NativeRunner

Variables

var (
	Options       = platform.Options{}
	AWSOptions    = awsapi.Options{Options: &Options}    // glue to set platform options from main
	DOOptions     = doapi.Options{Options: &Options}     // glue to set platform options from main
	ESXOptions    = esxapi.Options{Options: &Options}    // glue to set platform options from main
	GCEOptions    = gcloudapi.Options{Options: &Options} // glue to set platform options from main
	OCIOptions    = ociapi.Options{Options: &Options}    // glue to set platform options from main
	PacketOptions = packetapi.Options{Options: &Options} // glue to set platform options from main
	QEMUOptions   = qemu.Options{Options: &Options}      // glue to set platform options from main

	TestParallelism   int    //glue var to set test parallelism from main
	TAPFile           string // if not "", write TAP results here
	TorcxManifestFile string // torcx manifest to expose to tests, if set
	// TorcxManifest is the unmarshalled torcx manifest file. It is available for
	// tests to access via `kola.TorcxManifest`. It will be nil if there was no
	// manifest given to kola.
	TorcxManifest *torcx.Manifest = nil
)

Functions

func CheckConsole

func CheckConsole(output []byte, t *register.Test) []string

CheckConsole checks some console output for badness and returns short descriptions of any badness it finds. If t is specified, its flags are respected.

func NewCluster

func NewCluster(pltfrm string, rconf *platform.RuntimeConfig) (cluster platform.Cluster, err error)

func RunTests

func RunTests(pattern, pltfrm, outputDir string) error

RunTests is a harness for running multiple tests in parallel. Filters tests based on a glob pattern and by platform. Has access to all tests either registered in this package or by imported packages that register tests in their init() function. outputDir is where various test logs and data will be written for analysis after the test run. If it already exists it will be erased!

func SetupOutputDir

func SetupOutputDir(outputDir, platform string) (string, error)

Types

type NativeRunner

type NativeRunner func(funcName string, m platform.Machine) error

NativeRunner is a closure passed to all kola test functions and used to run native go functions directly on kola machines. It is necessary glue until kola does introspection.