flatstack

package

v0.6.0 Latest Latest Go to latest Published: Oct 2, 2026 License: MIT Imports: 6 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/titpetric/phpscript

Links

Open Source Insights

Documentation ¶

Overview ¶

Package flatstack provides the runner embedding API with an opt-in flat bytecode backend. Unsupported programs are rejected before execution and run by the full interpreter, preserving runner behavior while the bytecode subset grows.

Index ¶

func Supports(p *model.Program) error
type Context
- func FromRequest(r *http.Request) Context
- func NewContext() Context
type ExitError
- func IsExit(err error) (*ExitError, bool)
type ExprCache
- func NewExprCache() *ExprCache
type HostPanicError
type IncludeCache
- func NewIncludeCache() *IncludeCache
type IncludeFunc
type Options
type Runtime
- func New(w io.Writer, opts Options) *Runtime
type Scope
- func NewScope() *Scope
- func ScopeFromContext(ctx context.Context) (*Scope, bool)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func Supports ¶

func Supports(p *model.Program) error

Supports reports whether p will execute through flat bytecode rather than the compatibility interpreter. Call this in benchmarks to prevent measuring an accidental fallback.

Types ¶

type Context ¶

type Context = runner.Context

Context is runner.Context.

func FromRequest ¶

func FromRequest(r *http.Request) Context

FromRequest returns the request context of r, decoded as a script reads it.

func NewContext ¶

func NewContext() Context

NewContext returns a request context a host fills itself.

type ExitError ¶

type ExitError = runner.ExitError

ExitError is runner.ExitError.

func IsExit ¶

func IsExit(err error) (*ExitError, bool)

IsExit reports whether err is the error exit() and die() raise, and answers it.

type ExprCache ¶

type ExprCache = runner.ExprCache

ExprCache is runner.ExprCache.

func NewExprCache ¶

func NewExprCache() *ExprCache

NewExprCache returns a compiled-expression cache to share between runtimes.

type HostPanicError ¶

type HostPanicError = runner.HostPanicError

HostPanicError is runner.HostPanicError.

type IncludeCache ¶

type IncludeCache = runner.IncludeCache

IncludeCache is runner.IncludeCache.

func NewIncludeCache ¶

func NewIncludeCache() *IncludeCache

NewIncludeCache returns a parsed-program cache to share between runtimes.

type IncludeFunc ¶

type IncludeFunc = runner.IncludeFunc

IncludeFunc is runner.IncludeFunc.

type Options ¶

type Options = runner.Options

Options is runner.Options.

type Runtime ¶

type Runtime = runner.Runtime

Runtime is runner.Runtime.

func New ¶

func New(w io.Writer, opts Options) *Runtime

New returns a runtime that executes a supported program through flat bytecode and delegates the whole of an unsupported one to the interpreter. It is the one call that separates this package from runner.

type Scope ¶

type Scope = runner.Scope

Scope is runner.Scope.

func NewScope ¶

func NewScope() *Scope

NewScope returns an empty scope.

func ScopeFromContext ¶

func ScopeFromContext(ctx context.Context) (*Scope, bool)

ScopeFromContext answers the PHP scope a binding was called from, when one is on ctx.

Source Files ¶

View all Source files

flatstack.go

Directories ¶

Path	Synopsis
engine Package engine compiles model AST programs into flat bytecode and executes them against a host-provided PHP semantics bridge.	Package engine compiles model AST programs into flat bytecode and executes them against a host-provided PHP semantics bridge.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL