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 ¶
const RaceEnabled = false
Variables ¶
var ForceUpdateGoldenFiles = os.Getenv(envUpdate) == "force"
ForceUpdateGoldenFiles determines whether tests should update expected output in test files even when they would not be updated usually (for example when there are test regressions).
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. It is controlled by setting CUE_FORMAT_TXTAR to a non-empty string like "true".
var UpdateGoldenFiles = os.Getenv(envUpdate) != ""
UpdateGoldenFiles determines whether tests should update expected output in test files in the event of comparison failures (for example after a cmp failure in a testscript-based test). It is controlled by setting CUE_UPDATE to a non-empty string like "1" or "true". It corresponds to testscript.Params.UpdateGoldenFiles; see its docs for details.
In some cases, tests might refuse to perform some updates by default. The special value "force" can be used to force updates in that situation.
Functions ¶
func Condition ¶ added in v0.3.0
func Condition(cond string) (bool, error)
Condition adds support for CUE-specific testscript conditions within testscript scripts. Supported conditions include:
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
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.
Source Files