classRowMaterializer

packages/sql-fixture/src/Fixture/Generation/RowMaterializer.php:20

final class RowMaterializer

Walks the relations needed to materialize one connected fixture group.

Methods§

public function __construct(
    private SchemaResolverInterface $schemas,
    private RowGeneration $generator,
    private Generator $faker,
)

source §

Uses one schema registry, row generator and random source for the walk.

Parameters

`$schemas`	`SchemaResolverInterface`
`$generator`	`RowGeneration`
`$faker`	`Generator`

public function materialize(
    FixturePlan $plan,
    string $table,
    array<mixed> $inherited,
    int $count,
    bool $isList,
    ?Relation $arrivedBy,
    GenerationRun $run,
    list<string> $path = [],
): void

source §

Parameters

`$plan`	`FixturePlan`
`$table`	`string`
`$inherited`	`array<mixed>`	Columns already fixed by the relation walked in on
`$count`	`int`
`$isList`	`bool`
`$arrivedBy`	`?Relation`
`$run`	`GenerationRun`
`$path`	`list<string>`

Throws

RecursiveRelationException

Test cases 2

Called from 3

Calls 8

function-call in_array line 48
function-call count line 48
function-call array_keys line 48
new RecursiveRelationException line 49
method-call GenerationRun::reached() line 52
method-call SchemaResolverInterface::resolve() line 54
method-call GenerationRun::specFor() line 55
method-call RowMaterializer::materializeRow() line 58

public function materializeParent(
    FixturePlan $plan,
    string $table,
    bool $isList,
    Relation $arrivedBy,
    GenerationRun $run,
    list<string> $path = [],
    array<mixed> $inherited = [],
): array<string, mixed>

source §

Generate the single row a relation points at.

Parameters

`$plan`	`FixturePlan`
`$table`	`string`
`$isList`	`bool`
`$arrivedBy`	`Relation`
`$run`	`GenerationRun`
`$path`	`list<string>`
`$inherited`	`array<mixed>`

Returns

array<string, mixed>

Test cases 1

RowMaterializerTest::testMaterializeParentDoesNotWalkBackAlongTheArrivalRelation calls

Called from 1

method-call SqlFixture\Fixture\Generation\RowMaterializer::toParent() packages/sql-fixture/src/Fixture/Generation/RowMaterializer.php:166

Calls 2

method-call RowMaterializer::materialize() line 77
method-call GenerationRun::lastRow() line 79

public function materializeRow(
    FixturePlan $plan,
    TableSchema $schema,
    array<mixed> $inherited,
    RowSpec $spec,
    int $index,
    bool $isList,
    ?Relation $arrivedBy,
    GenerationRun $run,
    list<string> $path = [],
): void

source §

Parameters

`$plan`	`FixturePlan`
`$schema`	`TableSchema`
`$inherited`	`array<mixed>`
`$spec`	`RowSpec`
`$index`	`int`
`$isList`	`bool`
`$arrivedBy`	`?Relation`
`$run`	`GenerationRun`
`$path`	`list<string>`

Test cases 1

RowMaterializerTest::testMaterializeRowPreservesExplicitKeys calls

Called from 1

method-call SqlFixture\Fixture\Generation\RowMaterializer::materialize() packages/sql-fixture/src/Fixture/Generation/RowMaterializer.php:58

Calls 13

method-call RowSpec::overridesFor() line 97
method-call RowChoices::resolve() line 98
new RowChoices line 98
method-call RowBindings::merge() line 101
new RowBindings line 101
method-call InverseRelations::unique() line 110
new InverseRelations line 110
method-call RowMaterializer::toParent() line 115
method-call GenerationRun::record() line 118
method-call RowGeneration::generate() line 120
method-call RelationProjection::referencedColumns() line 121
new RelationProjection line 121
method-call RowMaterializer::toChildren() line 129

public function toParent(
    FixturePlan $plan,
    Relation $relation,
    array<mixed> $overrides,
    bool $isList,
    GenerationRun $run,
    list<string> $path = [],
): array<string, mixed>

source §

Generate the one row this one references and read the linking columns off it.

Where the caller has already fixed every linking column they have said what the row references, so no parent is invented to contradict them.

Parameters

`$plan`	`FixturePlan`
`$relation`	`Relation`
`$overrides`	`array<mixed>`
`$isList`	`bool`
`$run`	`GenerationRun`
`$path`	`list<string>`

Returns

array<string, mixed>

Test cases 1

RowMaterializerTest::testToParentProjectsGeneratedKeys calls

Called from 1

method-call SqlFixture\Fixture\Generation\RowMaterializer::materializeRow() packages/sql-fixture/src/Fixture/Generation/RowMaterializer.php:115

Calls 9

method-call RelationProjection::isAlreadyLinked() line 152
new RelationProjection line 152
method-call Relation::parentIsOptional() line 156
method-call GenerationRun::wasAskedFor() line 156
method-call Relation::parent() line 156
method-call Relation::columnMap() line 161
function-call array_key_exists line 162
method-call RowMaterializer::materializeParent() line 166
method-call RelationProjection::project() line 168

public function toChildren(
    FixturePlan $plan,
    Relation $relation,
    array<string, mixed> $row,
    bool $isList,
    GenerationRun $run,
    list<string> $path = [],
): void

source §

Parameters

`$plan`	`FixturePlan`
`$relation`	`Relation`
`$row`	`array<string, mixed>`
`$isList`	`bool`
`$run`	`GenerationRun`
`$path`	`list<string>`

Test cases 1

RowMaterializerTest::testToChildrenCopiesTheExistingParentKey calls

Called from 1

method-call SqlFixture\Fixture\Generation\RowMaterializer::materializeRow() packages/sql-fixture/src/Fixture/Generation/RowMaterializer.php:129

Calls 8

method-call Relation::child() line 183
method-call RowMaterializer::materialize() line 185
method-call RelationProjection::project() line 188
new RelationProjection line 188
method-call RelationCounts::resolveCount() line 189
new RelationCounts line 189
method-call GenerationRun::specFor() line 189
method-call Relation::childIsCollection() line 190

Private surface 3§

Implementation details, listed for orientation only.

private SchemaResolverInterface $schemas

private RowGeneration $generator

private Generator $faker

Test cases 11§

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

Dedicated tests 6

Other tests reaching this symbol 5

Relations§

Instantiated in 1

new SqlFixture\Fixture\PlanGenerator::generate() packages/sql-fixture/src/Fixture/PlanGenerator.php:55

Method calls 1

method-call SqlFixture\Fixture\PlanGenerator::generate() packages/sql-fixture/src/Fixture/PlanGenerator.php:55