runtime

Documentation

Index

• Constants
• func Format(starfile string, W bool) error
• type FmtError
  • func (e FmtError) Error() string
• type Runtime
  • func NewMonkey(name, starfile string, arglabels []string) (rt *Runtime, err error)
  • func (rt *Runtime) Cleanup(ctx context.Context) (err error)
  • func (rt *Runtime) FilterEndpoints(criteria []string) error
  • func (rt *Runtime) Fuzz(ctx context.Context, ntensity uint32, seed []byte, vvv uint8, ...) (err error)
  • func (rt *Runtime) InputsCount() int
  • func (rt *Runtime) JustExecREPL(ctx context.Context) error
  • func (rt *Runtime) JustExecReset(ctx context.Context) error
  • func (rt *Runtime) JustExecStart(ctx context.Context) error
  • func (rt *Runtime) JustExecStop(ctx context.Context) error
  • func (rt *Runtime) Lint(ctx context.Context, showSpec bool) error
  • func (rt *Runtime) ValidateAgainstSchema(absRef string, data []byte) (err error)
  • func (rt *Runtime) WriteAbsoluteReferences(w io.Writer)
• type TestingCampaignFailure
  • func (tc *TestingCampaignFailure) Error() string
• type TestingCampaignFailureDueToResetterError
  • func (tc *TestingCampaignFailureDueToResetterError) Error() string
• type TestingCampaignOutcomer
• type TestingCampaignSuccess
  • func (tc *TestingCampaignSuccess) Error() string

Constants

const PastSeedMagic = "kFPoyHOKs6XrK2F7jPMGc51f@k&&@9T6LE!zn&uy"

PastSeedMagic is a magic string to search through logs

Functions

func Format

func Format(starfile string, W bool) error

Format standardizes Starlark codes

Types

type FmtError

type FmtError []string

FmtError contains fmt diagnostics

func (FmtError) Error

func (e FmtError) Error() string

Error makes FmtError implement the error interface

type Runtime

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

Runtime executes commands, resets and checks against the System Under Test

func NewMonkey

func NewMonkey(name, starfile string, arglabels []string) (rt *Runtime, err error)

NewMonkey parses and optionally pretty-prints configuration

func (*Runtime) Cleanup

func (rt *Runtime) Cleanup(ctx context.Context) (err error)

Cleanup ensures that resetters are terminated

func (*Runtime) FilterEndpoints

func (rt *Runtime) FilterEndpoints(criteria []string) error

FilterEndpoints restricts which API endpoints are considered

func (*Runtime) Fuzz

func (rt *Runtime) Fuzz(
	ctx context.Context,
	ntensity uint32,
	seed []byte,
	vvv uint8,
	tagsFilter *tags.Filter,
	ptype, apiKey string,
) (err error)

Fuzz runs calls, resets and live reporting

func (*Runtime) InputsCount

func (rt *Runtime) InputsCount() int

InputsCount sums the amount of named schemas or types APIs define

func (*Runtime) JustExecREPL

func (rt *Runtime) JustExecREPL(ctx context.Context) error

JustExecREPL executes a Starlark Read-Eval-Print Loop

func (*Runtime) JustExecReset

func (rt *Runtime) JustExecReset(ctx context.Context) error

JustExecReset only executes SUT 'reset' which may be 'stop' followed by 'start'

func (*Runtime) JustExecStart

func (rt *Runtime) JustExecStart(ctx context.Context) error

JustExecStart only executes SUT 'start'

func (*Runtime) JustExecStop

func (rt *Runtime) JustExecStop(ctx context.Context) error

JustExecStop only executes SUT 'stop'

func (*Runtime) Lint

func (rt *Runtime) Lint(ctx context.Context, showSpec bool) error

Lint goes through specs and unsures they are valid

func (*Runtime) ValidateAgainstSchema

func (rt *Runtime) ValidateAgainstSchema(absRef string, data []byte) (err error)

ValidateAgainstSchema tries to smash the data through the given keyhole

func (*Runtime) WriteAbsoluteReferences

func (rt *Runtime) WriteAbsoluteReferences(w io.Writer)

WriteAbsoluteReferences pretty-prints the API's named types

type TestingCampaignFailure

type TestingCampaignFailure struct{}

TestingCampaignFailure indicates a bug was found during fuzzing.

func (*TestingCampaignFailure) Error

func (tc *TestingCampaignFailure) Error() string

type TestingCampaignFailureDueToResetterError

type TestingCampaignFailureDueToResetterError struct{}

TestingCampaignFailureDueToResetterError indicates a bug was found during reset.

func (*TestingCampaignFailureDueToResetterError) Error

func (tc *TestingCampaignFailureDueToResetterError) Error() string

type TestingCampaignOutcomer

type TestingCampaignOutcomer interface {
	error
	// contains filtered or unexported methods
}

TestingCampaignOutcomer describes a testing campaign's results

type TestingCampaignSuccess

type TestingCampaignSuccess struct{}

TestingCampaignSuccess indicates no bug was found during fuzzing.

func (*TestingCampaignSuccess) Error

func (tc *TestingCampaignSuccess) Error() string