Directories
¶
| Path | Synopsis |
|---|---|
|
Package argv reads another program's argument vector without knowing that program's option table: whether a POSIX short flag or a GNU long option is present, the way getopt and getopt_long would see it.
|
Package argv reads another program's argument vector without knowing that program's option table: whether a POSIX short flag or a GNU long option is present, the way getopt and getopt_long would see it. |
|
Package boundedbuffer provides an io.Writer that retains at most a fixed number of bytes while reporting the original write lengths to its producer.
|
Package boundedbuffer provides an io.Writer that retains at most a fixed number of bytes while reporting the original write lengths to its producer. |
|
Package config provides small, domain-neutral parsers and validators for configuration values.
|
Package config provides small, domain-neutral parsers and validators for configuration values. |
|
Package cron is the schedule grammar: human-readable trigger declarations, their canonical five-field form, and the pure value model of triggers and occurrences that the scheduler, its store and the Liquid Proto contract share.
|
Package cron is the schedule grammar: human-readable trigger declarations, their canonical five-field form, and the pure value model of triggers and occurrences that the scheduler, its store and the Liquid Proto contract share. |
|
contract
Package contract maps the cron domain model to validated Liquid Proto messages at HTTP and messaging boundaries.
|
Package contract maps the cron domain model to validated Liquid Proto messages at HTTP and messaging boundaries. |
|
Package eventually is the one way a test in this repository waits for something to become true.
|
Package eventually is the one way a test in this repository waits for something to become true. |
|
gotth
|
|
|
bench/apps/chat/gotth
command
The gotth-live side of equivalence-spec §2.3's chat room.
|
The gotth-live side of equivalence-spec §2.3's chat room. |
|
bench/apps/counter/gotth
command
The gotth-live side of equivalence-spec §2.1's counter — app C-B, and only C-B.
|
The gotth-live side of equivalence-spec §2.1's counter — app C-B, and only C-B. |
|
bench/apps/dashboard/gotth
command
The gotth-live side of equivalence-spec §2.4's live dashboard.
|
The gotth-live side of equivalence-spec §2.4's live dashboard. |
|
docs/guide/_samples
Package samples is the compiled twin of the gotth-live documentation.
|
Package samples is the compiled twin of the gotth-live documentation. |
|
docs/guide/_samples/apptest
Package apptest is the compiled source for docs/guide/testing-your-app.md: a small application, and the specs that hold it to the library's contracts.
|
Package apptest is the compiled source for docs/guide/testing-your-app.md: a small application, and the specs that hold it to the library's contracts. |
|
docs/guide/_samples/architecture
Package architecture is the compiled source for docs/guide/architecture.md.
|
Package architecture is the compiled source for docs/guide/architecture.md. |
|
docs/guide/_samples/deploying
Package deploying is the compiled source for docs/guide/deploying.md.
|
Package deploying is the compiled source for docs/guide/deploying.md. |
|
docs/guide/_samples/effects
Package effects is the compiled source for docs/guide/effects-and-server-push.md.
|
Package effects is the compiled source for docs/guide/effects-and-server-push.md. |
|
docs/guide/_samples/errorhandling
Package errorhandling is the compiled source for docs/guide/error-handling.md.
|
Package errorhandling is the compiled source for docs/guide/error-handling.md. |
|
docs/guide/_samples/events
Package events is the compiled source for docs/guide/events-and-forms.md.
|
Package events is the compiled source for docs/guide/events-and-forms.md. |
|
docs/guide/_samples/fragments
Package fragments is the compiled source for docs/guide/fragments-and-dirty-tracking.md.
|
Package fragments is the compiled source for docs/guide/fragments-and-dirty-tracking.md. |
|
docs/guide/_samples/htmxinterop
Package htmxinterop is the compiled source for docs/guide/htmx-interop.md.
|
Package htmxinterop is the compiled source for docs/guide/htmx-interop.md. |
|
docs/guide/_samples/keychords
Package keychords is the compiled source for the two modifier-aware options on docs/guide/events-and-forms.md: live.Bind.NoModifiers and live.Bind.PreventDefault.
|
Package keychords is the compiled source for the two modifier-aware options on docs/guide/events-and-forms.md: live.Bind.NoModifiers and live.Bind.PreventDefault. |
|
docs/guide/_samples/lifecycle
Package lifecycle is the compiled source for docs/guide/lifecycle-hooks.md.
|
Package lifecycle is the compiled source for docs/guide/lifecycle-hooks.md. |
|
docs/guide/_samples/mounting
Package mounting is the compiled source for the two things docs/quickstart.md §2 explains beside its router: where the live handler is mounted, and where the first paint's state comes from.
|
Package mounting is the compiled source for the two things docs/quickstart.md §2 explains beside its router: where the live handler is mounted, and where the first paint's state comes from. |
|
docs/guide/_samples/observability
Package observability is the compiled source for docs/guide/observability.md.
|
Package observability is the compiled source for docs/guide/observability.md. |
|
docs/guide/_samples/payments
Package payments is the compiled source for the idempotency section of docs/guide/effects-and-server-push.md.
|
Package payments is the compiled source for the idempotency section of docs/guide/effects-and-server-push.md. |
|
docs/guide/_samples/quickstart
command
Command quickstart is the application docs/quickstart.md builds: a number that lives in Go, and a button that changes it.
|
Command quickstart is the application docs/quickstart.md builds: a number that lives in Go, and a button that changes it. |
|
docs/guide/_samples/security
Package security is the compiled source for docs/guide/security.md.
|
Package security is the compiled source for docs/guide/security.md. |
|
internal/arch
Package arch holds this module's architecture tests.
|
Package arch holds this module's architecture tests. |
|
internal/clientcodec
Package clientcodec generates the browser runtime's protobuf codec, its predicate manifest, and the cross-runtime golden vectors, from the same FileDescriptorSet that drives the Go refinement generator.
|
Package clientcodec generates the browser runtime's protobuf codec, its predicate manifest, and the cross-runtime golden vectors, from the same FileDescriptorSet that drives the Go refinement generator. |
|
internal/cmd/gen-clientcodec
command
Command gen-clientcodec generates the browser runtime's protobuf codec.
|
Command gen-clientcodec generates the browser runtime's protobuf codec. |
|
internal/cmd/gotth-live-dev
command
Command gotth-live-dev is the server half of FR-57: it watches a gotth-live application's source, rebuilds it when a Go or templ file changes, and restarts it.
|
Command gotth-live-dev is the server half of FR-57: it watches a gotth-live application's source, rebuilds it when a Go or templ file changes, and restarts it. |
|
internal/livebridge
Package livebridge lets live/livetest construct a value only live can build.
|
Package livebridge lets live/livetest construct a value only live can build. |
|
internal/obs
Package obs is the library's instrumentation: metrics, traces and the provenance log.
|
Package obs is the library's instrumentation: metrics, traces and the provenance log. |
|
internal/obstest
Package obstest records what the library actually emits, so that a spec can assert on a signal rather than on a method having been called.
|
Package obstest records what the library actually emits, so that a spec can assert on a signal rather than on a method having been called. |
|
internal/protocol
Package protocol is the boundary every byte crosses in either direction.
|
Package protocol is the boundary every byte crosses in either direction. |
|
internal/render
Package render turns state into whole HTML fragments.
|
Package render turns state into whole HTML fragments. |
|
internal/session
Package session implements the service that maintains one WebSocket connection's widget state.
|
Package session implements the service that maintains one WebSocket connection's widget state. |
|
internal/wsx
Package wsx is the WebSocket transport, and the only place it exists.
|
Package wsx is the WebSocket transport, and the only place it exists. |
|
live
Package live serves server-driven live user interfaces from Go.
|
Package live serves server-driven live user interfaces from Go. |
|
live/livetest
Package livetest provides testing helpers for live applications.
|
Package livetest provides testing helpers for live applications. |
|
test/internal/chaos/cmd/chaossrv
command
Command chaossrv is a live server in its own process, for the one chaos case that cannot be expressed inside the test binary.
|
Command chaossrv is a live server in its own process, for the one chaos case that cannot be expressed inside the test binary. |
|
test/memory
Package memory is the G2 idle-connection memory harness: the arithmetic half of equivalence-spec §3.6, with the three commands beside it supplying the server under test, the synthetic session driver, and the report.
|
Package memory is the G2 idle-connection memory harness: the arithmetic half of equivalence-spec §3.6, with the three commands beside it supplying the server under test, the synthetic session driver, and the report. |
|
test/memory/cmd/memdiag
command
Command memdiag reports the G2 remediation diagnostic that diag.sh collects.
|
Command memdiag reports the G2 remediation diagnostic that diag.sh collects. |
|
test/memory/cmd/memdrv
command
Command memdrv is equivalence-spec §3.6's synthetic session driver for gotth-live: it opens N real sessions against a memsrv, holds them IDLE, and keeps them alive for as long as the harness needs them.
|
Command memdrv is equivalence-spec §3.6's synthetic session driver for gotth-live: it opens N real sessions against a memsrv, holds them IDLE, and keeps them alive for as long as the harness needs them. |
|
test/memory/cmd/memsrv
command
Command memsrv is the server under test for the G2 idle-connection memory baseline (RFC-0001 §6.1/§6.2, equivalence-spec §3.6).
|
Command memsrv is the server under test for the G2 idle-connection memory baseline (RFC-0001 §6.1/§6.2, equivalence-spec §3.6). |
|
test/memory/cmd/memstat
command
Command memstat turns the sample files measure.sh collects into the figure equivalence-spec §3.6 defines, and refuses to produce one from a window that is not §3.6's window.
|
Command memstat turns the sample files measure.sh collects into the figure equivalence-spec §3.6 defines, and refuses to produce one from a window that is not §3.6's window. |
|
test/routers
Package routers holds the FR-33 three-router mount suite and nothing else.
|
Package routers holds the FR-33 three-router mount suite and nothing else. |
|
test/sampling
Package sampling holds FR-36 clause 4's falsifier and nothing else.
|
Package sampling holds FR-36 clause 4's falsifier and nothing else. |
|
tools/apisurface
command
Command apisurface counts the library's exported surface and holds it against the ledger.
|
Command apisurface counts the library's exported surface and holds it against the ledger. |
|
tools/doccheck
command
Command doccheck holds every exported symbol in the tree to a doc comment, and every godoc example to an output the test runner actually checks.
|
Command doccheck holds every exported symbol in the tree to a doc comment, and every godoc example to an output the test runner actually checks. |
|
tools/minify
command
Command minify builds the files the library serves, and measures them.
|
Command minify builds the files the library serves, and measures them. |
|
Package httpserver provides the shared Gin HTTP surface used by Candace services.
|
Package httpserver provides the shared Gin HTTP surface used by Candace services. |
|
Package labels canonicalizes case-insensitive label lists, such as CI runner labels, so services compare, deduplicate, and match them with one set of semantics.
|
Package labels canonicalizes case-insensitive label lists, such as CI runner labels, so services compare, deduplicate, and match them with one set of semantics. |
|
Package liquidproto provides the small runtime used by Liquid Proto generated code and deterministic, validating protobuf serialization.
|
Package liquidproto provides the small runtime used by Liquid Proto generated code and deterministic, validating protobuf serialization. |
|
cmd/protoc-gen-liquidproto
command
protoc-gen-liquidproto compiles Liquid Proto field refinements into native Go validation boundaries.
|
protoc-gen-liquidproto compiles Liquid Proto field refinements into native Go validation boundaries. |
|
cmd/protoc-gen-liquidproto/internal/expr
Package expr compiles the small Liquid Proto predicate grammar to Go.
|
Package expr compiles the small Liquid Proto predicate grammar to Go. |
|
cmd/protoc-gen-liquidproto/internal/gen
Package gen turns Liquid Proto field refinements into Go validators.
|
Package gen turns Liquid Proto field refinements into Go validators. |
|
Package listsched is list scheduling (Graham, 1969): whenever a machine is free, start the highest-priority ready task that may run beside what is running.
|
Package listsched is list scheduling (Graham, 1969): whenever a machine is free, start the highest-priority ready task that may run beside what is running. |
|
Package mailbox serializes ownership of a mutable value onto one goroutine.
|
Package mailbox serializes ownership of a mutable value onto one goroutine. |
|
Package pgmem provides a fast, process-local PostgreSQL emulator for Go tests.
|
Package pgmem provides a fast, process-local PostgreSQL emulator for Go tests. |
|
Package privatefile reads bounded, owner-only configuration and secret files.
|
Package privatefile reads bounded, owner-only configuration and secret files. |
|
Package redact removes caller-declared sensitive values from text destined for logs or operator diagnostics.
|
Package redact removes caller-declared sensitive values from text destined for logs or operator diagnostics. |
|
Package sqlmigrate applies a service's embedded migration files to a database/sql handle, so a service's store directory holds its .sql files and nothing else: the files are the only schema source, and this is the one runner that reads them.
|
Package sqlmigrate applies a service's embedded migration files to a database/sql handle, so a service's store directory holds its .sql files and nothing else: the files are the only schema source, and this is the one runner that reads them. |
|
Package telemetry provides dependency-light distributed trace propagation and structured JSONL logging over the candace.telemetry.v1 protobuf contracts.
|
Package telemetry provides dependency-light distributed trace propagation and structured JSONL logging over the candace.telemetry.v1 protobuf contracts. |
|
Package widget is the widget SDK: the contract a widget implements, the registry a host binary mounts them through, and the interpreter for the small Mermaid dialect widgets are declared in.
|
Package widget is the widget SDK: the contract a widget implements, the registry a host binary mounts them through, and the interpreter for the small Mermaid dialect widgets are declared in. |
|
internal/cmd/widgetc
command
Command widgetc validates widget documents and prints their findings.
|
Command widgetc validates widget documents and prints their findings. |
|
internal/diag
Package diag carries the widget validator's location-anchored findings and the identifiers of the error catalogue every finding belongs to.
|
Package diag carries the widget validator's location-anchored findings and the identifiers of the error catalogue every finding belongs to. |
|
internal/ir
Package ir holds the widget interpreter's typed intermediate representation: one resolved, ordered, total record per document.
|
Package ir holds the widget interpreter's typed intermediate representation: one resolved, ordered, total record per document. |
|
internal/lex
Package lex turns widget source into positioned tokens, one slice per significant line.
|
Package lex turns widget source into positioned tokens, one slice per significant line. |
|
internal/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
internal/parse
Package parse turns positioned tokens into a widget document's block structure, and reports every structural finding of the catalogue's W0 group.
|
Package parse turns positioned tokens into a widget document's block structure, and reports every structural finding of the catalogue's W0 group. |
|
internal/uigen
Package uigen turns one resolved widget document into the files that make it a running widget: a templ view and a Go scaffold implementing the SDK's widget contract.
|
Package uigen turns one resolved widget document into the files that make it a running widget: a templ view and a Go scaffold implementing the SDK's widget contract. |
|
internal/validate
Package validate resolves a parsed widget document into the typed IR and reports every finding of the error catalogue.
|
Package validate resolves a parsed widget document into the typed IR and reports every finding of the error catalogue. |
|
widgettest
Package widgettest renders a registered widget's own live region, so a specification can assert on what a viewer receives rather than on how the markup was produced.
|
Package widgettest renders a registered widget's own live region, so a specification can assert on what a viewer receives rather than on how the markup was produced. |
Click to show internal directories.
Click to hide internal directories.