object

package
v0.24.3 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 5, 2026 License: MIT Imports: 16 Imported by: 1

Documentation

Index

Constants

View Source 
const (

	// Type conversion error messages (exported for use by external packages)
	ErrMustBeString   = "must be a string"
	ErrMustBeInteger  = "must be an integer"
	ErrMustBeNumber   = "must be a number"
	ErrMustBeBoolean  = "must be a boolean"
	ErrMustBeList     = "must be a list"
	ErrMustBeDict     = "must be a dict"
	ErrMustBeIterable = "must be iterable"
	ErrMustBeBytes    = "must be bytes or string"
)

Small integer cache for common values (-5 to 10000) This follows Python's approach and eliminates allocations for loop counters Extended range to 10000 for better loop performance

View Source 
const (
	ExceptionTypeSystemExit        = "SystemExit"
	ExceptionTypePermissionError   = "PermissionError"
	ExceptionTypeException         = "Exception"
	ExceptionTypeValueError        = "ValueError"
	ExceptionTypeTypeError         = "TypeError"
	ExceptionTypeNameError         = "NameError"
	ExceptionTypeImportError       = "ImportError"
	ExceptionTypeStopIteration     = "StopIteration"
	ExceptionTypeRuntimeError      = "RuntimeError"
	ExceptionTypeZeroDivisionError = "ZeroDivisionError"
	ExceptionTypeIndexError        = "IndexError"
	ExceptionTypeKeyError          = "KeyError"
	ExceptionTypeAttributeError    = "AttributeError"
	ExceptionTypeOSError           = "OSError"
	ExceptionTypeGeneric           = "" // Default for legacy compatibility
)

Exception type constants

Variables

View Source 
var (
	BREAK    = &Break{}
	CONTINUE = &Continue{}
)

Break and Continue singletons (like NULL, TRUE, FALSE)

Functions

func AsError 

func AsError(obj Object) string

AsError returns the error message from an Object, or empty string if not an error. This is a shared helper for extracting error messages from Objects.

func ClearGCReleaseHook added in v0.10.0 

func ClearGCReleaseHook(target any) error

ClearGCReleaseHook removes a release hook previously installed with SetGCReleaseHook. It is safe to call when no hook is installed.

func DictKey 

func DictKey(obj Object) string

DictKey returns a canonical string key for use in Dict and Set maps. Matches Python 3 semantics where:

  • int(1), float(1.0), and True all map to the same key
  • str("1") maps to a different key
  • None maps to its own unique key

func DictStringKey added in v0.7.1 

func DictStringKey(name string) string

DictStringKey returns the canonical dict key for a string key without requiring a temporary String object allocation. It must agree with the *String case of DictKey.

func GetFloatArrayData added in v0.6.3 

func GetFloatArrayData(obj Object) ([]float64, []int, bool)

func GetFloatMatrix added in v0.6.4 

func GetFloatMatrix(obj Object) (data []float64, rows, cols int, ok bool)

func InstanceDataFromContext 

func InstanceDataFromContext(ctx context.Context) any

InstanceDataFromContext retrieves instance data from the context Returns nil if no instance data is present

func IsError 

func IsError(obj Object) bool

IsError returns true if the object is an Error type.

This uses a concrete type assertion rather than obj.Type() == ERROR_OBJ: the assertion compiles to a single itab pointer comparison, avoiding the non-inlinable interface method call on this very hot path.

func IsFloatArray added in v0.6.3 

func IsFloatArray(obj Object) bool

func IsHashable added in v0.3.2 

func IsHashable(obj Object) bool

IsHashable reports whether obj can be used as a set element or dict key. Matches Python semantics: int, float, bool, string, bytes, None, and tuples of hashable elements are hashable; lists, dicts, sets, and instances are not unless the instance defines __hash__.

func ReleaseArgs added in v0.20.0 

func ReleaseArgs(env *Environment, args []Object)

ReleaseArgs clears args and returns its backing array to the tree's per-root free-list for reuse. Safe to call with nil/empty args (no-op) and on slices not obtained from AcquireArgs (they simply join the pool). The full backing capacity is cleared so no Object is pinned by an idle buffer.

func ReleaseCallEnvironment added in v0.7.1 

func ReleaseCallEnvironment(env *Environment)

ReleaseCallEnvironment clears a call frame and returns it to its tree's per-root free-list for reuse. Non-pooled environments are ignored. See AcquireCallEnvironment for the no-lock concurrency contract.

func ReleaseReturnValue added in v0.15.0 

func ReleaseReturnValue(rv *ReturnValue)

ReleaseReturnValue clears rv and returns it to its tree's free-list for reuse. Wrappers with no associated root (constructed outside AcquireReturnValue) are left for the garbage collector.

func RunBlocking added in v0.15.0 

func RunBlocking(ctx interface{ Value(any) any }, fn func())

RunBlocking runs fn (a blocking operation such as sleep or a socket read) with the interpreter lock released, so other goroutines can run script code in the same tree while this one is blocked. If no environment is available on the context it simply runs fn. Builtins that block should wrap the blocking call in RunBlocking.

func SetGCReleaseHook added in v0.10.0 

func SetGCReleaseHook(target any, hook func()) error

SetGCReleaseHook installs hook as a best-effort callback for when target is released by Go's garbage collector.

The target must be a non-nil pointer. The hook must not retain target, either directly or through captured values, or the object will not become unreachable. Finalizers are not prompt and may never run before process exit, so callers should use explicit cleanup for resources that need deterministic release.

func ValidateTransferable added in v0.5.2 

func ValidateTransferable(obj Object) error

ValidateTransferable checks whether obj contains only types that can be safely passed to a background task. Transferable types are scalars (Null, Boolean, Integer, Float, String) and recursively transferable containers (List, Dict, Set, Tuple). Instances, classes, functions, builtins, and other stateful objects are rejected. Circular references are also rejected.

Types

type Boolean 

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

func NewBoolean added in v0.5.2 

func NewBoolean(v bool) *Boolean

func (*Boolean) AsBool 

func (b *Boolean) AsBool() (bool, Object)

func (*Boolean) AsDict 

func (b *Boolean) AsDict() (map[string]Object, Object)

func (*Boolean) AsFloat 

func (b *Boolean) AsFloat() (float64, Object)

func (*Boolean) AsInt 

func (b *Boolean) AsInt() (int64, Object)

func (*Boolean) AsList 

func (b *Boolean) AsList() ([]Object, Object)

func (*Boolean) AsString 

func (b *Boolean) AsString() (string, Object)

func (*Boolean) BoolValue added in v0.8.0 

func (b *Boolean) BoolValue() bool

func (*Boolean) CoerceFloat 

func (b *Boolean) CoerceFloat() (float64, Object)

func (*Boolean) CoerceInt 

func (b *Boolean) CoerceInt() (int64, Object)

func (*Boolean) CoerceString 

func (b *Boolean) CoerceString() (string, Object)

func (*Boolean) Inspect 

func (b *Boolean) Inspect() string

func (*Boolean) Type 

func (b *Boolean) Type() ObjectType

type BoundMethod 

type BoundMethod struct {
	Instance Object // The instance (self)
	Method   Object // The method function
	// contains filtered or unexported fields
}

BoundMethod represents a method bound to an instance When called, it automatically prepends self to the arguments

func (*BoundMethod) AsBool 

func (bm *BoundMethod) AsBool() (bool, Object)

func (*BoundMethod) AsDict 

func (bm *BoundMethod) AsDict() (map[string]Object, Object)

func (*BoundMethod) AsFloat 

func (bm *BoundMethod) AsFloat() (float64, Object)

func (*BoundMethod) AsInt 

func (bm *BoundMethod) AsInt() (int64, Object)

func (*BoundMethod) AsList 

func (bm *BoundMethod) AsList() ([]Object, Object)

func (*BoundMethod) AsString 

func (bm *BoundMethod) AsString() (string, Object)

func (*BoundMethod) CoerceFloat 

func (bm *BoundMethod) CoerceFloat() (float64, Object)

func (*BoundMethod) CoerceInt 

func (bm *BoundMethod) CoerceInt() (int64, Object)

func (*BoundMethod) CoerceString 

func (bm *BoundMethod) CoerceString() (string, Object)

func (*BoundMethod) Inspect 

func (bm *BoundMethod) Inspect() string

func (*BoundMethod) SelfArgs added in v0.5.6 

func (bm *BoundMethod) SelfArgs() []Object

func (*BoundMethod) Type 

func (bm *BoundMethod) Type() ObjectType

type Break 

type Break struct{}

func (*Break) AsBool 

func (b *Break) AsBool() (bool, Object)

func (*Break) AsDict 

func (b *Break) AsDict() (map[string]Object, Object)

func (*Break) AsFloat 

func (b *Break) AsFloat() (float64, Object)

func (*Break) AsInt 

func (b *Break) AsInt() (int64, Object)

func (*Break) AsList 

func (b *Break) AsList() ([]Object, Object)

func (*Break) AsString 

func (b *Break) AsString() (string, Object)

func (*Break) CoerceFloat 

func (b *Break) CoerceFloat() (float64, Object)

func (*Break) CoerceInt 

func (b *Break) CoerceInt() (int64, Object)

func (*Break) CoerceString 

func (b *Break) CoerceString() (string, Object)

func (*Break) Inspect 

func (b *Break) Inspect() string

func (*Break) Type 

func (b *Break) Type() ObjectType

type Builtin 

type Builtin struct {
	Fn         BuiltinFunction
	HelpText   string            // Optional help documentation for this builtin
	Attributes map[string]Object // Optional attributes for this builtin
}

func (*Builtin) AsBool 

func (b *Builtin) AsBool() (bool, Object)

func (*Builtin) AsDict 

func (b *Builtin) AsDict() (map[string]Object, Object)

func (*Builtin) AsFloat 

func (b *Builtin) AsFloat() (float64, Object)

func (*Builtin) AsInt 

func (b *Builtin) AsInt() (int64, Object)

func (*Builtin) AsList 

func (b *Builtin) AsList() ([]Object, Object)

func (*Builtin) AsString 

func (b *Builtin) AsString() (string, Object)

func (*Builtin) CoerceFloat 

func (b *Builtin) CoerceFloat() (float64, Object)

func (*Builtin) CoerceInt 

func (b *Builtin) CoerceInt() (int64, Object)

func (*Builtin) CoerceString 

func (b *Builtin) CoerceString() (string, Object)

func (*Builtin) Inspect 

func (b *Builtin) Inspect() string

func (*Builtin) Type 

func (b *Builtin) Type() ObjectType

type BuiltinFunction 

type BuiltinFunction func(ctx context.Context, kwargs Kwargs, args ...Object) Object

BuiltinFunction is the signature for all builtin functions

  • ctx: Context with environment and runtime information
  • kwargs: Keyword arguments passed to the function (wrapped with helper methods)
  • args: Positional arguments passed to the function

The args slice is BORROWED for the duration of the call: the evaluator reuses the backing array across calls (a per-root free-list, see AcquireArgs). A builtin must therefore not retain args — or any sub-slice such as args[1:] — past the point it returns. Reading elements (args[i], ranging over args, spreading args... into a synchronous call) is always safe; storing the slice in a struct field/map/global, capturing it in a goroutine or returned closure, or using it as a List's Elements requires copying first (make + copy). This matches the convention of CPython's tp_call and Go variadic APIs.

type Bytes added in v0.19.0 

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

Bytes is an immutable sequence of byte values (0-255), analogous to Python's bytes type. It is the canonical representation for binary data in Scriptling. Strict string operations raise a type error; use Decode() to obtain a string.

func NewBytes added in v0.19.0 

func NewBytes(b []byte) *Bytes

NewBytes returns a new Bytes object that owns a defensive copy of the given slice, so callers may freely mutate the original after the call.

func NewBytesFromString added in v0.19.0 

func NewBytesFromString(s string) *Bytes

NewBytesFromString returns a Bytes object whose contents are the UTF-8 encoding of s. This is the equivalent of Python's str.encode("utf-8").

func (*Bytes) AsBool added in v0.19.0 

func (b *Bytes) AsBool() (bool, Object)

func (*Bytes) AsDict added in v0.19.0 

func (b *Bytes) AsDict() (map[string]Object, Object)

func (*Bytes) AsFloat added in v0.19.0 

func (b *Bytes) AsFloat() (float64, Object)

func (*Bytes) AsInt added in v0.19.0 

func (b *Bytes) AsInt() (int64, Object)

func (*Bytes) AsList added in v0.19.0 

func (b *Bytes) AsList() ([]Object, Object)

func (*Bytes) AsString added in v0.19.0 

func (b *Bytes) AsString() (string, Object)

AsString is strict: bytes are not strings. Callers that need a string must call Decode() explicitly (the .decode() method on Bytes). This mirrors Python's TypeError on mixing bytes and str.

func (*Bytes) BytesValue added in v0.19.0 

func (b *Bytes) BytesValue() []byte

BytesValue returns the underlying byte slice. Callers MUST NOT mutate the returned slice; treat it as read-only. If mutation is required, copy it.

func (*Bytes) CoerceFloat added in v0.19.0 

func (b *Bytes) CoerceFloat() (float64, Object)

func (*Bytes) CoerceInt added in v0.19.0 

func (b *Bytes) CoerceInt() (int64, Object)

CoerceInt returns the length, mirroring the way Python treats bool/len coercion for truthiness only; numeric coercion of bytes is not meaningful.

func (*Bytes) CoerceString added in v0.19.0 

func (b *Bytes) CoerceString() (string, Object)

CoerceString returns a base64-encoded representation so that Bytes values can be printed, concatenated into error messages, or interpolated into f-strings without raising. Explicit decoding via .decode() should be preferred for real text content.

func (*Bytes) Equal added in v0.19.0 

func (b *Bytes) Equal(other *Bytes) bool

Equal reports whether two Bytes values have identical contents.

func (*Bytes) Inspect added in v0.19.0 

func (b *Bytes) Inspect() string

Inspect returns a Python-style repr such as b'hello' or b'\x00\xff', suitable for debugging and print(). The default print() path uses CoerceString for a human-readable form; this is what shows up in the REPL and error messages.

func (*Bytes) Len added in v0.19.0 

func (b *Bytes) Len() int

Len returns the number of bytes.

func (*Bytes) Type added in v0.19.0 

func (b *Bytes) Type() ObjectType

type CallableSnapshot added in v0.6.3 

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

CallableSnapshot holds a snapshot of callable and scalar bindings safe to pass across goroutine boundaries. Use ApplySnapshot to write them into a new Environment.

func (*CallableSnapshot) ApplySnapshot added in v0.6.3 

func (s *CallableSnapshot) ApplySnapshot(target *Environment)

ApplySnapshot writes the snapshot's bindings into target, rebound to target so closures resolve correctly. Dicts are deep-copied so concurrent tasks don't race when mutating intermediate dicts. Scalars are shared as-is — they are immutable value objects.

type Class 

type Class struct {
	Name      string
	BaseClass *Class // optional parent class for inheritance
	Methods   map[string]Object
	Env       *Environment
	// contains filtered or unexported fields
}

func (*Class) AsBool 

func (c *Class) AsBool() (bool, Object)

func (*Class) AsDict 

func (c *Class) AsDict() (map[string]Object, Object)

func (*Class) AsFloat 

func (c *Class) AsFloat() (float64, Object)

func (*Class) AsInt 

func (c *Class) AsInt() (int64, Object)

func (*Class) AsList 

func (c *Class) AsList() ([]Object, Object)

func (*Class) AsString 

func (c *Class) AsString() (string, Object)

func (*Class) CoerceFloat 

func (c *Class) CoerceFloat() (float64, Object)

func (*Class) CoerceInt 

func (c *Class) CoerceInt() (int64, Object)

func (*Class) CoerceString 

func (c *Class) CoerceString() (string, Object)

func (*Class) Inspect 

func (c *Class) Inspect() string

func (*Class) InvalidateLookupCache added in v0.5.6 

func (c *Class) InvalidateLookupCache()

func (*Class) LookupMember added in v0.5.6 

func (c *Class) LookupMember(name string) (Object, bool)

func (*Class) Type 

func (c *Class) Type() ObjectType

type ClassBuilder 

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

ClassBuilder provides a fluent API for creating scriptling classes. It allows registering typed Go methods that are automatically wrapped to handle conversion between Go types and scriptling Objects.

Two styles are supported:

1. *Instance methods — manage fields via SetField/Field: 

cb := NewClassBuilder("Person")
cb.Method("__init__", func(self *Instance, name string) {
    self.SetField("name", NewString(name))
})
cb.Method("greet", func(self *Instance) string {
    return self.Field("name").(*String).StringValue()
})

2. Typed receiver methods — Go struct is auto-managed: 

type Config struct { values map[string]any }

cb := NewClassBuilder("Config")
cb.Constructor(func(name string) *Config {
    return &Config{values: map[string]any{"name": name}}
})
cb.Method("get", func(self *Config, key string) any {
    return self.values[key]
})

When Constructor is used, the returned Go struct is automatically wrapped in a ClientWrapper and stored on the Instance. Methods whose first parameter matches the constructor's return type receive the unwrapped struct directly.

func NewClassBuilder 

func NewClassBuilder(name string) *ClassBuilder

NewClassBuilder creates a new ClassBuilder with the given class name.

func (*ClassBuilder) BaseClass 

func (cb *ClassBuilder) BaseClass(base *Class) *ClassBuilder

BaseClass sets the base class for inheritance.

func (*ClassBuilder) Build 

func (cb *ClassBuilder) Build() *Class

Build creates and returns the Class from this builder. If a Constructor was registered, an __init__ method is auto-generated that calls the constructor and stores the result as a ClientWrapper.

func (*ClassBuilder) Constructor added in v0.10.0 

func (cb *ClassBuilder) Constructor(fn interface{}) *ClassBuilder

Constructor registers a constructor function for typed receiver classes. The function must return a pointer type (e.g., *Config) which becomes the receiver type for subsequent Method calls. The returned struct is automatically wrapped in a ClientWrapper and stored on the Instance.

Example: 

type Config struct { values map[string]any }

cb := NewClassBuilder("Config")
cb.Constructor(func(name string) *Config {
    return &Config{values: map[string]any{"name": name}}
})
cb.Method("get", func(self *Config, key string) any {
    return self.values[key]
})

func (*ClassBuilder) Environment 

func (cb *ClassBuilder) Environment(env *Environment) *ClassBuilder

Environment sets the environment for the class. This is optional and usually not needed.

func (*ClassBuilder) Method 

func (cb *ClassBuilder) Method(name string, fn interface{}) *ClassBuilder

Method registers a typed Go method with the class. The first parameter is the receiver: either *Instance (manual Fields) or the typed pointer set by Constructor (e.g., *Config).

Example with *Instance: 

cb.Method("greet", func(self *Instance, name string) string {
    return "Hello, " + name
})

Example with typed receiver: 

cb.Method("get", func(self *Config, key string) any {
    return self.values[key]
})

func (*ClassBuilder) MethodWithHelp 

func (cb *ClassBuilder) MethodWithHelp(name string, fn interface{}, helpText string) *ClassBuilder

MethodWithHelp registers a method with help text. Help text is displayed when users call help() on the method.

func (*ClassBuilder) Property added in v0.2.0 

func (cb *ClassBuilder) Property(name string, fn interface{}) *ClassBuilder

Property registers a getter function as a @property on the class. The getter receives self as its only argument.

Example: 

cb.Property("area", func(self *Instance) float64 {
    r, _ := self.Field("radius").AsFloat()
    return math.Pi * r * r
})

func (*ClassBuilder) PropertyWithSetter added in v0.2.0 

func (cb *ClassBuilder) PropertyWithSetter(name string, getter interface{}, setter interface{}) *ClassBuilder

PropertyWithSetter registers a getter and setter as a @property on the class. The getter receives self only; the setter receives self and the new value.

Example: 

cb.PropertyWithSetter("radius",
    func(self *Instance) float64 { r, _ := self.Field("r").AsFloat(); return r },
    func(self *Instance, v float64) { self.SetField("r", NewFloat(v)) },
)

func (*ClassBuilder) StaticMethod added in v0.2.0 

func (cb *ClassBuilder) StaticMethod(name string, fn interface{}) *ClassBuilder

StaticMethod registers a function as a @staticmethod on the class. The function does NOT receive self — do not include *Instance as the first parameter.

Example: 

cb.StaticMethod("from_degrees", func(deg float64) float64 {
    return deg * math.Pi / 180
})

type ClassMethod added in v0.2.0 

type ClassMethod struct {
	Fn Object
}

ClassMethod wraps a function for use with @classmethod. When called, the class is passed as the first argument instead of self.

func (*ClassMethod) AsBool added in v0.2.0 

func (c *ClassMethod) AsBool() (bool, Object)

func (*ClassMethod) AsDict added in v0.2.0 

func (c *ClassMethod) AsDict() (map[string]Object, Object)

func (*ClassMethod) AsFloat added in v0.2.0 

func (c *ClassMethod) AsFloat() (float64, Object)

func (*ClassMethod) AsInt added in v0.2.0 

func (c *ClassMethod) AsInt() (int64, Object)

func (*ClassMethod) AsList added in v0.2.0 

func (c *ClassMethod) AsList() ([]Object, Object)

func (*ClassMethod) AsString added in v0.2.0 

func (c *ClassMethod) AsString() (string, Object)

func (*ClassMethod) CoerceFloat added in v0.2.0 

func (c *ClassMethod) CoerceFloat() (float64, Object)

func (*ClassMethod) CoerceInt added in v0.2.0 

func (c *ClassMethod) CoerceInt() (int64, Object)

func (*ClassMethod) CoerceString added in v0.2.0 

func (c *ClassMethod) CoerceString() (string, Object)

func (*ClassMethod) Inspect added in v0.2.0 

func (c *ClassMethod) Inspect() string

func (*ClassMethod) Type added in v0.2.0 

func (c *ClassMethod) Type() ObjectType

type ClientWrapper 

type ClientWrapper struct {
	// TypeName is the display name used in Inspect() (e.g., "OpenAIClient", "MCPClient")
	TypeName string
	// Client is the underlying Go client pointer (opaque to scriptling)
	Client any
}

ClientWrapper is a generic wrapper for storing Go client pointers in object.Instance fields. The underlying client is stored as an opaque pointer and accessed via type assertion.

