Documentation
¶
Overview ¶
Code generated by `lginterop -packages github.com/zeebo/xxh3`. DO NOT EDIT.
Index ¶
- Constants
- Variables
- func AddValue(a, b vm.Value) vm.Value
- func AllNSes() map[string]*vm.Namespace
- func BoxNativeFn(fn any) vm.Value
- func BoxRestArgs(args []vm.Value) vm.Value
- func ClearTaps()
- func DefNSBare(name string) *vm.Namespace
- func DumpNamespaces(fileName string)
- func EDNEncodeArgs(args []vm.Value) (string, error)
- func EmbeddedNSNames() []string
- func EmbeddedSource(name string) (string, bool)
- func FuzzyNamespacedSymbolLookup(currentNS *vm.Namespace, s vm.Symbol) []vm.Symbol
- func GeValue(a, b vm.Value) bool
- func GtValue(a, b vm.Value) bool
- func InvokeValue(target vm.Value, args []vm.Value) (vm.Value, error)
- func JSONDecodeValue(s string) (vm.Value, error)
- func JSONEncodeArgs(args []vm.Value) (string, error)
- func LeValue(a, b vm.Value) bool
- func LookupNS(name string) *vm.Namespace
- func LookupOrRegisterNS(name string) *vm.Namespace
- func LookupOrRegisterNSNoLoad(name string) *vm.Namespace
- func LookupVar(nsName, symName string) *vm.Var
- func LtValue(a, b vm.Value) bool
- func MakeNativeMultiArity(fns []vm.Value) vm.Value
- func MarkNSNeedsLoad(name string)
- func MulValue(a, b vm.Value) vm.Value
- func NS(name string) *vm.Namespace
- func QuotValue(a, b vm.Value) vm.Value
- func RegisterInstaller(fn func())
- func RegisterNS(namespace *vm.Namespace) *vm.Namespace
- func RequireNS(name string) (*vm.Namespace, error)
- func SetEvalInNS(fn func(string, *vm.Namespace) (vm.Value, error))
- func SetNSLoader(loader NSLoader)
- func SetReadEDN(fn func(string) (vm.Value, error))
- func ShutdownAllPods()
- func SubValue(a, b vm.Value) vm.Value
- func TransitDecodeValue(s string) (vm.Value, error)
- func TransitEncodeArgs(args []vm.Value) (string, error)
- type FileStat
- type HTTPRequest
- type HTTPResponse
- type Handler
- type IOHandle
- type LGBuffer
- type LGReader
- type LGURL
- type LGWriter
- type Mult
- type NSLoader
- type Pod
- type PromiseChan
- type Pub
- type ShellResult
- type SpawnResult
- type TransitDecoder
- type TransitEncoder
- type UnameResult
- type WaitResult
Constants ¶
const NameCoreNS = "core"
Variables ¶
var ( ReadableProto *vm.Protocol // method: -make-reader [x] → reader WritableProto *vm.Protocol // method: -make-writer [x] → writer )
IReadable and IWritable are the IO coercion protocols. Extending these allows user-defined types to participate in the IO system.
var ( Version = "dev" Commit = "none" )
Version and Commit are set by lg.go from goreleaser ldflags at startup.
var AsyncSrc string
var CheckSrc string
var CoreCompiledLGB []byte
var CoreNS *vm.Namespace
var CoreSrc string
var CurrentNS *vm.Var
var DataSrc string
var EdnSrc string
var GoASTType *theGoASTType = &theGoASTType{}
var GraphSrc string
var HashSrc string
var IRBuildSrc string
var IRDataSrc string
var IRDominanceSrc string
var IRDumpSrc string
var IRLowerGoSrc string
var IRLowerSrc string
var IRPassCSESrc string
var IRPassConstFoldSrc string
var IRPassDCESrc string
var IRPassInferArgTypesSrc string
var IRPassLICMSrc string
var IRPassMutabilitySrc string
var IRPassPipelineSrc string
var IRPassTraceSrc string
var IRPassTypeInferSrc string
var IRPassesSrc string
var IRValidateSrc string
force-rebuild-marker-2
var IRZipperSrc string
var IoSrc string
var PprintSrc string
var SetSrc string
var StringSrc string
var TestSrc string
var WalkSrc string
var ZipSrc string
Functions ¶
func BoxNativeFn ¶ added in v1.9.0
BoxNativeFn wraps a Go function literal as a let-go callable. Lowered Go closures use this at the runtime boundary after capturing outer Go locals directly.
func BoxRestArgs ¶ added in v1.9.0
BoxRestArgs boxes a variadic rest-args slice into a vm.Value list. Used by the Go lowering when lowering :load-arg for the rest arg of a variadic function (where the Go param is ...vm.Value).
func ClearTaps ¶ added in v1.9.0
func ClearTaps()
ClearTaps drops every registered tap fn. `add-tap` appends to a process-global slice with no automatic removal, so a test that taps without `remove-tap` (e.g. clojure-test-suite's taps.cljc) leaks its tap closure — and, because all of a compile pass's fns share one vm.Consts, the closure pins that whole constant pool. Re-running the suite in a loop (BenchmarkClojureTestSuite) thus accumulates ~one Consts pool per iteration. The bench calls this between iterations to keep that from growing unboundedly.
func DefNSBare ¶ added in v1.3.0
DefNSBare creates and registers a minimal namespace (with CoreNS refer) without triggering the loader. Used during bytecode decoding to create var homes for not-yet-loaded namespaces.
func DumpNamespaces ¶
func DumpNamespaces(fileName string)
func EDNEncodeArgs ¶ added in v1.1.0
EDNEncodeArgs encodes args as an EDN vector string.
func EmbeddedNSNames ¶ added in v1.9.0
func EmbeddedNSNames() []string
EmbeddedNSNames returns every embedded namespace name (dotted form), derived from the embedded file tree. Used by lgbgen to discover what to precompile.
func EmbeddedSource ¶ added in v1.9.0
EmbeddedSource returns the source of an embedded namespace by its dotted ns name.
Naming rule (mirrors `cmd/lgbgen.nsToGoPkgName` direction-flipped):
- dots are path separators: `ir.passes.dce` → `ir/passes/dce.lg`
- in the *leaf* segment, hyphens map to underscores so the file name is a legal Go-style identifier: `ir.lower-go` → `ir/lower_go.lg`
Returns ("", false) if no matching file exists.
func InvokeValue ¶ added in v1.9.0
InvokeValue applies a runtime callable using let-go's dynamic invocation path.
func JSONDecodeValue ¶ added in v1.1.0
JSONDecodeValue decodes a JSON string into a vm.Value.
func JSONEncodeArgs ¶ added in v1.1.0
JSONEncodeArgs encodes args as a plain JSON array string.
func LookupOrRegisterNS ¶
func MakeNativeMultiArity ¶ added in v1.9.0
MakeNativeMultiArity combines native-lowered function branches into a runtime multi-arity callable.
func MarkNSNeedsLoad ¶ added in v1.3.0
func MarkNSNeedsLoad(name string)
MarkNSNeedsLoad flags a namespace as needing on-demand loading even though it already exists in the registry (created during bytecode decoding).
func RegisterInstaller ¶ added in v1.9.0
func RegisterInstaller(fn func())
RegisterInstaller queues fn to be called from lang.go's init(). Call this from your file's init() — it is not safe to call after init has run.
func RequireNS ¶ added in v1.9.0
RequireNS loads/materializes a namespace and reports an error when a loader is configured but the namespace could not be loaded. RequireNS loads/materializes a namespace and reports an error if a loader is configured but the namespace could not be loaded. Returns nil namespace on error (no half-initialized placeholder is leaked).
func SetEvalInNS ¶ added in v1.1.0
SetEvalInNS sets the namespace-aware eval function.
func SetNSLoader ¶
func SetNSLoader(loader NSLoader)
func SetReadEDN ¶ added in v1.1.0
SetReadEDN sets the EDN reader function (called by compiler package).
func ShutdownAllPods ¶ added in v1.1.0
func ShutdownAllPods()
ShutdownAllPods gracefully shuts down all loaded pods.
func TransitDecodeValue ¶ added in v1.1.0
TransitDecodeValue decodes a transit+json payload string.
Types ¶
type FileStat ¶
type FileStat struct {
Name string `letgo:"name"`
Size int64 `letgo:"size"`
IsDir bool `letgo:"dir?"`
ModTime string `letgo:"mod-time"`
}
FileStat is the struct behind os/stat return values.
type HTTPRequest ¶
type HTTPRequest struct {
RequestMethod string `letgo:"request-method"`
Scheme string `letgo:"scheme"`
URI string `letgo:"uri"`
Path string `letgo:"path"`
QueryString string `letgo:"query-string"`
Body string `letgo:"body"`
RemoteAddr string `letgo:"remote-addr"`
ServerAddr string `letgo:"server-addr"`
ServerPort string `letgo:"server-port"`
ContentType string `letgo:"content-type"`
Headers vm.Value `letgo:"headers"`
}
HTTPRequest is the struct behind ring-style HTTP request maps.
type HTTPResponse ¶
type HTTPResponse struct {
Status int `letgo:"status"`
Body vm.Value `letgo:"body"`
Headers vm.Value `letgo:"headers"`
}
HTTPResponse is the struct behind HTTP client response maps.
type IOHandle ¶
IOHandle wraps an *os.File with optional buffered reader for line-based reads.
func NewIOHandle ¶
type LGReader ¶
type LGReader struct {
// contains filtered or unexported fields
}
LGReader wraps any io.Reader with optional buffering and close.
type LGURL ¶
type LGURL struct {
Scheme string `letgo:"scheme"`
Host string `letgo:"host"`
Port string `letgo:"port"`
Path string `letgo:"path"`
Query string `letgo:"query"`
Fragment string `letgo:"fragment"`
UserInfo string `letgo:"user-info"`
Raw string `letgo:"raw"`
}
LGURL represents a parsed URL as a record.
type LGWriter ¶
type LGWriter struct {
// contains filtered or unexported fields
}
LGWriter wraps any io.Writer with optional buffering and close.
type Mult ¶
type Mult struct {
// contains filtered or unexported fields
}
Mult broadcasts values from a source channel to multiple tap channels.
type NSLoader ¶
func GetNSLoader ¶ added in v1.5.0
func GetNSLoader() NSLoader
type Pod ¶ added in v1.1.0
type Pod struct {
// contains filtered or unexported fields
}
Pod represents a running babashka pod subprocess.
func (*Pod) InvokeAsync ¶ added in v1.1.0
InvokeAsync calls a pod var and sends results to a channel. The channel stays open for streaming - the pod sends multiple values with the same id.
type PromiseChan ¶ added in v1.9.0
type PromiseChan struct {
// contains filtered or unexported fields
}
PromiseChan implements clojure.core.async's promise-chan: a channel that caches the FIRST value put to it and replays that value to every taker, forever. Subsequent puts are dropped; closing without a value makes takers receive nil; closing after a value is a no-op (the value keeps being served).
Unlike a raw vm.Chan it STORES the value rather than transferring it, which is what makes the semantics correct: with a single raw channel a taker parked before the first put could steal that put before it was cached, so later takers would never see it. Storing the value behind a latch removes that race entirely.
Dispatched to by >! / <! / close! when they receive a boxed *PromiseChan instead of a vm.Chan. Methods are unexported so the reflective method-boxing in vm.NewBoxed skips them.
type Pub ¶
type Pub struct {
// contains filtered or unexported fields
}
Pub routes values from a source channel to subscribers by topic.
type ShellResult ¶
type ShellResult struct {
Exit int `letgo:"exit"`
Out string `letgo:"out"`
Err string `letgo:"err"`
}
ShellResult is the struct behind os/sh return values.
type SpawnResult ¶ added in v1.4.0
type SpawnResult struct {
Pid int `letgo:"pid"`
Exit int `letgo:"exit"`
Out string `letgo:"out"`
Err string `letgo:"err"`
}
SpawnResult is the struct behind syscall/spawn return values.
type TransitDecoder ¶ added in v1.1.0
type TransitDecoder struct {
// contains filtered or unexported fields
}
TransitDecoder decodes transit+json into vm.Values.
func NewTransitDecoder ¶ added in v1.1.0
func NewTransitDecoder() *TransitDecoder
NewTransitDecoder creates a new decoder with a fresh cache.
type TransitEncoder ¶ added in v1.1.0
type TransitEncoder struct {
// contains filtered or unexported fields
}
TransitEncoder encodes vm.Values to transit+json.
func NewTransitEncoder ¶ added in v1.1.0
func NewTransitEncoder() *TransitEncoder
NewTransitEncoder creates a new encoder with a fresh cache.
func (*TransitEncoder) Encode ¶ added in v1.1.0
func (e *TransitEncoder) Encode(v vm.Value) (string, error)
Encode encodes a vm.Value to a transit+json string.
func (*TransitEncoder) EncodeList ¶ added in v1.1.0
func (e *TransitEncoder) EncodeList(vals []vm.Value) (string, error)
EncodeList encodes a slice of values as a transit list (used for pod args).
type UnameResult ¶ added in v1.4.0
type UnameResult struct {
Sysname string `letgo:"sysname"`
Machine string `letgo:"machine"`
Release string `letgo:"release"`
Nodename string `letgo:"nodename"`
}
UnameResult is the struct behind syscall/uname return values.
type WaitResult ¶ added in v1.4.0
type WaitResult struct {
Pid int `letgo:"pid"`
Status int `letgo:"status"`
Signal int `letgo:"signal"`
}
WaitResult is the struct behind syscall/waitpid return values. Status is the exit code (0-255) for normal exits, -1 for signal deaths. Signal is the terminating signal number (0 when not signal-killed).
Source Files
¶
- async.go
- asyncembed.go
- check.go
- chunk_unbox.go
- core_embed.go
- core_embed_fs.go
- data.go
- disasm.go
- dump.go
- edn.go
- gogen.go
- golower_runtime.go
- graph.go
- hash.go
- hierarchy.go
- http.go
- installers.go
- interop_xxh3.go
- io.go
- ions.go
- iort.go
- ir_bridge_generated.go
- irbuild.go
- irpasses.go
- json.go
- lang.go
- math.go
- os.go
- parallel.go
- pods.go
- pprint.go
- profile.go
- set.go
- string.go
- syscall_linux.go
- system.go
- term.go
- term_pty_linux.go
- test.go
- transit.go
- types.go
- types_linux.go
- unix_linux.go
- user.go
- walk.go
- zip.go
- zz_run_installers.go