cuetest

Documentation

Overview

Package testing is a helper package for test packages in the CUE project. As such it should only be imported in _test.go files.

Index

• Constants
• Variables
• func Condition(cond string) (bool, error)
• func IssueSkip(t *testing.T, s string)
• type Chunker
  • func NewChunker(t *testing.T, b []byte) *Chunker
  • func (c *Chunker) Bytes() []byte
  • func (c *Chunker) Find(key string) bool
  • func (c *Chunker) Next(beg, end string) bool
  • func (c *Chunker) Text() string

Constants

const Long = false

LongTest is a build tag used to indicate that long tests should be run. Note this is not the equivalent of not supplying -short.

Variables

var FormatTxtar = os.Getenv(envFormatTxtar) != ""

FormatTxtar ensures that .cue files in txtar test archives are well formatted, updating the archive as required prior to running a test.

var UpdateGoldenFiles = os.Getenv(envUpdate) != ""

UpdateGoldenFiles determines whether testscript scripts should update txtar archives in the event of cmp failures. It corresponds to testscript.Params.UpdateGoldenFiles. See the docs for testscript.Params.UpdateGoldenFiles for more details.

Functions

func Condition

func Condition(cond string) (bool, error)

Condition adds support for CUE-specific testscript conditions within testscript scripts. Supported conditions include:

[long] - evalutates to true when the long build tag is specified

golang.org/issue/N - evaluates to true unless CUE_NON_ISSUES is set to a regexp that matches the condition, i.e. golang.org/issue/N in this case

cuelang.org/issue/N - evaluates to true unless CUE_NON_ISSUES is set to a regexp that matches the condition, i.e. cuelang.org/issue/N in this case

func IssueSkip

func IssueSkip(t *testing.T, s string)

IssueSkip causes the test t to be skipped unless the issue identified by s is deemed to be a non-issue by CUE_NON_ISSUES.

Types

type Chunker

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

A Chunker is used to find segments in text.

func NewChunker

func NewChunker(t *testing.T, b []byte) *Chunker

NewChunker returns a new chunker.

func (*Chunker) Bytes

func (c *Chunker) Bytes() []byte

Bytes returns the segment captured by the last call to Next or Find.

func (*Chunker) Find

func (c *Chunker) Find(key string) bool

Find searches for key from the current position and sets the current segment to the text from current position up till the key's position. If successful, the position is updated to point directly after the occurrence of key.

func (*Chunker) Next

func (c *Chunker) Next(beg, end string) bool

Next finds the first occurrence from the current scan position of beg, records the segment from that position until the first occurrence of end and then updates the current position. It reports whether a segment enclosed by beg and end can be found.

func (*Chunker) Text

func (c *Chunker) Text() string

Text returns the text segment captured by the last call to Next or Find.