Example usage: 

type MyClientWrapper struct {
    instance *MyClientInstance
}

func (w *MyClientWrapper) Type() ObjectType { return INSTANCE_OBJ }
func (w *MyClientWrapper) Inspect() string { return "<MyClient>" }
// ... implement other Object methods ...

// Store in instance:
instance.SetField("_client", &MyClientWrapper{instance: &MyClientInstance{...}})

// Extract from instance:
wrapper, _ := instance.Field("_client").(*MyClientWrapper)
client := wrapper.instance

For convenience, use NewClientWrapper to create a wrapper with a custom type name.

func GetClientField 

func GetClientField(instance *Instance, fieldName string) (*ClientWrapper, bool)

GetClientField extracts a ClientWrapper from an object.Instance field. Returns the wrapper and true if found, nil and false otherwise.

This is a convenience function for the common pattern of extracting a client wrapper from the "_client" field of an instance.

func (*ClientWrapper) AsBool 

func (w *ClientWrapper) AsBool() (bool, Object)

AsBool returns true - clients are truthy

func (*ClientWrapper) AsDict 

func (w *ClientWrapper) AsDict() (map[string]Object, Object)

AsDict returns an error - clients cannot be converted to dict

func (*ClientWrapper) AsFloat 

func (w *ClientWrapper) AsFloat() (float64, Object)

AsFloat returns an error - clients cannot be converted to float

func (*ClientWrapper) AsInt 

func (w *ClientWrapper) AsInt() (int64, Object)

AsInt returns an error - clients cannot be converted to int

func (*ClientWrapper) AsList 

func (w *ClientWrapper) AsList() ([]Object, Object)

AsList returns an error - clients cannot be converted to list

func (*ClientWrapper) AsString 

func (w *ClientWrapper) AsString() (string, Object)

AsString returns the inspect representation

func (*ClientWrapper) CoerceFloat 

func (w *ClientWrapper) CoerceFloat() (float64, Object)

func (*ClientWrapper) CoerceInt 

func (w *ClientWrapper) CoerceInt() (int64, Object)

func (*ClientWrapper) CoerceString 

func (w *ClientWrapper) CoerceString() (string, Object)

func (*ClientWrapper) Inspect 

func (w *ClientWrapper) Inspect() string

Inspect returns a string representation of the client

func (*ClientWrapper) Type 

func (w *ClientWrapper) Type() ObjectType

Type returns INSTANCE_OBJ as this wrapper represents an instance

type Continue 

type Continue struct{}

func (*Continue) AsBool 

func (c *Continue) AsBool() (bool, Object)

func (*Continue) AsDict 

func (c *Continue) AsDict() (map[string]Object, Object)

func (*Continue) AsFloat 

func (c *Continue) AsFloat() (float64, Object)

func (*Continue) AsInt 

func (c *Continue) AsInt() (int64, Object)

func (*Continue) AsList 

func (c *Continue) AsList() ([]Object, Object)

func (*Continue) AsString 

func (c *Continue) AsString() (string, Object)

func (*Continue) CoerceFloat 

func (c *Continue) CoerceFloat() (float64, Object)

func (*Continue) CoerceInt 

func (c *Continue) CoerceInt() (int64, Object)

func (*Continue) CoerceString 

func (c *Continue) CoerceString() (string, Object)

func (*Continue) Inspect 

func (c *Continue) Inspect() string

func (*Continue) Type 

func (c *Continue) Type() ObjectType

type Dict 

type Dict struct {
	Pairs map[string]DictPair
}

func NewStringDict 

func NewStringDict(entries map[string]Object) *Dict

NewStringDict creates a Dict from string key-value pairs. Usage: NewStringDict(map[string]Object{"key": value, ...})

func (*Dict) AsBool 

func (d *Dict) AsBool() (bool, Object)

func (*Dict) AsDict 

func (d *Dict) AsDict() (map[string]Object, Object)

func (*Dict) AsFloat 

func (d *Dict) AsFloat() (float64, Object)

func (*Dict) AsInt 

func (d *Dict) AsInt() (int64, Object)

func (*Dict) AsList 

func (d *Dict) AsList() ([]Object, Object)

func (*Dict) AsString 

func (d *Dict) AsString() (string, Object)

func (*Dict) CoerceFloat 

func (d *Dict) CoerceFloat() (float64, Object)

func (*Dict) CoerceInt 

func (d *Dict) CoerceInt() (int64, Object)

func (*Dict) CoerceString 

func (d *Dict) CoerceString() (string, Object)

func (*Dict) CreateIterator added in v0.20.0 

func (d *Dict) CreateIterator() *Iterator

CreateIterator returns an iterator over the dict's keys. In Python, iterating a dict yields its keys (same as dict.keys()).

func (*Dict) DeleteByString 

func (d *Dict) DeleteByString(name string) bool

DeleteByString deletes a string key from the dict. Returns true if key existed.

func (*Dict) GetByString 

func (d *Dict) GetByString(name string) (DictPair, bool)

GetByString retrieves a pair using a string key (convenience for attribute-style access).

func (*Dict) HasByString 

func (d *Dict) HasByString(name string) bool

HasByString checks if a string key exists in the dict.

func (*Dict) Inspect 

func (d *Dict) Inspect() string

func (*Dict) SetByString 

func (d *Dict) SetByString(name string, value Object)

SetByString sets a pair using a string key (convenience for attribute-style access).

func (*Dict) Type 

func (d *Dict) Type() ObjectType

type DictItems 

type DictItems struct {
	Dict *Dict
}

DictItems represents a view of a dictionary's items

func (*DictItems) AsBool 

func (di *DictItems) AsBool() (bool, Object)

func (*DictItems) AsDict 

func (di *DictItems) AsDict() (map[string]Object, Object)

func (*DictItems) AsFloat 

func (di *DictItems) AsFloat() (float64, Object)

func (*DictItems) AsInt 

func (di *DictItems) AsInt() (int64, Object)

func (*DictItems) AsList 

func (di *DictItems) AsList() ([]Object, Object)

func (*DictItems) AsString 

func (di *DictItems) AsString() (string, Object)

func (*DictItems) CoerceFloat 

func (di *DictItems) CoerceFloat() (float64, Object)

func (*DictItems) CoerceInt 

func (di *DictItems) CoerceInt() (int64, Object)

func (*DictItems) CoerceString 

func (di *DictItems) CoerceString() (string, Object)

func (*DictItems) CreateIterator 

func (di *DictItems) CreateIterator() *Iterator

func (*DictItems) Inspect 

func (di *DictItems) Inspect() string

func (*DictItems) Type 

func (di *DictItems) Type() ObjectType

type DictKeys 

type DictKeys struct {
	Dict *Dict
}

DictKeys represents a view of a dictionary's keys

func (*DictKeys) AsBool 

func (dk *DictKeys) AsBool() (bool, Object)

func (*DictKeys) AsDict 

func (dk *DictKeys) AsDict() (map[string]Object, Object)

func (*DictKeys) AsFloat 

func (dk *DictKeys) AsFloat() (float64, Object)

func (*DictKeys) AsInt 

func (dk *DictKeys) AsInt() (int64, Object)

func (*DictKeys) AsList 

func (dk *DictKeys) AsList() ([]Object, Object)

func (*DictKeys) AsString 

func (dk *DictKeys) AsString() (string, Object)

func (*DictKeys) CoerceFloat 

func (dk *DictKeys) CoerceFloat() (float64, Object)

func (*DictKeys) CoerceInt 

func (dk *DictKeys) CoerceInt() (int64, Object)

func (*DictKeys) CoerceString 

func (dk *DictKeys) CoerceString() (string, Object)

func (*DictKeys) CreateIterator 

func (dk *DictKeys) CreateIterator() *Iterator

CreateIterator returns an iterator for the keys

func (*DictKeys) Inspect 

func (dk *DictKeys) Inspect() string

func (*DictKeys) Type 

func (dk *DictKeys) Type() ObjectType

type DictPair 

type DictPair struct {
	Key   Object
	Value Object
}

func (DictPair) StringKey 

func (p DictPair) StringKey() string

StringKey returns the string representation of the key. For String keys, returns the actual string value; for other types, returns Inspect(). This is the canonical way to extract a human-readable key from a DictPair.

type DictValues 

type DictValues struct {
	Dict *Dict
}

DictValues represents a view of a dictionary's values

func (*DictValues) AsBool 

func (dv *DictValues) AsBool() (bool, Object)

func (*DictValues) AsDict 

func (dv *DictValues) AsDict() (map[string]Object, Object)

func (*DictValues) AsFloat 

func (dv *DictValues) AsFloat() (float64, Object)

func (*DictValues) AsInt 

func (dv *DictValues) AsInt() (int64, Object)

func (*DictValues) AsList 

func (dv *DictValues) AsList() ([]Object, Object)

func (*DictValues) AsString 

func (dv *DictValues) AsString() (string, Object)

func (*DictValues) CoerceFloat 

func (dv *DictValues) CoerceFloat() (float64, Object)

func (*DictValues) CoerceInt 

func (dv *DictValues) CoerceInt() (int64, Object)

func (*DictValues) CoerceString 

func (dv *DictValues) CoerceString() (string, Object)

func (*DictValues) CreateIterator 

func (dv *DictValues) CreateIterator() *Iterator

func (*DictValues) Inspect 

func (dv *DictValues) Inspect() string

func (*DictValues) Type 

func (dv *DictValues) Type() ObjectType

type Environment 

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

func AcquireCallEnvironment added in v0.7.1 

func AcquireCallEnvironment(outer *Environment, slotIndex map[string]int, slotNames []string) *Environment

AcquireCallEnvironment returns a function-call environment, reusing an idle frame from the tree's per-root free-list when one is available.

The free-list lives on the root environment and is accessed without locking; this is safe because an environment tree is only ever used by a single goroutine (see callFrameFreeList). Frames acquired here must be returned via ReleaseCallEnvironment.

func NewEnclosedEnvironment 

func NewEnclosedEnvironment(outer *Environment) *Environment

func NewEnclosedEnvironmentWithSlots added in v0.5.6 

func NewEnclosedEnvironmentWithSlots(outer *Environment, slotIndex map[string]int, slotNames []string) *Environment

func NewEnvironment 

func NewEnvironment() *Environment

func NewEnvironmentWithGILDomain added in v0.23.0 

func NewEnvironmentWithGILDomain(owner *Environment) *Environment

NewEnvironmentWithGILDomain creates an otherwise independent environment that serializes through the same interpreter lock as owner. It is useful for runtime callbacks that must retain a stable lock domain without retaining owner's store (which can create finalizer reachability cycles).

func (*Environment) CachedEnvContext added in v0.20.0 

func (e *Environment) CachedEnvContext(base context.Context) (context.Context, bool)

CachedEnvContext returns the context previously derived from base for this environment, if any.

Builtins are invoked with their environment attached to the context, and deriving that context is a heap allocation. Since the base context is stable for the whole of one evaluation, memoising the derived context turns a per-builtin-call allocation into an atomic load and a comparison.

func (*Environment) CopyCallableBindingsTo added in v0.5.5 

func (e *Environment) CopyCallableBindingsTo(target *Environment)

CopyCallableBindingsTo copies safe bindings into target for background task use. Functions and lambdas are copied and rebound to target. Dicts are copied so imported modules remain available. Other globals are intentionally skipped so background tasks cannot share caller-owned mutable or native-backed state.

func (*Environment) Delete 

func (e *Environment) Delete(name string)

Delete removes a variable from this environment (not parent scopes)

func (*Environment) EnableOutputCapture 

func (e *Environment) EnableOutputCapture()

EnableOutputCapture enables output capture for this environment

func (*Environment) EnterGIL added in v0.15.0 

func (e *Environment) EnterGIL() bool

EnterGIL acquires this tree's interpreter lock for the calling goroutine, unless this goroutine already holds it (a re-entrant call). It returns true if it actually acquired the lock (the caller must pair it with ExitGIL) and false if the call was re-entrant (caller does nothing on exit).

func (*Environment) EnterGILWithContext added in v0.23.0 

func (e *Environment) EnterGILWithContext(ctx context.Context) (acquired, entered bool)

EnterGILWithContext acquires the interpreter lock while allowing a cancellable caller to abandon a contended wait. acquired reports whether the caller must invoke ExitGIL; entered is false only when ctx ended before entry. Contexts without cancellation use the regular blocking fast path.

func (*Environment) ExitGIL added in v0.15.0 

func (e *Environment) ExitGIL()

ExitGIL releases the interpreter lock previously acquired by EnterGIL.

func (*Environment) ExtendSlots added in v0.7.1 

func (e *Environment) ExtendSlots(slotIndex map[string]int, slotNames []string)

ExtendSlots adds new variables to the existing slot layout. Variables already present keep their existing indices. New variables are appended.

func (*Environment) Get 

func (e *Environment) Get(name string) (Object, bool)

func (*Environment) GetAtLocation added in v0.15.0 

func (e *Environment) GetAtLocation(hops, slotIdx int, name string) (Object, bool)

GetAtLocation reads the value at a cached (hops, slotIdx) location, validating that the slot still holds the expected name. Returns false if the cache is stale (chain too short or slot layout changed), so the caller can fall back to a full lookup.

func (*Environment) GetAvailableLibrariesCallback 

func (e *Environment) GetAvailableLibrariesCallback() func() []LibraryInfo

GetAvailableLibrariesCallback gets the available libraries callback from this environment or outer

func (*Environment) GetCachedSlot added in v0.7.1 

func (e *Environment) GetCachedSlot(idx int, name string) (Object, bool)

GetCachedSlot returns the value at the given slot index after validating that the slot name matches. This prevents stale cached indices (from shared AST via the parse cache) from reading the wrong variable.

func (*Environment) GetCurrentModule added in v0.4.0 

func (e *Environment) GetCurrentModule() string

GetCurrentModule gets the current module path from this environment or outer

func (*Environment) GetErrorWriter added in v0.21.0 

func (e *Environment) GetErrorWriter() io.Writer

GetErrorWriter returns the appropriate writer for error output (sys.stderr)

func (*Environment) GetGlobal 

func (e *Environment) GetGlobal() *Environment

GetGlobal gets the global (outermost) environment

func (*Environment) GetImportCallback 

func (e *Environment) GetImportCallback() func(string) error

GetImportCallback returns a context-free view of the import callback for backwards compatibility. Calls made through this wrapper use a background context; evaluator internals use GetImportCallbackWithContext.

func (*Environment) GetImportCallbackWithContext added in v0.23.0 

func (e *Environment) GetImportCallbackWithContext() func(context.Context, string) error

GetImportCallbackWithContext gets the context-aware import callback from this environment or an outer environment.

func (*Environment) GetOutput 

func (e *Environment) GetOutput() string

GetOutput returns captured output and clears the buffer

func (*Environment) GetReader 

func (e *Environment) GetReader() io.Reader

GetReader returns the appropriate reader for input

func (*Environment) GetSlotByIndex added in v0.7.1 

func (e *Environment) GetSlotByIndex(idx int) (Object, bool)

GetSlotByIndex returns the value at the given slot index. Returns (value, true) if the slot has a value, (nil, false) otherwise.

func (*Environment) GetSlotIndex added in v0.7.1 

func (e *Environment) GetSlotIndex(name string) (int, bool)

GetSlotIndex returns the slot index for the given variable name in this environment's local scope only. Returns (index, true) if found, (0, false) if not a local slot.

func (*Environment) GetStore 

func (e *Environment) GetStore() map[string]Object

GetStore returns a copy of the environment's store (only local scope, not outer)

func (*Environment) GetWithLocation added in v0.15.0 

func (e *Environment) GetWithLocation(name string) (val Object, hops int, slotIdx int, ok bool)

GetWithLocation resolves name like Get, additionally reporting where it was found in the environment chain: hops is the number of outer links traversed and slotIdx is the slot index if the value lives in a slot, or -1 if it came from a store map (not a stable, cacheable location). Used to seed call-site callee caches.

func (*Environment) GetWriter 

func (e *Environment) GetWriter() io.Writer

GetWriter returns the appropriate writer for output

func (*Environment) HasSlots added in v0.7.1 

func (e *Environment) HasSlots() bool

HasSlots returns whether this environment has slot-based variable access configured.

func (*Environment) IsGlobal 

func (e *Environment) IsGlobal(name string) bool

IsGlobal checks if a variable is marked as global

func (*Environment) IsImportedBinding added in v0.6.0 

func (e *Environment) IsImportedBinding(name string) bool

IsImportedBinding reports whether a local binding came from an import.

func (*Environment) IsNonlocal 

func (e *Environment) IsNonlocal(name string) bool

IsNonlocal checks if a variable is marked as nonlocal

func (*Environment) MarkGlobal 

func (e *Environment) MarkGlobal(name string)

MarkGlobal marks a variable name as global in this scope

func (*Environment) MarkImportedBinding added in v0.6.0 

func (e *Environment) MarkImportedBinding(name string)

MarkImportedBinding marks a local binding as coming from an import.

func (*Environment) MarkNonlocal 

func (e *Environment) MarkNonlocal(name string)

MarkNonlocal marks a variable name as nonlocal in this scope

func (*Environment) ResetStore added in v0.2.7 

func (e *Environment) ResetStore(keep map[string]bool)

ResetStore removes all keys from the environment store except those in keep.

func (*Environment) Root added in v0.15.0 

func (e *Environment) Root() *Environment

Root returns the root environment of this tree.

func (*Environment) RunUnlocked added in v0.15.0 

func (e *Environment) RunUnlocked(fn func())

RunUnlocked releases the interpreter lock, runs fn (typically a blocking call such as sleep or a socket read), then re-acquires it — but only if the calling goroutine actually holds the lock. Goroutines that do not hold it (e.g. raw worker goroutines doing pure-Go I/O) simply run fn. This lets other goroutines run script code in the same tree while the holder is blocked.

func (*Environment) Set 

func (e *Environment) Set(name string, val Object) Object

func (*Environment) SetAvailableLibrariesCallback 

func (e *Environment) SetAvailableLibrariesCallback(fn func() []LibraryInfo)

SetAvailableLibrariesCallback sets the available libraries callback for this environment. GetAvailableLibrariesCallback walks up the scope chain, so setting on any env makes it available to that env and all enclosed children.

func (*Environment) SetCachedSlot added in v0.7.1 

func (e *Environment) SetCachedSlot(idx int, name string, val Object) bool

SetCachedSlot stores val at the given slot index after validating that the slot name matches. Returns false if the cache is stale, falling through to the full Set path.

func (*Environment) SetCurrentModule added in v0.4.0 

func (e *Environment) SetCurrentModule(module string)

SetCurrentModule sets the current module path for relative import resolution

func (*Environment) SetErrorWriter added in v0.21.0 

func (e *Environment) SetErrorWriter(w io.Writer)

SetErrorWriter sets a custom writer for error/diagnostic output (sys.stderr)

func (*Environment) SetGlobal 

func (e *Environment) SetGlobal(name string, val Object) Object

SetGlobal sets a variable in the global (outermost) environment

func (*Environment) SetImportCallback 

func (e *Environment) SetImportCallback(fn func(string) error)

SetImportCallback sets a context-free import callback for backwards compatibility. New code should use SetImportCallbackWithContext so caller cancellation and values are preserved through imports.

func (*Environment) SetImportCallbackWithContext added in v0.23.0 

func (e *Environment) SetImportCallbackWithContext(fn func(context.Context, string) error)

SetImportCallbackWithContext sets the context-aware import callback for this environment. GetImportCallbackWithContext walks up the scope chain, so the callback is available to enclosed environments.

func (*Environment) SetInParent 

func (e *Environment) SetInParent(name string, val Object) bool

SetInParent sets a variable in the parent environment (for nonlocal)

func (*Environment) SetInputReader 

func (e *Environment) SetInputReader(r io.Reader)

SetInputReader sets a custom reader for input

func (*Environment) SetOutputWriter 

func (e *Environment) SetOutputWriter(w io.Writer)

SetOutputWriter sets a custom writer for output

func (*Environment) SetSlotByIndex added in v0.7.1 

func (e *Environment) SetSlotByIndex(idx int, val Object) bool

SetSlotByIndex stores val in the given local slot index when valid.

func (*Environment) SetupSlots added in v0.7.1 

func (e *Environment) SetupSlots(slotIndex map[string]int, slotNames []string)

SetupSlots configures slot-based variable access on this environment.

func (*Environment) SnapshotCallables added in v0.6.3 

func (e *Environment) SnapshotCallables() *CallableSnapshot

SnapshotCallables reads callable and scalar bindings from this environment into a self-contained snapshot. No references to the source Environment's maps are retained, so it is safe to pass the snapshot to another goroutine. Module-level scalars (int, float, bool, str, None) are included because handler functions legitimately reference module constants; they are immutable value objects, so sharing them cannot create cross-task races. Mutable globals (lists, dicts, instances, classes) are deliberately excluded — data must be passed via task args.

func (*Environment) StoreEnvContext added in v0.20.0 

func (e *Environment) StoreEnvContext(base, derived context.Context)

StoreEnvContext memoises derived as the result of attaching this environment to base, so a later CachedEnvContext(base) can skip the allocation.

Nothing is stored when base's dynamic type is not comparable, because the lookup compares contexts with ==. That guard is what makes the comparison safe: a stored base is always of a comparable type, so if an incoming context has a different (possibly non-comparable) type the comparison fails on the type word alone and never reaches the values.

type Error 

type Error struct {
	Message  string
	Line     int
	File     string
	Function string
	// ExceptionType names the Python exception this error corresponds to, e.g.
	// "ZeroDivisionError". It lets `except <Type>:` match a runtime error
	// precisely instead of the try handler having to guess the type from the
	// message text. Empty means "unclassified": the handler falls back to
	// inferring a type, and the error is still caught by `except Exception`.
	//
	// Errors remain Errors rather than Exceptions on purpose — Error is the
	// evaluator's propagation signal, recognised by the object.IsError checks
	// threaded through expression evaluation — so setting this changes only how
	// an except clause matches, not how the value travels.
	ExceptionType string
}

func AsErrorObj 

func AsErrorObj(obj Object) (*Error, bool)

AsErrorObj returns the object as an Error, or nil/false if not

func (*Error) AsBool 

