classRelationSourceParser

packages/ztd-query-sqlite/src/Sql/Relation/RelationSourceParser.php:17

final class RelationSourceParser

Restricted visibility: declared "@visibility ZtdQuery\Platform\Sqlite". Code outside that scope must not name this declaration.

Parses table sources, qualified identifiers and relation-clause boundaries.

Methods§

public function referencesFromClause(string $clause): list<array{name: string, start: int, unqualifiedStart: int, end: int}>

source §

Parameters

$clause string

Returns

list<array{name: string, start: int, unqualifiedStart: int, end: int}>

Test cases 1

RelationSourceParserTest::testReferencesFromClauseFindsJoinsButNotSubqueryBodies calls

Called from 2

Calls 6

method-call RelationSourceParser::tokens() line 24
class-const SqlTokenKind::Symbol() line 36
method-call RelationSourceParser::closingToken() line 44
function-call array_push line 48
method-call RelationSourceParser::nestedReferences() line 48
method-call RelationSourceParser::referenceAt() line 53

public function closingToken(list<SqlToken> $tokens, int $openingIndex): ?SqlToken

source §

Parameters

`$tokens`	`list<SqlToken>`
`$openingIndex`	`int`

Returns

?SqlToken

Test cases 1

RelationSourceParserTest::testClosingTokenReturnsMatchingTopLevelEnd calls

Called from 1

method-call ZtdQuery\Platform\Sqlite\Sql\Relation\RelationSourceParser::referencesFromClause() packages/ztd-query-sqlite/src/Sql/Relation/RelationSourceParser.php:44

public function referenceAt(
    string $sql,
    list<SqlToken> $tokens,
    int $index,
): array{name: string, start: int, unqualifiedStart: int, end: int}|null

source §

Parameters

`$sql`	`string`
`$tokens`	`list<SqlToken>`
`$index`	`int`

Returns

array{name: string, start: int, unqualifiedStart: int, end: int}|null

Test cases 1

RelationSourceParserTest::testReferenceAtRetainsQualifiedOffsets calls

Called from 1

method-call ZtdQuery\Platform\Sqlite\Sql\Relation\RelationSourceParser::referencesFromClause() packages/ztd-query-sqlite/src/Sql/Relation/RelationSourceParser.php:53

Calls 2

method-call RelationSourceParser::identifierComponentAt() line 88
class-const SqlTokenKind::Symbol() line 94

public function identifierComponentAt(
    list<SqlToken> $tokens,
    int $index,
): array{string, int, int, int, int}|null

source §

Parameters

`$tokens`	`list<SqlToken>`
`$index`	`int`

Returns

array{string, int, int, int, int}|null

Test cases 2

Called from 2

Calls 3

class-const SqlTokenKind::Word() line 127
class-const SqlTokenKind::QuotedIdentifier() line 130
static-call SqliteLexerProfile::create() line 133

public function findFromEnd(string $sql, list<SqlToken> $tokens, SqlToken $fromToken): int

source §

Parameters

`$sql`	`string`
`$tokens`	`list<SqlToken>`
`$fromToken`	`SqlToken`

Returns

int

Test cases 1

RelationSourceParserTest::testFindFromEndStopsAtClauseBoundary calls

Called from 2

Calls 2

method-call RelationSourceParser::matchesKeywordSequence() line 164
function-call strlen line 170

public function matchesKeywordSequence(
    list<SqlToken> $tokens,
    int $index,
    non-empty-list<string> $keywords,
): bool

source §

Parameters

`$tokens`	`list<SqlToken>`
`$index`	`int`
`$keywords`	`non-empty-list<string>`

Returns

bool

Test cases 1

RelationSourceParserTest::testMatchesKeywordSequenceChecksEveryPart calls

Called from 1

method-call ZtdQuery\Platform\Sqlite\Sql\Relation\RelationSourceParser::findFromEnd() packages/ztd-query-sqlite/src/Sql/Relation/RelationSourceParser.php:164

public function tokens(string $sql): list<SqlToken>

source §

Parameters

$sql string

Returns

list<SqlToken>

Test cases 1

RelationSourceParserTest::testTokensOmitsCommentsAndWhitespace calls

Called from 4

Calls 2

static-call SqlTokenStream::tokenize() line 194
static-call SqliteLexerProfile::create() line 194

public function nestedReferences(
    string $clause,
    int $start,
    int $end,
): list<array{name: string, start: int, unqualifiedStart: int, end: int}>

source §

Finds parenthesized join sources and translates their offsets to the enclosing clause.

Parameters

`$clause`	`string`
`$start`	`int`
`$end`	`int`

Returns

list<array{name: string, start: int, unqualifiedStart: int, end: int}>

Test cases 1

RelationSourceParserTest::testNestedReferencesTranslatesOffsets calls

Called from 1

method-call ZtdQuery\Platform\Sqlite\Sql\Relation\RelationSourceParser::referencesFromClause() packages/ztd-query-sqlite/src/Sql/Relation/RelationSourceParser.php:48

Calls 3

function-call substr line 203
method-call RelationSourceParser::tokens() line 204
method-call RelationSourceParser::referencesFromClause() line 209

Test cases 40§

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

Dedicated tests 8

Other tests reaching this symbol 32

ReferencedTableLookupTest calls
TableContextBuilderTest calls
SqliteCteShadowComposerTest calls
MatchExpressionRewriterTest calls
SqliteFullTextSearchRewriterTest calls
SqliteIndexHintStripperTest calls
SqliteQueryGuardTest calls
SqliteRewriterTest calls
StatementRewriterTest calls
DeleteTransformerTest calls
InsertProjectionBuilderTest calls
InsertTransformerTest calls
SelectTransformerTest calls
SqliteTransformerTest calls
UpdateTransformerTest calls
SqliteViewShadowRendererTest calls
ColumnDefinitionParserTest calls
TableDefinitionBuilderTest calls
VirtualTableParserTest calls
SqliteSchemaParserTest calls
SqliteSchemaReflectorTest calls
SqliteViewDefinitionParserTest calls
AddColumnResolverTest calls
InsertMutationResolverTest calls
RowMutationResolverTest calls
TableMutationResolverTest calls
SqliteMutationResolverTest calls
SqliteSelectRelationParserTest::testIdentifierComponentRejectsMismatchedTokenKind calls
SqliteParserTest calls
StatementStructureTest calls
TargetTableParserTest calls
SqliteSessionFactoryTest calls

Relations§

Instantiated in 5

Method calls 5