Documentation
ΒΆ
Overview ΒΆ
Command lg is the let-go command line. Everything it does lives in github.com/nooga/let-go/pkg/cli so a third-party module can build a binary with the same full feature set β repl, resolver, -c, -b, -w β around its own generated interop packages. See docs/guide/custom-lg.md.
Only the ldflags contract stays here: goreleaser and the Makefile both set -X main.version / -X main.commit, and ldflags can only reach the package that declares the variable.
Directories
ΒΆ
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
bench-baton
command
Command bench-baton is a machine-quiescence lease for benchmarks, with a concurrent lane for builds and tests.
|
Command bench-baton is a machine-quiescence lease for benchmarks, with a concurrent lane for builds and tests. |
|
bench-ratchet
command
Command bench-ratchet runs Go benchmarks, normalizes results against a calibration anchor benchmark, and compares them to a stored baseline.
|
Command bench-ratchet runs Go benchmarks, normalizes results against a calibration anchor benchmark, and compares them to a stored baseline. |
|
bootprobe
command
bootprobe reports where core boot time goes: bundle decode vs definition replay vs everything else, using LoadCoreBundle's OnPhase hooks.
|
bootprobe reports where core boot time goes: bundle decode vs definition replay vs everything else, using LoadCoreBundle's OnPhase hooks. |
|
check-generated
command
check-generated's default mode exits non-zero when committed generator-input provenance is stale.
|
check-generated's default mode exits non-zero when committed generator-input provenance is stale. |
|
go-callables
command
Command go-callables measures Go callables for the code-quality report.
|
Command go-callables measures Go callables for the code-quality report. |
|
hoist-natives
command
Command hoist-natives is a codemod that lifts the inline anonymous closures registered as clojure.core primitives in pkg/rt/lang.go into named, //lg:native-annotated top-level functions.
|
Command hoist-natives is a codemod that lifts the inline anonymous closures registered as clojure.core primitives in pkg/rt/lang.go into named, //lg:native-annotated top-level functions. |
|
lg-runtime
command
|
|
|
lgbgen
command
This file carries the go:generate directives that regenerate the core bundle and the lowered Go tree from the .lg sources.
|
This file carries the go:generate directives that regenerate the core bundle and the lowered Go tree from the .lg sources. |
|
lgbstat
command
lgbstat reports where a .lgb's bytes go.
|
lgbstat reports where a .lgb's bytes go. |
|
lginterop
command
|
|
|
lgprimgen
command
Command lgprimgen generates pkg/rt/zz_primitives_generated.go from the //lg:native directives in the runtime's Go sources.
|
Command lgprimgen generates pkg/rt/zz_primitives_generated.go from the //lg:native directives in the runtime's Go sources. |
|
perf-page
command
|
|
|
examples
|
|
|
go_interop_lazy
command
Worked example: a Go program embeds let-go, then consumes potentially-infinite let-go sequences from Go using the new vm.Iter (Go 1.23+ iter.Seq[Value]) and vm.SeqToSlice helpers.
|
Worked example: a Go program embeds let-go, then consumes potentially-infinite let-go sequences from Go using the new vm.Iter (Go 1.23+ iter.Seq[Value]) and vm.SeqToSlice helpers. |
|
internal
|
|
|
gofragment
Package gofragment is the Go AST fragment oracle used by the native-entry gate and the jank direct-ABI test.
|
Package gofragment is the Go AST fragment oracle used by the native-entry gate and the jank direct-ABI test. |
|
lginteroptest/empty
Package empty deliberately exports nothing.
|
Package empty deliberately exports nothing. |
|
primgen
Package primgen scans //lg:-annotated Go sources and emits the zz_primitives_generated.go registrar.
|
Package primgen scans //lg:-annotated Go sources and emits the zz_primitives_generated.go registrar. |
|
pkg
|
|
|
bundle
Package bundle implements the standalone-binary trailer format and resource collection used by `lg -b`.
|
Package bundle implements the standalone-binary trailer format and resource collection used by `lg -b`. |
|
complete
Package complete supplies REPL symbol completion.
|
Package complete supplies REPL symbol completion. |
|
genmanifest
Provenance dependency manifest: which generator INPUTS feed each generated OUTPUT, plus exact readiness hashes for declared file outputs.
|
Provenance dependency manifest: which generator INPUTS feed each generated OUTPUT, plus exact readiness hashes for declared file outputs. |
|
gomod
Package gomod scaffolds the throwaway Go module that `lg` generates around emitted Go sources before handing them to `go build`.
|
Package gomod scaffolds the throwaway Go module that `lg` generates around emitted Go sources before handing them to `go build`. |
|
perfdata
Package perfdata defines the JSON schema shared by the perf tools.
|
Package perfdata defines the JSON schema shared by the perf tools. |
|
rt
This file carries no bootstrap build constraint on purpose: BootCore must exist in every build so a downstream caller compiles, and under -tags bootstrap the embedded core (CoreCompiledLGB) is empty, making LoadCoreBundle return the documented error instead of an undefined-symbol failure.
|
This file carries no bootstrap build constraint on purpose: BootCore must exist in every build so a downstream caller compiles, and under -tags bootstrap the embedded core (CoreCompiledLGB) is empty, making LoadCoreBundle return the documented error instead of an undefined-symbol failure. |
|
rt/builtins
Package builtins is the single-source home for direct-call-eligible clojure.core builtins: context-free functions with uniform vm.Value signatures.
|
Package builtins is the single-source home for direct-call-eligible clojure.core builtins: context-free functions with uniform vm.Value signatures. |
|
rt/corefns
Package corefns is a placeholder while the lginterop-driven direct-call path is being wired up.
|
Package corefns is a placeholder while the lginterop-driven direct-call path is being wired up. |
|
rt/wasm
Package wasm holds build-time JS and HTML assets for the `lg -w` WASM bundler.
|
Package wasm holds build-time JS and HTML assets for the `lg -w` WASM bundler. |
Click to show internal directories.
Click to hide internal directories.