packages/deriver/tests/Unit/Deriver/Evaluator/Execution/Call/Preparation/ModesTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Evaluator\Execution\Call\Preparation;
6
7use Deriver\Deriver\Contributions;
8use Deriver\Deriver\DeriverConfig;
9use Deriver\Deriver\Evaluator\Call\BoundInstruction;
10use Deriver\Deriver\Evaluator\Call\Evaluators;
11use Deriver\Deriver\Evaluator\Call\Extensions;
12use Deriver\Deriver\Evaluator\Call\Registrations;
13use Deriver\Deriver\Evaluator\Call\StateRegistry;
14use Deriver\Deriver\Evaluator\EvaluatorConfig;
15use Deriver\Deriver\Evaluator\Evidence\Frontier;
16use Deriver\Deriver\Evaluator\Execution\Call\ArgumentBinding;
17use Deriver\Deriver\Evaluator\Execution\Call\PassedArgument;
18use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Modes;
19use Deriver\Deriver\Evaluator\Execution\Call\Preparation\Target;
20use Deriver\Deriver\Evaluator\Execution\Completion\Completion;
21use Deriver\Deriver\Evaluator\Execution\Context;
22use Deriver\Deriver\Evaluator\Execution\Evaluator;
23use Deriver\Deriver\Evaluator\Execution\EvaluatorConfig as ExecutionEvaluatorConfig;
24use Deriver\Deriver\Evaluator\Execution\Memory\Memory;
25use Deriver\Deriver\Evaluator\Execution\State;
26use Deriver\Deriver\Evaluator\Request\Budget;
27use Deriver\Deriver\Evaluator\Request\QueryScope;
28use Deriver\Deriver\Evaluator\Request\ReturnQuery;
29use Deriver\Deriver\Evaluator\TargetProfile;
30use Deriver\Deriver\Evaluator\Term;
31use Deriver\Deriver\Execution\QueryExecution;
32use Deriver\Deriver\Lowerer\Declaration\CallableIdentity;
33use Deriver\Deriver\Lowerer\Declaration\CallableSource;
34use Deriver\Deriver\Lowerer\Declaration\Index;
35use Deriver\Deriver\Lowerer\Declaration\Indexer;
36use Deriver\Deriver\Lowerer\Declaration\Traits\Composition;
37use Deriver\Deriver\Lowerer\ExpressionLowering;
38use Deriver\Deriver\Lowerer\Graph\Argument;
39use Deriver\Deriver\Lowerer\Graph\BasicBlock;
40use Deriver\Deriver\Lowerer\Graph\CallableGraph;
41use Deriver\Deriver\Lowerer\Graph\Instruction;
42use Deriver\Deriver\Lowerer\Graph\Parameter;
43use Deriver\Deriver\Lowerer\Graph\Terminator;
44use Deriver\Deriver\Lowerer\InstructionEmitter;
45use Deriver\Deriver\Lowerer\Lowerer;
46use Deriver\Deriver\Lowerer\LoweringScope;
47use Deriver\Deriver\Lowerer\StatementLowering;
48use Deriver\Deriver\MicroEvaluatorConversion;
49use Deriver\Deriver\Parser\Node\File;
50use Deriver\Deriver\Parser\Parser;
51use Deriver\Deriver\Parser\ParserConfig;
52use Deriver\Deriver\Parser\TargetSyntax;
53use Deriver\Deriver\Providers\ProviderExpansion;
54use Deriver\Deriver\Resolver\AssignmentPatterns;
55use Deriver\Deriver\Resolver\ClassScope;
56use Deriver\Deriver\Resolver\ExpressionValidation;
57use Deriver\Deriver\Resolver\MagicContext;
58use Deriver\Deriver\Resolver\Resolver;
59use Deriver\Deriver\SnapshotIdentity;
60use Deriver\Deriver\Sources\LineMap;
61use Deriver\Deriver\Sources\Path;
62use Deriver\Deriver\Sources\Source;
63use Deriver\Deriver\Sources\SourceRef;
64use Deriver\Deriver\Sources\Sources;
65use Deriver\Exception\ParserException;
66use Deriver\Exception\ResolutionException;
67use PHPUnit\Framework\Attributes\CoversClass;
68use PHPUnit\Framework\Attributes\Small;
69use PHPUnit\Framework\Attributes\UsesClass;
70use PHPUnit\Framework\TestCase;
71
72/**
73 * @covers \Deriver\Deriver\Evaluator\Execution\Call\Preparation\Modes
74 */
75#[UsesClass(Resolver::class)]
76#[UsesClass(ExpressionValidation::class)]
77#[UsesClass(ResolutionException::class)]
78#[UsesClass(ParserConfig::class)]
79#[UsesClass(ParserException::class)]
80#[CoversClass(Modes::class)]
81#[UsesClass(Argument::class)]
82#[UsesClass(BasicBlock::class)]
83#[UsesClass(CallableGraph::class)]
84#[UsesClass(CallableIdentity::class)]
85#[UsesClass(Instruction::class)]
86#[UsesClass(Parameter::class)]
87#[UsesClass(Terminator::class)]
88#[UsesClass(ArgumentBinding::class)]
89#[UsesClass(PassedArgument::class)]
90#[UsesClass(Target::class)]
91#[UsesClass(Completion::class)]
92#[UsesClass(Context::class)]
93#[UsesClass(Evaluator::class)]
94#[UsesClass(State::class)]
95#[UsesClass(Memory::class)]
96#[UsesClass(Extensions::class)]
97#[UsesClass(Evaluators::class)]
98#[UsesClass(StateRegistry::class)]
99#[UsesClass(DeriverConfig::class)]
100#[UsesClass(Sources::class)]
101#[UsesClass(Path::class)]
102#[UsesClass(Source::class)]
103#[UsesClass(TargetProfile::class)]
104#[UsesClass(Budget::class)]
105#[UsesClass(QueryScope::class)]
106#[UsesClass(ReturnQuery::class)]
107#[UsesClass(SourceRef::class)]
108#[UsesClass(Frontier::class)]
109#[UsesClass(Parser::class)]
110#[UsesClass(File::class)]
111#[UsesClass(Lowerer::class)]
112#[UsesClass(ExpressionLowering::class)]
113#[UsesClass(InstructionEmitter::class)]
114#[UsesClass(LoweringScope::class)]
115#[UsesClass(StatementLowering::class)]
116#[UsesClass(CallableSource::class)]
117#[UsesClass(Indexer::class)]
118#[UsesClass(Index::class)]
119#[UsesClass(Composition::class)]
120#[UsesClass(LineMap::class)]
121#[UsesClass(MagicContext::class)]
122#[UsesClass(AssignmentPatterns::class)]
123#[UsesClass(ClassScope::class)]
124#[UsesClass(TargetSyntax::class)]
125#[UsesClass(Term::class)]
126#[Small]
127final class ModesTest extends TestCase
128{
129    public function testPositionCountsExpandedPositionalArgumentsAndRetainsUnknownUnpack(): void
130    {
131        $source = '<?php function target(){return 1;}';
132        $budget = new Budget();
133        $configuration = new DeriverConfig();
134        $contributions = new Contributions();
135        $input = new Sources([new Source('fixture.php', $source)]);
136        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
137        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
138        $contributions1 = $providers->contributions;
139        $evaluators = new Evaluators(new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision), new Registrations($contributions1->evaluators, $contributions1->providers, $contributions1->domains, $contributions1->intrinsics, $contributions1->stateSlots), $configuration->standardEvaluators);
140        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
141        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
142        $snapshotId = $identity->id;
143        $input1 = $providers->input;
144        $parser = new Parser(new ParserConfig($target->version));
145        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input1, false));
146        $program1 = new Index($snapshotId, $trees);
147        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
148        $snapshotId1 = 'test';
149        $input2 = new Sources([new Source('fixture.php', $source)]);
150        $profile = $execution->configuration->target;
151        $parser1 = new Parser(new ParserConfig($profile->version));
152        $trees1 = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser1->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input2, false));
153        $program = new Index($snapshotId1, $trees1);
154        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
155        $body = $context->program->callable('target');
156        self::assertNotNull($body);
157        $machine = new Evaluator($context);
158        $state = new State();
159        $instruction = new BoundInstruction('arg', 'argument', $body->source, 'result', ['prepared', 'input']);
160        $state->registers['array'] = Term::fromNative([1, 2]);
161        $call = new BoundInstruction('arg', 'argument', $body->source, 'result', arguments: [new Argument('array', unpack: true)]);
162        $modes = new Modes($machine);
163        self::assertSame(2, $modes->position($call, $state));
164        $state->registers['array'] = Term::opaque('unknown', 'array');
165        self::assertNull($modes->position($call, $state));
166    }
167    public function testSelectResolvesNamedAndVariadicReferenceParameters(): void
168    {
169        $source = '<?php function target(){return 1;}';
170        $budget = new Budget();
171        $configuration = new DeriverConfig();
172        $contributions = new Contributions();
173        $input = new Sources([new Source('fixture.php', $source)]);
174        $target1 = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
175        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
176        $contributions1 = $providers->contributions;
177        $evaluators = new Evaluators(new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision), new Registrations($contributions1->evaluators, $contributions1->providers, $contributions1->domains, $contributions1->intrinsics, $contributions1->stateSlots), $configuration->standardEvaluators);
178        $settings = new EvaluatorConfig($target1, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
179        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
180        $snapshotId = $identity->id;
181        $input1 = $providers->input;
182        $parser = new Parser(new ParserConfig($target1->version));
183        $trees = array_map(static fn (Source $source1): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source1->path), $source1->contents, $source1->declarationsOnly))), iterator_to_array($input1, false));
184        $program1 = new Index($snapshotId, $trees);
185        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target1, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
186        $snapshotId1 = 'test';
187        $input2 = new Sources([new Source('fixture.php', $source)]);
188        $profile = $execution->configuration->target;
189        $parser1 = new Parser(new ParserConfig($profile->version));
190        $trees1 = array_map(static fn (Source $source2): File => (new Resolver())->resolve($parser1->parse(new Source(Path::normalize($source2->path), $source2->contents, $source2->declarationsOnly))), iterator_to_array($input2, false));
191        $program = new Index($snapshotId1, $trees1);
192        $context = new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators);
193        $body = $context->program->callable('target');
194        self::assertNotNull($body);
195        $machine = new Evaluator($context);
196        $state = new State();
197        $instruction = new BoundInstruction('arg', 'argument', $body->source, 'result', ['prepared', 'input']);
198        $modes = new Modes($machine);
199        $signature = new CallableGraph('consume', [new Parameter('value'), new Parameter('refs', byReference: true, variadic: true)], [], $body->source);
200        $target = new Target($signature);
201        self::assertFalse($modes->select($target, 0, null));
202        self::assertTrue($modes->select($target, 2, null));
203        self::assertTrue($modes->select($target, 0, 'refs'));
204        self::assertTrue($modes->select($target, 0, 'extra'));
205        self::assertNull($modes->select($target, null, null));
206        self::assertNull($modes->select(new Target(), 0, null));
207    }
208}
209