var = &Runtime{index: sharedIndex}
func RegisterBuiltin(importPath string, f PackageFunc)
A Compiler fills in an adt.Expr for fields marked with `@extern(kind)`.
type Compiler interface {
// Compile creates an adt.Expr (usually a builtin) for the
// given external named resource (usually a function). name
// is the name of the resource to compile, taken from altName
// in `@extern(name=altName)`, or from the field name if that's
// not defined. Scope is the struct that contains the field.
// Other than "name", the fields in a are implementation
// specific.
Compile(name string, scope adt.Value, a *internal.Attr) (adt.Expr, errors.Error)
}
type Config struct {
Runtime *Runtime
Filename string
ImportPath string
Counts *stats.Counts
compile.Config
}
Interpreter defines an entrypoint for creating per-package interpreters.
type Interpreter interface {
// NewCompiler creates a compiler for b and reports any errors.
NewCompiler(b *build.Instance, r *Runtime) (Compiler, errors.Error)
// Kind returns the string to be used in the file-level @extern attribute.
Kind() string
}
type PackageFunc func(ctx adt.Runtime) (*adt.Vertex, errors.Error)
A Runtime maintains data structures for indexing and reuse for evaluation.
type Runtime struct {
// contains filtered or unexported fields
}
func New() *Runtime
New is a wrapper for NewVersioned(internal.DefaultVersion).
func NewVersioned(v internal.EvaluatorVersion) *Runtime
NewVersioned creates a new Runtime using the given runtime version. The builtins registered with RegisterBuiltin are available for evaluation.
func (r *Runtime) AddInst(path string, key *adt.Vertex, p *build.Instance)
func (x *Runtime) Build(cfg *Config, b *build.Instance) (v *adt.Vertex, errs errors.Error)
Build builds b and all its transitive dependencies, insofar they have not been build yet.
func (r *Runtime) BuildData(b *build.Instance) (x interface{}, ok bool)
func (x *Runtime) BuiltinPackagePath(path string) string
BuiltinPackagePath converts a short-form builtin package identifier to its full path or "" if this doesn't exist.
func (r *Runtime) Compile(cfg *Config, source interface{}) (*adt.Vertex, *build.Instance)
func (r *Runtime) CompileFile(cfg *Config, file *ast.File) (*adt.Vertex, *build.Instance)
func (r *Runtime) EvaluatorVersion() internal.EvaluatorVersion
func (r *Runtime) GetInstanceFromNode(key *adt.Vertex) *build.Instance
func (r *Runtime) IndexToString(i int64) string
func (r *Runtime) Init()
func (r *Runtime) IsInitialized() bool
IsInitialized reports whether the runtime has been initialized.
func (r *Runtime) Label(s string, isIdent bool) adt.Feature
func (r *Runtime) LabelStr(l adt.Feature) string
func (r *Runtime) LoadImport(importPath string) *adt.Vertex
func (x *Runtime) LoadType(t reflect.Type) (src ast.Expr, expr adt.Expr, ok bool)
func (r *Runtime) NextUniqueID() uint64
func (r *Runtime) ResolveFiles(p *build.Instance) (errs errors.Error)
TODO(resolve): this is also done in compile, do we need both?
func (r *Runtime) SetBuildData(b *build.Instance, x interface{})
func (r *Runtime) SetInterpreter(i Interpreter)
SetInterpreter sets the interpreter for interpretation of files marked with @extern(kind).
func (x *Runtime) StoreType(t reflect.Type, src ast.Expr, expr adt.Expr)
func (r *Runtime) StrLabel(str string) adt.Feature
func (r *Runtime) StringToIndex(s string) int64