1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197
|
// Copyright 2023 CUE Authors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package adt
import "strings"
// The functions and types in this file are use to construct test cases for
// fields_test.go and constraints_test.
// MatchPatternValue exports matchPatternValue for testing.
func MatchPatternValue(ctx *OpContext, p Value, f Feature, label Value) bool {
return matchPatternValue(ctx, p, f, label)
}
// FieldTester is used low-level testing of field insertion. It simulates
// how the evaluator inserts fields. This allows the closedness algorithm to be
// tested independently of the underlying evaluator implementation.
type FieldTester struct {
*OpContext
n *nodeContext
cc *closeContext
Root *Vertex
}
func NewFieldTester(r Runtime) *FieldTester {
v := &Vertex{}
ctx := New(v, &Config{Runtime: r})
n := v.getNodeContext(ctx, 1)
return &FieldTester{
OpContext: ctx,
n: n,
cc: v.rootCloseContext(ctx),
Root: v,
}
}
func (x *FieldTester) Error() string {
if b := x.n.node.Bottom(); b != nil && b.Err != nil {
return b.Err.Error()
}
var errs []string
for _, a := range x.n.node.Arcs {
if b := a.Bottom(); b != nil && b.Err != nil {
errs = append(errs, b.Err.Error())
}
}
return strings.Join(errs, "\n")
}
type declaration func(cc *closeContext)
// Run simulates a CUE evaluation of the given declarations.
func (x *FieldTester) Run(sub ...declaration) {
x.cc.incDependent(x.n.ctx, TEST, nil)
for i, s := range sub {
// We want to have i around for debugging purposes. Use i to avoid
// compiler error.
_ = i
s(x.cc)
}
x.cc.decDependent(x.n.ctx, TEST, nil)
x.cc.decDependent(x.n.ctx, ROOT, nil) // REF(decrement:nodeDone)
}
// Def represents fields that define a definition, such that
// Def(Field("a", "foo"), Field("b", "bar")) represents:
//
// #D: {
// a: "foo"
// b: "bar"
// }
//
// For some unique #D.
func (x *FieldTester) Def(sub ...declaration) declaration {
return x.spawn(closeDef, sub...)
}
func (x *FieldTester) spawn(t closeNodeType, sub ...declaration) declaration {
return func(cc *closeContext) {
ci := CloseInfo{cc: cc}
_, dc := ci.spawnCloseContext(x.n.ctx, t)
dc.incDependent(x.n.ctx, TEST, nil)
for _, sfn := range sub {
sfn(dc)
}
dc.decDependent(x.n.ctx, TEST, nil)
}
}
// Embed represents fields embedded within the current node, such that
// Embed(Field("a", "foo"), Def(Field("b", "bar"))) represents:
//
// {
// {
// a: "foo"
// #D
// }
// }
//
// For some #D: b: "bar".
func (x *FieldTester) Embed(sub ...declaration) declaration {
return x.spawn(closeEmbed, sub...)
}
// Group represents fields and embeddings within a single set of curly braces.
// This is used to test that an embedding of a closed value closes the struct
// in which it is embedded.
func (x *FieldTester) Group(sub ...declaration) declaration {
return x.spawn(0, sub...)
}
// EmbedDef represents fields that define a struct and embedded within the
// current node.
func (x *FieldTester) EmbedDef(sub ...declaration) declaration {
return x.Embed(x.Def(sub...))
}
// Field defines a field declaration such that Field("a", "foo") represents
//
// a: "foo"
//
// The value can be of type string, int64, bool, or Expr.
// Duplicate values (conjuncts) are retained as the deduplication check is
// bypassed for this.
func (x *FieldTester) Field(label string, a any) declaration {
return x.field(label, a, false)
}
// FieldDedup is like Field, but enables conjunct deduplication.
func (x *FieldTester) FieldDedup(label string, a any) declaration {
return x.field(label, a, true)
}
func (x *FieldTester) field(label string, a any, dedup bool) declaration {
f := x.StringLabel(label)
var v Expr
switch a := a.(type) {
case Expr:
v = a
case string:
v = x.NewString(a)
case int:
v = x.NewInt64(int64(a))
case bool:
v = x.newBool(a)
default:
panic("type not supported")
}
return func(cc *closeContext) {
var c Conjunct
c.Env = &Environment{Vertex: x.Root}
c.CloseInfo.cc = cc
c.x = v
c.CloseInfo.FromDef = cc.isDef
c.CloseInfo.FromEmbed = cc.isEmbed
x.n.insertArc(f, ArcMember, c, c.CloseInfo, dedup)
}
}
// Pat represents a pattern constraint, such that Pat(`<"a"`, "foo") represents
//
// [<"a"]: "foo"
func (x *FieldTester) Pat(pattern Value, v Expr) declaration {
if pattern == nil {
panic("nil pattern")
}
if v == nil {
panic("nil expr")
}
return func(cc *closeContext) {
var c Conjunct
c.Env = &Environment{Vertex: x.Root}
c.CloseInfo.cc = cc
c.x = v
c.CloseInfo.FromDef = cc.isDef
c.CloseInfo.FromEmbed = cc.isEmbed
x.n.insertPattern(pattern, c)
}
}
|