codegen

func ContentRevision ¶

func ContentRevision(dir string) (string, error)

ContentRevision returns a short content-addressable revision for the generated library in dir. It hashes every Go source file plus go.mod and go.sum in sorted path order, so the result is a stable fingerprint of the factory source, the inlined UB libraries, and the full pinned Go dependency set that go.sum records. The compiled binary itself is excluded; only build inputs contribute. Run it after `go mod tidy` so go.sum is present.

func EncodeNode ¶

func EncodeNode(n lang.Node) (string, error)

EncodeNode renders a parsed `lang` AST node as a Go expression that constructs an equivalent value. The expression evaluates to the matching `lang` pointer type (`*lang.File` for a File, `*lang.Field` for a Field, the matching `*lang.X` for any expression node).

Source positions are not encoded; the produced node has zero Span values. The encoder handles every plain expression node and every `TypeExpr` node; callers must not pass a node kind the parser does not produce as part of a body.

func EncodeSyntaxFactoryBody ¶ added in v0.8.0

func EncodeSyntaxFactoryBody(n syntax.FactoryBody) (string, error)

EncodeSyntaxFactoryBody renders a typed factory or composite body as a Go expression. Source positions are omitted; runtime graph extraction only needs declaration names, selectors, and expression bodies.

func EncodeSyntaxFactoryBodyWithSpans ¶ added in v0.8.0

func EncodeSyntaxFactoryBodyWithSpans(
	n syntax.FactoryBody,
	spanName SyntaxSpanNamer,
) (string, error)

EncodeSyntaxFactoryBodyWithSpans renders a body while preserving source spans.

func Generate ¶

func Generate(in Input) ([]byte, error)

Generate produces the formatted Go source for the factory binary's main.go. The result is the bytes a caller writes to disk and feeds through `go build`.

func GenerateUBLibrary ¶

func GenerateUBLibrary(
	alias string,
	syntaxBodies map[string]map[string]syntax.FactoryBody,
	imports map[string]map[string]map[string]string,

) ([]byte, error)

GenerateUBLibrary produces the Go source for a UB library's generated package. The package's name is alias; it exports a `Library()` function returning a `*runtime.Library` whose composites are split into one map per kind (ResourceComposites, DataComposites, ActionComposites). syntaxBodies are keyed by kind and then composite name; each generated registration uses SyntaxBody.

imports maps each composite's kind and name to its resolved import table: the composite's body's own imports block, with each declared alias mapped to its canonical library path. Generated composites declare LibraryBindings for the factory catalog to resolve. Pass nil or an empty map when a composite has no imports.

func GenerateUBLibraryPackage ¶ added in v0.8.0

func GenerateUBLibraryPackage(
	packageID string,
	libraryName string,
	syntaxBodies map[string]map[string]syntax.FactoryBody,
	imports map[string]map[string]map[string]string,

	sourceFiles map[string]syntax.SourceFileSpec,
) ([]byte, error)

GenerateUBLibraryPackage produces a UB library package whose Go package identifier can differ from the runtime library name.

func GenerateUBLibraryPackageWithAssets ¶ added in v0.11.0

func GenerateUBLibraryPackageWithAssets(
	packageID string,
	libraryName string,
	syntaxBodies map[string]map[string]syntax.FactoryBody,
	imports map[string]map[string]map[string]string,

	sourceFiles map[string]syntax.SourceFileSpec,
	assetSetIDs map[string]map[string]string,
) ([]byte, error)

GenerateUBLibraryPackageWithAssets includes the captured asset-set ID for each composite body.

func GenerateUBLibraryPackageWithAssetsAndConfigSchemas ¶ added in v0.11.0

func GenerateUBLibraryPackageWithAssetsAndConfigSchemas(
	packageID string,
	libraryName string,
	syntaxBodies map[string]map[string]syntax.FactoryBody,
	imports map[string]map[string]map[string]string,

	sourceFiles map[string]syntax.SourceFileSpec,
	assetSetIDs map[string]map[string]string,
	libraryConfigSchemas map[string]map[string]map[string]runtime.LibraryConfigSchema,
) ([]byte, error)

GenerateUBLibraryPackageWithAssetsAndConfigSchemas includes the captured asset-set IDs and resolved library-config schemas for each composite body.

func WriteSource ¶

func WriteSource(
	dir string,
	in Input,
	goVersion, unobinVersion string,
	importVersions map[string]string,
	replaces Replaces,
) ([]filechange.Change, error)

WriteSource lays out a generated binary's source tree in dir, ready for `go build` to consume. It writes:

<dir>/main.go    // From Generate.
<dir>/go.mod     // With the right require statements.

goVersion is the Go toolchain version to declare. unobinVersion is the version of `github.com/cloudboss/unobin` the generated binary depends on. importVersions maps each library's Go import path to the version constraint to require for callers that have not set Input.GoModules. replaces maps a module path to a local path to substitute via `replace`.