func (e *Error) AsBool() (bool, Object)

func (*Error) AsDict 

func (e *Error) AsDict() (map[string]Object, Object)

func (*Error) AsFloat 

func (e *Error) AsFloat() (float64, Object)

func (*Error) AsInt 

func (e *Error) AsInt() (int64, Object)

func (*Error) AsList 

func (e *Error) AsList() ([]Object, Object)

func (*Error) AsString 

func (e *Error) AsString() (string, Object)

func (*Error) CoerceFloat 

func (e *Error) CoerceFloat() (float64, Object)

func (*Error) CoerceInt 

func (e *Error) CoerceInt() (int64, Object)

func (*Error) CoerceString 

func (e *Error) CoerceString() (string, Object)

func (*Error) Inspect 

func (e *Error) Inspect() string

func (*Error) Type 

func (e *Error) Type() ObjectType

type Exception 

type Exception struct {
	Message       string
	ExceptionType string // Exception type for identification (e.g., "SystemExit", "ValueError", etc.)
	Code          int    // Exit code for SystemExit; ignored for other exception types
}

func AsException 

func AsException(obj Object) (*Exception, bool)

AsException returns the object as an Exception, or nil/false if not

func NewSystemExit 

func NewSystemExit(code int, message string) *Exception

NewSystemExit creates a new SystemExit exception with the given code and message

func (*Exception) AsBool 

func (ex *Exception) AsBool() (bool, Object)

func (*Exception) AsDict 

func (ex *Exception) AsDict() (map[string]Object, Object)

func (*Exception) AsFloat 

func (ex *Exception) AsFloat() (float64, Object)

func (*Exception) AsInt 

func (ex *Exception) AsInt() (int64, Object)

func (*Exception) AsList 

func (ex *Exception) AsList() ([]Object, Object)

func (*Exception) AsString 

func (ex *Exception) AsString() (string, Object)

func (*Exception) CoerceFloat 

func (ex *Exception) CoerceFloat() (float64, Object)

func (*Exception) CoerceInt 

func (ex *Exception) CoerceInt() (int64, Object)

func (*Exception) CoerceString 

func (ex *Exception) CoerceString() (string, Object)

func (*Exception) GetExitCode 

func (ex *Exception) GetExitCode() int

GetExitCode returns the exit code for SystemExit exceptions For non-SystemExit exceptions, returns 0 (the Code field is ignored)

func (*Exception) Inspect 

func (ex *Exception) Inspect() string

func (*Exception) IsPermissionError added in v0.3.2 

func (ex *Exception) IsPermissionError() bool

func (*Exception) IsSystemExit 

func (ex *Exception) IsSystemExit() bool

IsSystemExit returns true if this is a SystemExit exception

func (*Exception) Type 

func (ex *Exception) Type() ObjectType

type Float 

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

func NewFloat added in v0.8.0 

func NewFloat(v float64) *Float

func (*Float) AsBool 

func (f *Float) AsBool() (bool, Object)

func (*Float) AsDict 

func (f *Float) AsDict() (map[string]Object, Object)

func (*Float) AsFloat 

func (f *Float) AsFloat() (float64, Object)

func (*Float) AsInt 

func (f *Float) AsInt() (int64, Object)

func (*Float) AsList 

func (f *Float) AsList() ([]Object, Object)

func (*Float) AsString 

func (f *Float) AsString() (string, Object)

func (*Float) CoerceFloat 

func (f *Float) CoerceFloat() (float64, Object)

func (*Float) CoerceInt 

func (f *Float) CoerceInt() (int64, Object)

func (*Float) CoerceString 

func (f *Float) CoerceString() (string, Object)

func (*Float) FloatValue added in v0.8.0 

func (f *Float) FloatValue() float64

func (*Float) Inspect 

func (f *Float) Inspect() string

func (*Float) Type 

func (f *Float) Type() ObjectType

type FloatArray added in v0.6.3 

type FloatArray struct {
	Data  []float64
	Shape []int
}

func NewFloatArray1D added in v0.6.3 

func NewFloatArray1D(data []float64) *FloatArray

func NewFloatArray2D added in v0.6.3 

func NewFloatArray2D(data []float64, rows, cols int) *FloatArray

func (*FloatArray) AsBool added in v0.6.3 

func (fa *FloatArray) AsBool() (bool, Object)

func (*FloatArray) AsDict added in v0.6.3 

func (fa *FloatArray) AsDict() (map[string]Object, Object)

func (*FloatArray) AsFloat added in v0.6.3 

func (fa *FloatArray) AsFloat() (float64, Object)

func (*FloatArray) AsInt added in v0.6.3 

func (fa *FloatArray) AsInt() (int64, Object)

func (*FloatArray) AsList added in v0.6.3 

func (fa *FloatArray) AsList() ([]Object, Object)

func (*FloatArray) AsString added in v0.6.3 

func (fa *FloatArray) AsString() (string, Object)

func (*FloatArray) CoerceFloat added in v0.6.3 

func (fa *FloatArray) CoerceFloat() (float64, Object)

func (*FloatArray) CoerceInt added in v0.6.3 

func (fa *FloatArray) CoerceInt() (int64, Object)

func (*FloatArray) CoerceString added in v0.6.3 

func (fa *FloatArray) CoerceString() (string, Object)

func (*FloatArray) Cols added in v0.6.3 

func (fa *FloatArray) Cols() int

func (*FloatArray) FloatArrayData added in v0.6.3 

func (fa *FloatArray) FloatArrayData() ([]float64, []int, bool)

func (*FloatArray) Inspect added in v0.6.3 

func (fa *FloatArray) Inspect() string

func (*FloatArray) Is2D added in v0.6.3 

func (fa *FloatArray) Is2D() bool

func (*FloatArray) PrettyPrint added in v0.6.3 

func (fa *FloatArray) PrettyPrint() string

func (*FloatArray) Row added in v0.6.3 

func (fa *FloatArray) Row(i int) []float64

func (*FloatArray) Rows added in v0.6.3 

func (fa *FloatArray) Rows() int

func (*FloatArray) ToList added in v0.6.3 

func (fa *FloatArray) ToList() *List

func (*FloatArray) Type added in v0.6.3 

func (fa *FloatArray) Type() ObjectType

type Function 

type Function struct {
	Name             string
	Parameters       []*ast.Identifier
	DefaultValues    map[string]ast.Expression
	Variadic         *ast.Identifier // *args parameter
	Kwargs           *ast.Identifier // **kwargs parameter
	KeywordOnlyStart int             // 1-based index where keyword-only params start; 0 means none
	Body             *ast.BlockStatement
	Env              *Environment
	LocalSlots       map[string]int
	LocalSlotNames   []string
	ParamSlotIndexes []int
	ReuseCallEnv     bool
}

func (*Function) AsBool 

func (f *Function) AsBool() (bool, Object)

func (*Function) AsDict 

func (f *Function) AsDict() (map[string]Object, Object)

func (*Function) AsFloat 

func (f *Function) AsFloat() (float64, Object)

func (*Function) AsInt 

func (f *Function) AsInt() (int64, Object)

func (*Function) AsList 

func (f *Function) AsList() ([]Object, Object)

func (*Function) AsString 

func (f *Function) AsString() (string, Object)

func (*Function) CoerceFloat 

func (f *Function) CoerceFloat() (float64, Object)

func (*Function) CoerceInt 

func (f *Function) CoerceInt() (int64, Object)

func (*Function) CoerceString 

func (f *Function) CoerceString() (string, Object)

func (*Function) Inspect 

func (f *Function) Inspect() string

func (*Function) Type 

func (f *Function) Type() ObjectType

type FunctionBuilder 

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

FunctionBuilder provides a fluent API for creating individual scriptling functions. It allows registering a single typed Go function that is automatically wrapped to handle conversion between Go types and scriptling Objects.

Example usage: 

fb := NewFunctionBuilder()
fb.Function(func(a, b int) int { return a + b })
fn := fb.Build()
p.RegisterFunc("add", fn)

func NewFunctionBuilder 

func NewFunctionBuilder() *FunctionBuilder

NewFunctionBuilder creates a new FunctionBuilder for building individual functions.

func (*FunctionBuilder) Build 

func (fb *FunctionBuilder) Build() func(ctx context.Context, kwargs Kwargs, args ...Object) Object

Build creates and returns the BuiltinFunction from this builder. The returned function can be passed directly to RegisterFunc().

func (*FunctionBuilder) Function 

func (fb *FunctionBuilder) Function(fn interface{}) *FunctionBuilder

Function registers a typed Go function with the builder. The function must be a Go function with typed parameters. Supported signatures are the same as LibraryBuilder.Function().

Example: 

fb.Function(func(a, b int) int { return a + b })

func (*FunctionBuilder) FunctionWithHelp 

func (fb *FunctionBuilder) FunctionWithHelp(fn interface{}, helpText string) *FunctionBuilder

FunctionWithHelp registers a function with help text. Help text is displayed when users call help() on the function.

Example: 

fb.FunctionWithHelp(func(x float64) float64 {
    return math.Sqrt(x)
}, "sqrt(x) - Return the square root of x")

type FunctionSignature 

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

FunctionSignature holds pre-computed function analysis

type Instance 

type Instance struct {
	Class *Class

	NativeData any
	// contains filtered or unexported fields
}

func NewInstance added in v0.15.0 

func NewInstance(class *Class) *Instance

NewInstance creates an empty instance of the given class. Use the field accessor methods (SetField, GetField, …) to populate it.

func NewInstanceWithData added in v0.15.0 

func NewInstanceWithData(class *Class, fields map[string]Object, nativeData any) *Instance

NewInstanceWithData is like NewInstanceWithFields but also attaches an opaque native-data value to the instance.

func NewInstanceWithFields added in v0.15.0 

func NewInstanceWithFields(class *Class, fields map[string]Object) *Instance

