classSqlGenerator

packages/sql-faker/src/Generation/SqlGenerator.php:31

final class SqlGenerator

Restricted visibility: declared "@visibility root". Code outside that scope must not name this declaration.

Derives terminals, rewrites structural constraints, and realizes lexemes once. Dialect definitions supply the syntax and boundary rules; no completed SQL is retried or repaired.

Properties§

public ?TerminalSequence $lastSequence = null

source §

The latest terminal sequence retains both the original grammar choices and their rewrites.

public ?ResolvedOutput $lastOutput = null

source §

Selected lexical candidates and resolved boundary rules from the latest generation.

Methods§

public function __construct(
    private Grammar $grammar,
    private Generator $faker,
    private LexicalGrammar $lexicalGrammar,
    private ?TokenRewriter $rewriter = null,
    private Closure(string|null): string|null $startSymbol = null,
    private ?GrammarCoverage $coverage = null,
    ?Grammar $original = null,
)

source §

Binds grammar, lexical definitions and structural rules before generation starts.

Parameters

`$grammar`	`Grammar`
`$faker`	`Generator`
`$lexicalGrammar`	`LexicalGrammar`
`$rewriter`	`?TokenRewriter`
`$startSymbol`	`Closure(string\|null): string\|null`	Resolves explicitly requested release aliases
`$coverage`	`?GrammarCoverage`
`$original`	`?Grammar`

Calls 3

new GrammarCoverageInventory line 58
method-call LexicalGrammar::version() line 58
static-call GeneratorRevision::current() line 58

public function planner(): PlanBuilder

source §

Reuses the same grammar, rewrite rules and lexical definitions to compile plans.

Returns

PlanBuilder

Test cases 1

SqlGeneratorTest::testPlannerBindsTheSameGrammarEntryAndFreezesEveryChoice calls

Called from 3

Calls 1

new PlanBuilder line 66

public function generate<TRequiresNonEmpty of bool>(GenerationPlan<TRequiresNonEmpty> $plan): (TRequiresNonEmpty is true ? non-empty-string : string)

source §

Generates once through the declared stages; candidate absence remains an error.

Parameters

$plan GenerationPlan<TRequiresNonEmpty>

Returns

(TRequiresNonEmpty is true ? non-empty-string : string)

Throws

GenerationException When the grammar or plan cannot produce the requested output

LexicalException When no applicable lexical realization exists

Test cases 33

Called from 3

Calls 11

method-call GenerationPlan::startRule() line 81
method-call GenerationPlan::expansionBudget() line 83
method-call GenerationPlan::lexicalTarget() line 83
method-call LexicalGrammar::generate() line 87
method-call SqlGenerator::realize() line 87
method-call GenerationPlan::requiresNonEmpty() line 88
static-call GenerationException::planRequiresNonEmptyOutput() line 89
method-call LexicalGrammar::version() line 89
function-call hash line 92
method-call SequenceObservation::preserved() line 93
new SequenceObservation line 93

public function realize(string $root, GenerationPlan<bool> $plan): string

source §

Derives and realizes once, retaining source selection independently of transformed output.

Parameters

`$root`	`string`
`$plan`	`GenerationPlan<bool>`

Returns

string

Throws

GenerationException When derivation cannot complete

LexicalException When a terminal has no compatible realization

Test cases 2

Called from 1

method-call SqlFaker\Generation\SqlGenerator::generate() packages/sql-faker/src/Generation/SqlGenerator.php:87

Calls 6

new TokenGenerator line 109
method-call LexicalGrammar::isNonOutput() line 109
method-call Generator::numberBetween() line 113
method-call LexicalGrammar::resolveSequence() line 114
method-call SqlSerializer::serialize() line 116
new SqlSerializer line 116

Private surface 7§

Implementation details, listed for orientation only.

private ?TokenGenerator $tokens = null

private Grammar $grammar

private Generator $faker

private LexicalGrammar $lexicalGrammar

private ?TokenRewriter $rewriter = null

private Closure(string|null): string|null $startSymbol = null

private ?GrammarCoverage $coverage = null

Test cases 42§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 17

Other tests reaching this symbol 25

Relations§

Instantiated in 3

Method calls 6

Type declarations 6