classExpressionGroupingRule

packages/sql-faker/src/PostgreSql/Generation/Rewrite/Expression/ExpressionGroupingRule.php:15

final class ExpressionGroupingRule
    implements RewriteRule

Preserves derived operand grouping where the source grammar permits parenthesized expressions. This also prevents non-associative operators from being serialized as forbidden flat chains.

Methods§

public function __construct(
    private non-empty-list<string> $expressions,
    private string $source,
    private string $open = '(',
    private string $close = ')',
)

source §

Parameters

`$expressions`	`non-empty-list<string>`	Expression families with a parenthesized primary production
`$source`	`string`
`$open`	`string`
`$close`	`string`

public function rewrite(TerminalSequence $sequence): TerminalSequence

source §

Parenthesizes nested compound operands, retaining their original production and leaf identities.

Parameters

$sequence TerminalSequence

Returns

TerminalSequence

Test cases 7

Calls 11

method-call ExpressionGroupingRule::ranges() line 29
function-call min line 33
function-call array_map line 33
function-call in_array line 37
function-call array_search line 47
function-call array_slice line 48
function-call count line 49
new TerminalOccurrence line 50
function-call array_push line 58
function-call array_reverse line 60
method-call TerminalSequence::replace() line 62

public function ranges(TerminalSequence $sequence): array<int, array{int, int}>

source §

Finds all source subtree ranges in one pass through retained ancestor identities.

Parameters

$sequence TerminalSequence

Returns

array<int, array{int, int}>

Test cases 1

ExpressionGroupingRuleTest::testRangesIncludesNestedAncestorsAndIgnoresEmptyOccurrences calls

Called from 1

method-call SqlFaker\PostgreSql\Generation\Rewrite\Expression\ExpressionGroupingRule::rewrite() packages/sql-faker/src/PostgreSql/Generation/Rewrite/Expression/ExpressionGroupingRule.php:29

Private surface 4§

Implementation details, listed for orientation only.

private non-empty-list<string> $expressions

private string $source

private string $open = '('

private string $close = ')'

Test cases 11§

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

Dedicated tests 7

Other tests reaching this symbol 4

Relations§

Instantiated in 1

new SqlFaker\PostgreSql\Generation\Rewrite\RewriteDefinitions::create() packages/sql-faker/src/PostgreSql/Generation/Rewrite/RewriteDefinitions.php:83