package internal

import "cuelang.org/go/internal"

Package internal exposes some cue internals to other packages.

A better name for this package would be technicaldebt.

Index ¶

• Variables
• func FileComments(f *ast.File) (docs, rest []*ast.CommentGroup)
• func GenPath(root string) string
• func IsDef(s string) bool
• func IsDefOrHidden(s string) bool
• func IsDefinition(label ast.Label) bool
• func IsHidden(s string) bool
• func IsRegularField(f *ast.Field) bool
• func NewComment(isDoc bool, s string) *ast.CommentGroup
• func Package(f *ast.File) (*ast.Package, int)
• func SetConstraint(f *ast.Field, t token.Token)
• func ToExpr(n ast.Node) ast.Expr
• func ToFile(n ast.Node) *ast.File
• type Attr
• func NewNonExisting(key string) Attr
• func ParseAttrBody(pos token.Pos, s string) (a Attr)
• func (a *Attr) Flag(pos int, key string) (bool, error)
• func (a *Attr) Int(pos int) (int64, error)
• func (a *Attr) Lookup(pos int, key string) (val string, found bool, err error)
• func (a *Attr) String(pos int) (string, error)
• type AttrKind
• type Context
• func (c Context) Quo(d, x, y *apd.Decimal) (apd.Condition, error)
• func (c Context) Sqrt(d, x *apd.Decimal) (apd.Condition, error)
• func (c Context) WithPrecision(p uint32) Context
• type Decimal
• type EvaluatorVersion
• type KeyValue
• func (kv *KeyValue) Key() string
• func (kv *KeyValue) Text() string
• func (kv *KeyValue) Value() string

Variables ¶

var BaseContext = Context{*apd.BaseContext.WithPrecision(34)}

BaseContext is used as CUE's default context for arbitrary-precision decimals.

Functions ¶

func FileComments ¶

func FileComments(f *ast.File) (docs, rest []*ast.CommentGroup)

func GenPath ¶

func GenPath(root string) string

GenPath reports the directory in which to store generated files.

func IsDef ¶

func IsDef(s string) bool

func IsDefOrHidden ¶

func IsDefOrHidden(s string) bool

func IsDefinition ¶

func IsDefinition(label ast.Label) bool

func IsHidden ¶

func IsHidden(s string) bool

func IsRegularField ¶

func IsRegularField(f *ast.Field) bool

func NewComment ¶

func NewComment(isDoc bool, s string) *ast.CommentGroup

NewComment creates a new CommentGroup from the given text. Each line is prefixed with "//" and the last newline is removed. Useful for ASTs generated by code other than the CUE parser.

func Package ¶

func Package(f *ast.File) (*ast.Package, int)

Package finds the package declaration from the preamble of a file, returning it, and its index within the file's Decls.

func SetConstraint ¶

func SetConstraint(f *ast.Field, t token.Token)

SetConstraints sets both the main and deprecated fields of f according to the given constraint token.

func ToExpr ¶

func ToExpr(n ast.Node) ast.Expr

ToExpr converts a node to an expression. If it is a file, it will return it as a struct. If is an expression, it will return it as is. Otherwise it panics.

func ToFile ¶

func ToFile(n ast.Node) *ast.File

ToFile converts an expression to a file.

Adjusts the spacing of x when needed.

Types ¶

type Attr ¶

type Attr struct {
	Name   string // e.g. "json" or "protobuf"
	Body   string
	Kind   AttrKind
	Fields []KeyValue
	Err    errors.Error
	Pos    token.Pos
}

Attr holds positional information for a single Attr.

func NewNonExisting ¶

func NewNonExisting(key string) Attr

NewNonExisting creates a non-existing attribute.

func ParseAttrBody ¶

func ParseAttrBody(pos token.Pos, s string) (a Attr)

func (*Attr) Flag ¶

func (a *Attr) Flag(pos int, key string) (bool, error)

Flag reports whether an entry with the given name exists at position pos or onwards or an error if the attribute is invalid or if the first pos-1 entries are not defined.

func (*Attr) Int ¶

func (a *Attr) Int(pos int) (int64, error)

Int reports the integer at the given position or an error if the attribute is invalid, the position does not exist, or the value at the given position is not an integer.

func (*Attr) Lookup ¶

func (a *Attr) Lookup(pos int, key string) (val string, found bool, err error)

Lookup searches for an entry of the form key=value from position pos onwards and reports the value if found. It reports an error if the attribute is invalid or if the first pos-1 entries are not defined.

func (*Attr) String ¶

func (a *Attr) String(pos int) (string, error)

String reports the possibly empty string value at the given position or an error the attribute is invalid or if the position does not exist.

type AttrKind ¶

type AttrKind uint8

AttrKind indicates the location of an attribute within CUE source.

const (
	// FieldAttr indicates an attribute is a field attribute.
	// foo: bar @attr()
	FieldAttr AttrKind = 1 << iota

	// DeclAttr indicates an attribute was specified at a declaration position.
	// foo: {
	//     @attr()
	// }
	DeclAttr
)

type Context ¶

type Context struct {
	apd.Context
}

Context wraps apd.Context for CUE's custom logic.

Note that it avoids pointers to make it easier to make copies.

func (Context) Quo ¶

func (c Context) Quo(d, x, y *apd.Decimal) (apd.Condition, error)

func (Context) Sqrt ¶

func (c Context) Sqrt(d, x *apd.Decimal) (apd.Condition, error)

func (Context) WithPrecision ¶

func (c Context) WithPrecision(p uint32) Context

WithPrecision mirrors upstream, but returning our type without a pointer.

type Decimal ¶

type Decimal = apd.Decimal

A Decimal is an arbitrary-precision binary-coded decimal number.

Right now Decimal is aliased to apd.Decimal. This may change in the future.

type EvaluatorVersion ¶

type EvaluatorVersion int

EvaluatorVersion is declared here so it can be used everywhere without import cycles, but the canonical documentation lives at cuelang.org/go/cue/cuecontext.EvalVersion.

TODO(mvdan): rename to EvalVersion for consistency with cuecontext.

const (
	// EvalVersionUnset is the zero value, which signals that no evaluator version is provided.
	EvalVersionUnset EvaluatorVersion = 0

	// DefaultVersion is a special value as it selects a version depending on the current
	// value of CUE_EXPERIMENT. It exists separately to [EvalVersionUnset], even though both
	// implement the same version selection logic, so that we can distinguish between
	// a user explicitly asking for the default version versus an entirely unset version.
	DefaultVersion EvaluatorVersion = -1 // TODO(mvdan): rename to EvalDefault for consistency with cuecontext

	EvalV2 EvaluatorVersion = 2
	EvalV3 EvaluatorVersion = 3

	StableVersion = EvalV3 // TODO(mvdan): rename to EvalStable for consistency with cuecontext
	DevVersion    = EvalV3 // TODO(mvdan): rename to EvalExperiment for consistency with cuecontext
)

type KeyValue ¶

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

func (*KeyValue) Key ¶

func (kv *KeyValue) Key() string

func (*KeyValue) Text ¶

func (kv *KeyValue) Text() string

func (*KeyValue) Value ¶

func (kv *KeyValue) Value() string

Source Files ¶

attrs.go internal.go

Directories ¶