compiler

Documentation

Overview

The compiler package provides a compiler and Go runtime for a subset of the Flux language. Only pure functions are supported by the compiler. A function is compiled and then may be called repeatedly with different arguments. The function must be pure meaning it has no side effects. Other language features are not supported.

This runtime is not portable by design. The runtime consists of Go types that have been constructed based on the Flux function being compiled. Those types are not serializable and cannot be transported to other systems or environments. This design is intended to limit the scope under which compilation must be supported.

Index

• type CompilationCache
  • func NewCompilationCache(fn *semantic.FunctionExpression, scope Scope) *CompilationCache
  • func (c *CompilationCache) Compile(in semantic.Type) (Func, error)
• type Evaluator
• type Func
  • func Compile(f *semantic.FunctionExpression, in semantic.Type, builtins Scope) (Func, error)
  • func CompileFnParam(fn *semantic.FunctionExpression, paramType, returnType semantic.Type) (Func, string, error)
  • func CompileReduceFn(fn *semantic.FunctionExpression, paramType semantic.Type) (Func, []string, error)
• type Scope
  • func (s Scope) Copy() Scope
  • func (s Scope) Get(name string) values.Value
  • func (s Scope) Set(name string, v values.Value)
  • func (s Scope) Type(name string) semantic.Type

Types

type CompilationCache

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

CompilationCache caches compilation results based on the type of the function.

func NewCompilationCache

func NewCompilationCache(fn *semantic.FunctionExpression, scope Scope) *CompilationCache

func (*CompilationCache) Compile

func (c *CompilationCache) Compile(in semantic.Type) (Func, error)

Compile returns a compiled function based on the provided type. The result will be cached for subsequent calls.

type Evaluator

type Evaluator interface {
	Type() semantic.Type
	Eval(scope Scope) (values.Value, error)
}

type Func

type Func interface {
	Type() semantic.Type
	Eval(input values.Object) (values.Value, error)
}

func Compile

func Compile(f *semantic.FunctionExpression, in semantic.Type, builtins Scope) (Func, error)

func CompileFnParam

func CompileFnParam(fn *semantic.FunctionExpression, paramType, returnType semantic.Type) (Func, string, error)

Utility function for compiling an `fn` parameter for rename or drop/keep. In addition to the function expression, it takes two types to verify the result against: a single argument type, and a single return type.

func CompileReduceFn

func CompileReduceFn(fn *semantic.FunctionExpression, paramType semantic.Type) (Func, []string, error)

type Scope

type Scope map[string]values.Value

func (Scope) Copy

func (s Scope) Copy() Scope

func (Scope) Get

func (s Scope) Get(name string) values.Value

func (Scope) Set

func (s Scope) Set(name string, v values.Value)

func (Scope) Type

func (s Scope) Type(name string) semantic.Type