Module com.darkcollective.relix.lang.ast

Package com.darkcollective.relix.lang.ast

package com.darkcollective.relix.lang.ast

Root scripting-language AST — the Script node and the Statement hierarchy.

A parsed .relix file is represented as a Script record containing an optional namespace string and an ordered list of Statements. The six statement kinds are:

• EnvStatement — env from '...' using '...'; declares the environment file and active profile.
• ImportStatement — import source X from '...'; pulls symbols from another file.
• SourceDeclaration — source X from http { ... }; declares a virtual relation backed by an external data source.
• AssignmentStatement — X := { RA-expr }; or X := [...]; gives a name to a query expression or an inline table.
• DefStatement — def f(x: NUMBER): NUMBER := { expr }; defines a scalar UDF.
• QueryStatement — query X; or query { expr }; produces output.

Embedded RA expressions (RelNode) and operand expressions (Operand) are stored as fully parsed objects produced by the relix-parser module; they are not raw strings. This keeps the AST type-safe and lets RA parse errors surface at script-parse time rather than later.

Related Packages

Package	Description
com.darkcollective.relix.lang.ast.source	Source-declaration AST — the configuration types that describe how a virtual relation retrieves its data.
com.darkcollective.relix.lang.ast.table	Inline table AST nodes — the two surface formats for embedding relation data directly in a .relix script.

Class	Description
AssignmentBody	Sealed interface for the right-hand side of an assignment statement.
AssignmentStatement	An assignment statement — gives a name to a relational algebra expression or an inline table.
ConnectionDeclaration	A top-level connection NAME from <type> { … } declaration.
DefRelationStatement	A def … : relation statement — defines a table-valued (relation-returning) user-defined function.
DefStatement	A def statement — defines a scalar user-defined function.
EndpointSpec	One endpoint of a RelateStatement — a relation reference plus the ordered columns joined at this side, with optional multiplicity bounds.
EnvStatement	An env statement — declares the environment file and active profile used for credential and configuration variable resolution.
ExpressionQueryTarget	A query target that holds an inline relational algebra expression.
ImportKind	Classifies the kind of symbol being imported in an ImportStatement.
ImportStatement	An import statement — brings symbols from another .relix file into the current namespace.
InlineTableBody	An assignment body that holds an inline data table (Markdown or CSV format).
NamedQueryTarget	A query target that references a previously declared symbol by name.
ParseWarning	A slip the parser accepted in a script, and says what to write instead.
QueryAssignmentBody	An assignment body that holds a parsed relational algebra expression.
QueryStatement	A query statement — produces output from a named symbol or an inline relational algebra expression.
QueryTarget	Sealed interface for the argument of a query statement.
RelateStatement	A standalone schema relationship declaration:
Script	The root AST node for a parsed .relix script file.
ScriptBuilders	The Script authoring surface — the statement-level half of the AST contract, for tests and embedders that assemble a whole script without the .relix grammar.
ScriptComments	The comments a parsed script carried, each placed by the code it was written next to, so that ScriptPrinter can put it back there.
ScriptComments.StatementComments	The comments placed by one statement, and whether a blank line came before it.
ScriptParseException	Thrown when a frontend cannot turn its input into a Script.
ScriptPrinter	Renders a Script — or one Statement — back as .relix text.
SourceDeclaration	A source declaration — names a virtual relation backed by an external data source.
Statement	Sealed root interface for every top-level declaration in a .relix script.