NewInstanceWithFields creates an instance of the given class pre-populated with the supplied fields. The map is consumed (copied into the instance's storage); a nil map yields an empty instance.

func NewReceiverInstance added in v0.23.0 

func NewReceiverInstance(class *Class, typeName string, client any) *Instance

NewReceiverInstance returns an instance of class whose typed receiver is client — exactly what a ClassBuilder constructor produces. Library factory functions (connect/open) use it to hand scripts an instance of a typed-receiver class directly, without going through the constructor path.

func (*Instance) AsBool 

func (i *Instance) AsBool() (bool, Object)

func (*Instance) AsDict 

func (i *Instance) AsDict() (map[string]Object, Object)

func (*Instance) AsFloat 

func (i *Instance) AsFloat() (float64, Object)

func (*Instance) AsInt 

func (i *Instance) AsInt() (int64, Object)

func (*Instance) AsList 

func (i *Instance) AsList() ([]Object, Object)

func (*Instance) AsString 

func (i *Instance) AsString() (string, Object)

func (*Instance) CoerceFloat 

func (i *Instance) CoerceFloat() (float64, Object)

func (*Instance) CoerceInt 

func (i *Instance) CoerceInt() (int64, Object)

func (*Instance) CoerceString 

func (i *Instance) CoerceString() (string, Object)

func (*Instance) DeleteField added in v0.15.0 

func (i *Instance) DeleteField(name string)

DeleteField removes the named field if present.

func (*Instance) Field added in v0.15.0 

func (i *Instance) Field(name string) Object

Field returns the value of the named field, or nil if it is not set. It is a convenience for callers that immediately type-assert or coerce a field known to exist; use GetField when you need to distinguish "absent" from "nil".

func (*Instance) FieldCount added in v0.15.0 

func (i *Instance) FieldCount() int

FieldCount returns the number of set fields.

func (*Instance) FieldsSnapshot added in v0.15.0 

func (i *Instance) FieldsSnapshot() map[string]Object

FieldsSnapshot returns a new map containing a copy of all set fields. Use it where a standalone map is needed (serialization, AsDict); mutating the result does not affect the instance.

func (*Instance) GetBoundMethod added in v0.5.6 

func (i *Instance) GetBoundMethod(name string, method Object) *BoundMethod

func (*Instance) GetField added in v0.15.0 

func (i *Instance) GetField(name string) (Object, bool)

GetField returns the value of the named field and whether it was set.

func (*Instance) HasField added in v0.15.0 

func (i *Instance) HasField(name string) bool

HasField reports whether the named field is set.

func (*Instance) Inspect 

func (i *Instance) Inspect() string

func (*Instance) InvalidateBoundMethod added in v0.5.6 

func (i *Instance) InvalidateBoundMethod(name string)

func (*Instance) RangeFields added in v0.15.0 

func (i *Instance) RangeFields(fn func(name string, val Object) bool)

RangeFields calls fn for each set field. Iteration order is unspecified and stops early if fn returns false.

func (*Instance) SetField added in v0.15.0 

func (i *Instance) SetField(name string, val Object)

SetField sets the named field, allocating backing storage on first use.

func (*Instance) Type 

func (i *Instance) Type() ObjectType

type Integer 

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

func NewInteger 

func NewInteger(val int64) *Integer

NewInteger returns a cached integer for small values, or a new Integer for larger values

func (*Integer) AsBool 

func (i *Integer) AsBool() (bool, Object)

func (*Integer) AsDict 

func (i *Integer) AsDict() (map[string]Object, Object)

func (*Integer) AsFloat 

func (i *Integer) AsFloat() (float64, Object)

func (*Integer) AsInt 

func (i *Integer) AsInt() (int64, Object)

func (*Integer) AsList 

func (i *Integer) AsList() ([]Object, Object)

func (*Integer) AsString 

func (i *Integer) AsString() (string, Object)

func (*Integer) CoerceFloat 

func (i *Integer) CoerceFloat() (float64, Object)

func (*Integer) CoerceInt 

func (i *Integer) CoerceInt() (int64, Object)

func (*Integer) CoerceString 

func (i *Integer) CoerceString() (string, Object)

func (*Integer) Inspect 

func (i *Integer) Inspect() string

func (*Integer) IntValue added in v0.8.0 

func (i *Integer) IntValue() int64

func (*Integer) Type 

func (i *Integer) Type() ObjectType

type Iterator 

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

Iterator represents a Python-style iterator

func NewEnumerateIterator 

func NewEnumerateIterator(iterable Object, start int64) *Iterator

EnumerateIterator creates an iterator that returns (index, value) tuples

func NewIterator 

func NewIterator(nextFn func() (Object, bool)) *Iterator

NewIterator creates an iterator with a custom next function This allows creating iterators that can call functions with proper context

func NewRangeIterator 

func NewRangeIterator(start, stop, step int64) *Iterator

RangeIterator creates an iterator for range(start, stop, step)

func NewReversedIterator 

func NewReversedIterator(iterable Object) *Iterator

ReversedIterator creates an iterator that returns elements in reverse order

func NewZipIterator 

func NewZipIterator(iterables []Object) *Iterator

ZipIterator creates an iterator that zips multiple iterables together

func (*Iterator) AsBool 

func (it *Iterator) AsBool() (bool, Object)

func (*Iterator) AsDict 

func (it *Iterator) AsDict() (map[string]Object, Object)

func (*Iterator) AsFloat 

func (it *Iterator) AsFloat() (float64, Object)

func (*Iterator) AsInt 

func (it *Iterator) AsInt() (int64, Object)

func (*Iterator) AsList 

func (it *Iterator) AsList() ([]Object, Object)

func (*Iterator) AsString 

func (it *Iterator) AsString() (string, Object)

func (*Iterator) CoerceFloat 

func (it *Iterator) CoerceFloat() (float64, Object)

func (*Iterator) CoerceInt 

func (it *Iterator) CoerceInt() (int64, Object)

func (*Iterator) CoerceString 

func (it *Iterator) CoerceString() (string, Object)

func (*Iterator) Inspect 

func (it *Iterator) Inspect() string

func (*Iterator) Next 

func (it *Iterator) Next() (Object, bool)

Next returns the next value from the iterator

func (*Iterator) Type 

func (it *Iterator) Type() ObjectType

type Kwargs 

type Kwargs struct {
	Kwargs map[string]Object
}

Kwargs is a special type for functions that accept keyword arguments. It wraps the raw kwargs map and provides helper methods for extracting values.

func NewKwargs 

func NewKwargs(kwargs map[string]Object) Kwargs

NewKwargs creates a new Kwargs wrapper.

func (Kwargs) Get 

func (k Kwargs) Get(key string) Object

Get returns the raw Object for the key, or nil if not found.

func (Kwargs) GetBool 

func (k Kwargs) GetBool(name string, defaultValue bool) (bool, Object)

GetBool extracts a boolean keyword argument with a default value.

func (Kwargs) GetFloat 

func (k Kwargs) GetFloat(name string, defaultValue float64) (float64, Object)

GetFloat extracts a float keyword argument with a default value.

func (Kwargs) GetInt 

func (k Kwargs) GetInt(name string, defaultValue int64) (int64, Object)

GetInt extracts an integer keyword argument with a default value.

func (Kwargs) GetList 

func (k Kwargs) GetList(name string, defaultValue []Object) ([]Object, Object)

GetList extracts a list keyword argument with a default value.

func (Kwargs) GetString 

func (k Kwargs) GetString(name string, defaultValue string) (string, Object)

GetString extracts a string keyword argument with a default value.

func (Kwargs) Has 

func (k Kwargs) Has(key string) bool

Has returns true if the key exists in kwargs.

func (Kwargs) Keys 

func (k Kwargs) Keys() []string

Keys returns all kwargs keys.

func (Kwargs) Len 

func (k Kwargs) Len() int

Len returns the number of kwargs.

func (Kwargs) MustGetBool 

func (k Kwargs) MustGetBool(name string, defaultValue bool) bool

MustGetBool extracts a boolean keyword argument, ignoring errors.

func (Kwargs) MustGetFloat 

func (k Kwargs) MustGetFloat(name string, defaultValue float64) float64

MustGetFloat extracts a float keyword argument, ignoring errors.

func (Kwargs) MustGetInt 

func (k Kwargs) MustGetInt(name string, defaultValue int64) int64

MustGetInt extracts an integer keyword argument, ignoring errors.

func (Kwargs) MustGetList 

func (k Kwargs) MustGetList(name string, defaultValue []Object) []Object

MustGetList extracts a list keyword argument, ignoring errors.

func (Kwargs) MustGetString 

func (k Kwargs) MustGetString(name string, defaultValue string) string

MustGetString extracts a string keyword argument, ignoring errors.

type LambdaFunction 

type LambdaFunction struct {
	Parameters       []*ast.Identifier
	DefaultValues    map[string]ast.Expression
	Variadic         *ast.Identifier // *args parameter
	Kwargs           *ast.Identifier // **kwargs parameter
	KeywordOnlyStart int             // 1-based index where keyword-only params start; 0 means none
	Body             ast.Expression
	Env              *Environment
	LocalSlots       map[string]int
	LocalSlotNames   []string
	ParamSlotIndexes []int
}

func (*LambdaFunction) AsBool 

func (lf *LambdaFunction) AsBool() (bool, Object)

func (*LambdaFunction) AsDict 

func (lf *LambdaFunction) AsDict() (map[string]Object, Object)

func (*LambdaFunction) AsFloat 

func (lf *LambdaFunction) AsFloat() (float64, Object)

func (*LambdaFunction) AsInt 

func (lf *LambdaFunction) AsInt() (int64, Object)

func (*LambdaFunction) AsList 

func (lf *LambdaFunction) AsList() ([]Object, Object)

func (*LambdaFunction) AsString 

func (lf *LambdaFunction) AsString() (string, Object)

func (*LambdaFunction) CoerceFloat 

func (lf *LambdaFunction) CoerceFloat() (float64, Object)

func (*LambdaFunction) CoerceInt 

func (lf *LambdaFunction) CoerceInt() (int64, Object)

func (*LambdaFunction) CoerceString 

func (lf *LambdaFunction) CoerceString() (string, Object)

func (*LambdaFunction) Inspect 

func (lf *LambdaFunction) Inspect() string

func (*LambdaFunction) Type 

func (lf *LambdaFunction) Type() ObjectType

type Library 

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

Library represents a pre-built collection of builtin functions and constants

func NewLibrary 

func NewLibrary(name string, functions map[string]*Builtin, constants map[string]Object, description string) *Library

NewLibrary creates a new library with functions, optional constants, and optional description

func (*Library) AsBool 

func (l *Library) AsBool() (bool, Object)

func (*Library) AsDict 

func (l *Library) AsDict() (map[string]Object, Object)

func (*Library) AsFloat 

func (l *Library) AsFloat() (float64, Object)

func (*Library) AsInt 

func (l *Library) AsInt() (int64, Object)

func (*Library) AsList 

func (l *Library) AsList() ([]Object, Object)

func (*Library) AsString 

func (l *Library) AsString() (string, Object)

func (*Library) CachedDict 

func (l *Library) CachedDict() *Dict

CachedDict returns nil (caching removed). Kept for test compatibility.

func (*Library) CoerceFloat 

func (l *Library) CoerceFloat() (float64, Object)

func (*Library) CoerceInt 

func (l *Library) CoerceInt() (int64, Object)

func (*Library) CoerceString 

func (l *Library) CoerceString() (string, Object)

func (*Library) Constants 

func (l *Library) Constants() map[string]Object

Constants returns the library's constants map

func (*Library) Description 

func (l *Library) Description() string

Description returns the library's description

func (*Library) Functions 

func (l *Library) Functions() map[string]*Builtin

Functions returns the library's function map

func (*Library) GetDict 

func (l *Library) GetDict() *Dict

GetDict builds and returns a fresh Dict representation of this library. Returns a new dict each time so callers (including concurrent goroutines) never share mutable state.

func (*Library) Inspect 

func (l *Library) Inspect() string

func (*Library) InstanceData 

func (l *Library) InstanceData() any

InstanceData returns the instance-specific data for this library

func (*Library) Instantiate 

func (l *Library) Instantiate(instanceData any) *Library

Instantiate creates a new library instance with instance-specific data Functions are wrapped to inject the instance data into the context

func (*Library) Name 

func (l *Library) Name() string

Name returns the library's name

func (*Library) Type 

func (l *Library) Type() ObjectType

type LibraryBuilder 

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

LibraryBuilder provides a fluent API for creating scriptling libraries. It allows registering typed Go functions that are automatically wrapped to handle conversion between Go types and scriptling Objects.

Example usage: 

lib := NewLibraryBuilder("mylib", "My custom library")
lib.Function("connect", func(host string, port int) error {
    // Connect to host:port
    return nil
})
lib.Function("disconnect", func() error {
    // Disconnect
    return nil
})
lib.Constant("VERSION", "1.0.0")
library := lib.Build()

func NewLibraryBuilder 

func NewLibraryBuilder(name, description string) *LibraryBuilder

NewLibraryBuilder creates a new LibraryBuilder with the given name and description.

func (*LibraryBuilder) Alias 

func (b *LibraryBuilder) Alias(alias, originalName string) *LibraryBuilder

Alias creates an alias for an existing function.

Example: 

builder.Function("add", func(a, b int) int { return a + b })
builder.Alias("sum", "add")  // "sum" is now an alias for "add"

func (*LibraryBuilder) Build 

func (b *LibraryBuilder) Build() *Library

Build creates and returns the Library from this builder. After calling Build(), the builder should not be used further.

func (*LibraryBuilder) Clear 

func (b *LibraryBuilder) Clear() *LibraryBuilder

Clear removes all registered functions and constants.

func (*LibraryBuilder) Constant 

func (b *LibraryBuilder) Constant(name string, value interface{}) *LibraryBuilder

Constant registers a constant value with the given name. The value is automatically converted to a scriptling Object. Supported types: string, int, int64, float64, bool, nil

Example: 

builder.Constant("VERSION", "1.0.0")
builder.Constant("MAX_CONNECTIONS", 100)
builder.Constant("DEBUG", true)

func (*LibraryBuilder) ConstantCount 

func (b *LibraryBuilder) ConstantCount() int

ConstantCount returns the number of registered constants.

func (*LibraryBuilder) Description 

func (b *LibraryBuilder) Description(desc string) *LibraryBuilder

Description sets or updates the library description.

func (*LibraryBuilder) Function 

func (b *LibraryBuilder) Function(name string, fn interface{}) *LibraryBuilder

Function registers a function with the given name. The function must be a Go function with typed parameters. Parameters can be: string, int, int64, float64, bool, []any, map[string]any Return values can be: any of the above types, or error

Example: 

builder.Function("add", func(a, b int) int { return a + b })
builder.Function("greet", func(name string) string { return "Hello, " + name })
builder.Function("connect", func(host string, port int) error { ... })

func (*LibraryBuilder) FunctionCount 

func (b *LibraryBuilder) FunctionCount() int

FunctionCount returns the number of registered functions.

func (*LibraryBuilder) FunctionFromVariadic 

func (b *LibraryBuilder) FunctionFromVariadic(name string, fn interface{}) *LibraryBuilder

FunctionFromVariadic registers a variadic function that accepts a variable number of arguments. This is useful for functions like print() that can take any number of arguments.

Example: 

builder.FunctionFromVariadic("print_all", func(args ...any) {
    for _, arg := range args {
        fmt.Println(arg)
    }
})

func (*LibraryBuilder) FunctionFromVariadicWithHelp 

func (b *LibraryBuilder) FunctionFromVariadicWithHelp(name string, fn interface{}, helpText string) *LibraryBuilder

FunctionFromVariadicWithHelp registers a variadic function with help text.

func (*LibraryBuilder) FunctionWithHelp 

func (b *LibraryBuilder) FunctionWithHelp(name string, fn interface{}, helpText string) *LibraryBuilder

FunctionWithHelp registers a function with the given name and help text. The function must be a Go function with typed parameters. Help text is displayed when users call help() on the function.

Example: 

builder.FunctionWithHelp("sqrt", func(x float64) float64 {
    return math.Sqrt(x)
}, "sqrt(x) - Return the square root of x")

func (*LibraryBuilder) GetConstantNames 

func (b *LibraryBuilder) GetConstantNames() []string

GetConstantNames returns a sorted list of registered constant names.

func (*LibraryBuilder) GetDescription 

func (b *LibraryBuilder) GetDescription() string

GetDescription returns the current library description.

func (*LibraryBuilder) GetFunctionNames 

func (b *LibraryBuilder) GetFunctionNames() []string

GetFunctionNames returns a sorted list of registered function names.

func (*LibraryBuilder) HasConstant 

func (b *LibraryBuilder) HasConstant(name string) bool

HasConstant checks if a constant with the given name has been registered.

func (*LibraryBuilder) HasFunction 

func (b *LibraryBuilder) HasFunction(name string) bool

HasFunction checks if a function with the given name has been registered.

func (*LibraryBuilder) Merge 

func (b *LibraryBuilder) Merge(other *LibraryBuilder) *LibraryBuilder

Merge merges another builder's functions and constants into this one. If there are conflicts, the other builder's values take precedence.

func (*LibraryBuilder) RemoveConstant 

func (b *LibraryBuilder) RemoveConstant(name string) *LibraryBuilder

RemoveConstant removes a constant by name.

func (*LibraryBuilder) RemoveFunction 

func (b *LibraryBuilder) RemoveFunction(name string) *LibraryBuilder

RemoveFunction removes a function by name.

func (*LibraryBuilder) String 

func (b *LibraryBuilder) String() string

String returns a string representation of the builder's state.

func (*LibraryBuilder) SubLibrary 

func (b *LibraryBuilder) SubLibrary(name string, lib *Library) *LibraryBuilder

SubLibrary embeds a library as a named constant in the parent, enabling attribute-style access: `import parent as p; p.sub.func()`.

Note: for `import parent.sub` to work, the sub-library must also be registered independently via RegisterLibrary using its full dotted name.

Example: 

subLib := NewLibraryBuilder("mylib.sub", "Sub utilities").Function(...).Build()
p.RegisterLibrary(subLib)  // enables: import mylib.sub as sub
builder.SubLibrary("sub", subLib)  // enables: import mylib as m; m.sub.func()

type LibraryInfo 

type LibraryInfo struct {
	Name       string
	IsImported bool
}

LibraryInfo contains information about available libraries

type LibraryRegistrar 

type LibraryRegistrar interface {
	RegisterLibrary(lib *Library)
}

LibraryRegistrar is an interface for registering libraries. This allows external libraries to register themselves without circular imports.

type List 

type List struct {
	Elements []Object
}

func (*List) AsBool 

func (l *List) AsBool() (bool, Object)

func (*List) AsDict 

func (l *List) AsDict() (map[string]Object, Object)

func (*List) AsFloat 

func (l *List) AsFloat() (float64, Object)

func (*List) AsInt 

func (l *List) AsInt() (int64, Object)

func (*List) AsList 

func (l *List) AsList() ([]Object, Object)

func (*List) AsString 

func (l *List) AsString() (string, Object)

func (*List) CoerceFloat 

func (l *List) CoerceFloat() (float64, Object)

func (*List) CoerceInt 

func (l *List) CoerceInt() (int64, Object)

func (*List) CoerceString 

func (l *List) CoerceString() (string, Object)

func (*List) Inspect 

func (l *List) Inspect() string

func (*List) Type 

func (l *List) Type() ObjectType

type Null 

type Null struct{}

func (*Null) AsBool 

func (n *Null) AsBool() (bool, Object)

func (*Null) AsDict 

func (n *Null) AsDict() (map[string]Object, Object)

func (*Null) AsFloat 

func (n *Null) AsFloat() (float64, Object)

func (*Null) AsInt 

func (n *Null) AsInt() (int64, Object)

func (*Null) AsList 

func (n *Null) AsList() ([]Object, Object)

func (*Null) AsString 

func (n *Null) AsString() (string, Object)

func (*Null) CoerceFloat 

func (n *Null) CoerceFloat() (float64, Object)

func (*Null) CoerceInt 

func (n *Null) CoerceInt() (int64, Object)

func (*Null) CoerceString 

func (n *Null) CoerceString() (string, Object)

func (*Null) Inspect 

func (n *Null) Inspect() string

func (*Null) Type 

func (n *Null) Type() ObjectType

type Object 

type Object interface {
	Type() ObjectType
	Inspect() string

	// Type-safe accessor methods (strict type checking)
	AsString() (string, Object)
	AsInt() (int64, Object)
	AsFloat() (float64, Object)
	AsBool() (bool, Object)
	AsList() ([]Object, Object)
	AsDict() (map[string]Object, Object)

	// Coercion methods (loose type conversion with best effort)
	CoerceString() (string, Object)
	CoerceInt() (int64, Object)
	CoerceFloat() (float64, Object)
}

func AcquireArgs added in v0.20.0 

func AcquireArgs(env *Environment, n int) []Object

AcquireArgs returns a []Object of length n for a call's argument list, reusing a buffer from the tree's per-root free-list when one of sufficient capacity is available. The returned slice is BORROWED: the caller must return it via ReleaseArgs once the callee has returned, and no callee may retain the slice past its own call (the interpreter's builtins, user-function binding, and varargs collection all satisfy this — varargs copies, params read by index). Uses the same lock-free, GIL-serialized contract as AcquireCallEnvironment.

func CloneObject added in v0.5.2 

func CloneObject(obj Object) Object

CloneObject returns a deep copy of mutable Scriptling objects. Immutable/scalar types (Null, Boolean, Integer, Float, String, Builtin, Function, LambdaFunction, Class, Error, Exception) are returned as-is. Mutable containers (List, Dict, Set, Tuple, Instance) are recursively cloned. Opaque Instance.NativeData is not cloned because there is no generic way to duplicate native Go state safely.

func CoerceWireString added in v0.21.0 

func CoerceWireString(obj Object) (string, Object)

CoerceWireString coerces obj to its machine-facing string form, for wire formats and protocol payloads (query params, messages, tool responses). It behaves like CoerceString except booleans render in their lowercase wire form ("true"/"false") rather than the Python display form ("True"/"False").

func IterableToSlice 

func IterableToSlice(obj Object) ([]Object, bool)

IterableToSlice converts any iterable object (List, Tuple, String, Iterator, Set) to a slice of Objects. Returns (elements, ok) where ok is true if the conversion succeeded. For strings, each character becomes a String object. For iterators, this consumes the iterator. For dicts, returns the keys (like Python's list(dict)).

type ObjectType 

type ObjectType int
const (
	INTEGER_OBJ ObjectType = iota
	FLOAT_OBJ
	BOOLEAN_OBJ
	STRING_OBJ
	NULL_OBJ
	RETURN_OBJ
	BREAK_OBJ
	CONTINUE_OBJ
	FUNCTION_OBJ
	LAMBDA_OBJ
	BUILTIN_OBJ
	LIST_OBJ
	TUPLE_OBJ
	DICT_OBJ
	ERROR_OBJ
	EXCEPTION_OBJ
	CLASS_OBJ
	INSTANCE_OBJ
	SUPER_OBJ
	ITERATOR_OBJ
	DICT_KEYS_OBJ
	DICT_VALUES_OBJ
	DICT_ITEMS_OBJ
	SET_OBJ
	SLICE_OBJ
	PROPERTY_OBJ
	STATICMETHOD_OBJ
	CLASSMETHOD_OBJ
	FLOAT_ARRAY_OBJ
	BYTES_OBJ
)

func (ObjectType) String 

func (ot ObjectType) String() string

String returns the string representation of the ObjectType

type Property added in v0.2.0 

type Property struct {
	Getter Object // Function to call when the attribute is accessed
	Setter Object // Function to call when the attribute is assigned (nil = read-only)
}

Property wraps a getter (and optional setter) for use with @property.

func (*Property) AsBool added in v0.2.0 

func (p *Property) AsBool() (bool, Object)

func (*Property) AsDict added in v0.2.0 

func (p *Property) AsDict() (map[string]Object, Object)

func (*Property) AsFloat added in v0.2.0 

func (p *Property) AsFloat() (float64, Object)

func (*Property) AsInt added in v0.2.0 

func (p *Property) AsInt() (int64, Object)

func (*Property) AsList added in v0.2.0 

func (p *Property) AsList() ([]Object, Object)

func (*Property) AsString added in v0.2.0 

func (p *Property) AsString() (string, Object)

func (*Property) CoerceFloat added in v0.2.0 

func (p *Property) CoerceFloat() (float64, Object)

func (*Property) CoerceInt added in v0.2.0 

func (p *Property) CoerceInt() (int64, Object)

func (*Property) CoerceString added in v0.2.0 

func (p *Property) CoerceString() (string, Object)

func (*Property) Inspect added in v0.2.0 

func (p *Property) Inspect() string

func (*Property) Type added in v0.2.0 

func (p *Property) Type() ObjectType

type ReturnValue 

type ReturnValue struct {
	Value Object
	// contains filtered or unexported fields
}

func AcquireReturnValue added in v0.15.0 

func AcquireReturnValue(env *Environment, val Object) *ReturnValue

AcquireReturnValue returns a *ReturnValue wrapping val, reusing one from the tree's per-root free-list when available. The wrapper remembers its root so ReleaseReturnValue can return it without the caller passing the environment. Uses the same lock-free, GIL-serialized contract as AcquireCallEnvironment.

func (*ReturnValue) AsBool 

func (rv *ReturnValue) AsBool() (bool, Object)

func (*ReturnValue) AsDict 

func (rv *ReturnValue) AsDict() (map[string]Object, Object)

func (*ReturnValue) AsFloat 

func (rv *ReturnValue) AsFloat() (float64, Object)

func (*ReturnValue) AsInt 

func (rv *ReturnValue) AsInt() (int64, Object)

func (*ReturnValue) AsList 

func (rv *ReturnValue) AsList() ([]Object, Object)

func (*ReturnValue) AsString 

func (rv *ReturnValue) AsString() (string, Object)

func (*ReturnValue) CoerceFloat 

func (rv *ReturnValue) CoerceFloat() (float64, Object)

func (*ReturnValue) CoerceInt 

func (rv *ReturnValue) CoerceInt() (int64, Object)

func (*ReturnValue) CoerceString 

func (rv *ReturnValue) CoerceString() (string, Object)

func (*ReturnValue) Inspect 

func (rv *ReturnValue) Inspect() string

func (*ReturnValue) Type 

func (rv *ReturnValue) Type() ObjectType

type ScriptCallable added in v0.15.0 

type ScriptCallable interface {
	ScriptCall(ctx context.Context, args []Object, kwargs map[string]Object) Object
}

ScriptCallable is implemented by Go types stored inside a ClientWrapper whose instances should be callable from scriptling code (e.g. plugin callbacks). When the evaluator encounters a ClientWrapper whose Client implements this interface, it delegates the call to ScriptCall instead of returning an error.

type Set 

type Set struct {
	Elements map[string]Object
}

Set represents a set of unique objects

func NewSet 

func NewSet() *Set

NewSet creates a new empty Set

func (*Set) AddKeyed added in v0.3.2 

func (s *Set) AddKeyed(key string, obj Object)

AddKeyed adds an element with a pre-computed key (used when __hash__ is involved)

func (*Set) AsBool 

func (s *Set) AsBool() (bool, Object)

func (*Set) AsDict 

func (s *Set) AsDict() (map[string]Object, Object)

func (*Set) AsFloat 

func (s *Set) AsFloat() (float64, Object)

func (*Set) AsInt 

func (s *Set) AsInt() (int64, Object)

func (*Set) AsList 

func (s *Set) AsList() ([]Object, Object)

func (*Set) AsString 

func (s *Set) AsString() (string, Object)

func (*Set) CoerceFloat 

func (s *Set) CoerceFloat() (float64, Object)

func (*Set) CoerceInt 

func (s *Set) CoerceInt() (int64, Object)

func (*Set) CoerceString 

func (s *Set) CoerceString() (string, Object)

func (*Set) ContainsKeyed added in v0.3.2 

func (s *Set) ContainsKeyed(key string) bool

ContainsKeyed checks membership using a pre-computed key

func (*Set) Copy 

func (s *Set) Copy() *Set

Copy returns a shallow copy of the set

func (*Set) CreateIterator 

func (s *Set) CreateIterator() *Iterator

CreateIterator returns an iterator for the set

func (*Set) Difference 

func (s *Set) Difference(other *Set) *Set

Difference returns a new set with elements in s but not in other

func (*Set) Inspect 

func (s *Set) Inspect() string

func (*Set) Intersection 

func (s *Set) Intersection(other *Set) *Set

Intersection returns a new set with elements common to both sets

func (*Set) IsSubset 

func (s *Set) IsSubset(other *Set) bool

IsSubset checks if s is a subset of other

func (*Set) IsSuperset 

func (s *Set) IsSuperset(other *Set) bool

IsSuperset checks if s is a superset of other

func (*Set) SymmetricDifference 

func (s *Set) SymmetricDifference(other *Set) *Set

SymmetricDifference returns a new set with elements in either s or other but not both

func (*Set) Type 

func (s *Set) Type() ObjectType

func (*Set) Union 

func (s *Set) Union(other *Set) *Set

Union returns a new set with elements from both sets

type Slice 

type Slice struct {
	Start *Integer // nil means None (default start)
	End   *Integer // nil means None (default end)
	Step  *Integer // nil means None (default step = 1)
}

func (*Slice) AsBool 

func (s *Slice) AsBool() (bool, Object)

func (*Slice) AsDict 

func (s *Slice) AsDict() (map[string]Object, Object)

func (*Slice) AsFloat 

func (s *Slice) AsFloat() (float64, Object)

func (*Slice) AsInt 

func (s *Slice) AsInt() (int64, Object)

func (*Slice) AsList 

func (s *Slice) AsList() ([]Object, Object)

func (*Slice) AsString 

func (s *Slice) AsString() (string, Object)

func (*Slice) CoerceFloat 

func (s *Slice) CoerceFloat() (float64, Object)

func (*Slice) CoerceInt 

func (s *Slice) CoerceInt() (int64, Object)

func (*Slice) CoerceString 

func (s *Slice) CoerceString() (string, Object)

func (*Slice) Inspect 

func (s *Slice) Inspect() string

func (*Slice) Type 

func (s *Slice) Type() ObjectType

type StaticMethod added in v0.2.0 

type StaticMethod struct {
	Fn Object
}

StaticMethod wraps a function for use with @staticmethod. When called on an instance, self is not prepended.

func (*StaticMethod) AsBool added in v0.2.0 

func (s *StaticMethod) AsBool() (bool, Object)

func (*StaticMethod) AsDict added in v0.2.0 

func (s *StaticMethod) AsDict() (map[string]Object, Object)

func (*StaticMethod) AsFloat added in v0.2.0 

func (s *StaticMethod) AsFloat() (float64, Object)

func (*StaticMethod) AsInt added in v0.2.0 

func (s *StaticMethod) AsInt() (int64, Object)

func (*StaticMethod) AsList added in v0.2.0 

func (s *StaticMethod) AsList() ([]Object, Object)

func (*StaticMethod) AsString added in v0.2.0 

func (s *StaticMethod) AsString() (string, Object)

func (*StaticMethod) CoerceFloat added in v0.2.0 

func (s *StaticMethod) CoerceFloat() (float64, Object)

func (*StaticMethod) CoerceInt added in v0.2.0 

func (s *StaticMethod) CoerceInt() (int64, Object)

func (*StaticMethod) CoerceString added in v0.2.0 

func (s *StaticMethod) CoerceString() (string, Object)

func (*StaticMethod) Inspect added in v0.2.0 

func (s *StaticMethod) Inspect() string

func (*StaticMethod) Type added in v0.2.0 

func (s *StaticMethod) Type() ObjectType

type String 

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

func NewString added in v0.8.0 

func NewString(v string) *String

func (*String) AsBool 

func (s *String) AsBool() (bool, Object)

func (*String) AsDict 

func (s *String) AsDict() (map[string]Object, Object)

func (*String) AsFloat 

func (s *String) AsFloat() (float64, Object)

func (*String) AsInt 

func (s *String) AsInt() (int64, Object)

func (*String) AsList 

func (s *String) AsList() ([]Object, Object)

func (*String) AsString 

func (s *String) AsString() (string, Object)

func (*String) CoerceFloat 

func (s *String) CoerceFloat() (float64, Object)

func (*String) CoerceInt 

func (s *String) CoerceInt() (int64, Object)

func (*String) CoerceString 

func (s *String) CoerceString() (string, Object)

func (*String) Inspect 

func (s *String) Inspect() string

func (*String) StringValue added in v0.8.0 

func (s *String) StringValue() string

func (*String) Type 

func (s *String) Type() ObjectType

type Super 

type Super struct {
	Class    *Class
	Instance *Instance
}

func (*Super) AsBool 

func (s *Super) AsBool() (bool, Object)

func (*Super) AsDict 

func (s *Super) AsDict() (map[string]Object, Object)

func (*Super) AsFloat 

func (s *Super) AsFloat() (float64, Object)

func (*Super) AsInt 

func (s *Super) AsInt() (int64, Object)

func (*Super) AsList 

func (s *Super) AsList() ([]Object, Object)

func (*Super) AsString 

func (s *Super) AsString() (string, Object)

func (*Super) CoerceFloat 

func (s *Super) CoerceFloat() (float64, Object)

func (*Super) CoerceInt 

func (s *Super) CoerceInt() (int64, Object)

func (*Super) CoerceString 

func (s *Super) CoerceString() (string, Object)

func (*Super) Inspect 

func (s *Super) Inspect() string

func (*Super) Type 

func (s *Super) Type() ObjectType

type Tuple 

type Tuple struct {
	Elements []Object
}

func (*Tuple) AsBool 

func (t *Tuple) AsBool() (bool, Object)

func (*Tuple) AsDict 

func (t *Tuple) AsDict() (map[string]Object, Object)

func (*Tuple) AsFloat 

func (t *Tuple) AsFloat() (float64, Object)

func (*Tuple) AsInt 

func (t *Tuple) AsInt() (int64, Object)

func (*Tuple) AsList 

func (t *Tuple) AsList() ([]Object, Object)

func (*Tuple) AsString 

func (t *Tuple) AsString() (string, Object)

func (*Tuple) CoerceFloat 

func (t *Tuple) CoerceFloat() (float64, Object)

func (*Tuple) CoerceInt 

func (t *Tuple) CoerceInt() (int64, Object)

func (*Tuple) CoerceString 

func (t *Tuple) CoerceString() (string, Object)

func (*Tuple) Inspect 

func (t *Tuple) Inspect() string

func (*Tuple) Type 

func (t *Tuple) Type() ObjectType

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.