packages/deriver/tests/Unit/Deriver/Evaluator/Execution/Call/Native/SignaturesTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Evaluator\Execution\Call\Native;
6
7use Deriver\Deriver\Contributions;
8use Deriver\Deriver\DeriverConfig;
9use Deriver\Deriver\Evaluator\Call\Evaluators;
10use Deriver\Deriver\Evaluator\Call\Extensions;
11use Deriver\Deriver\Evaluator\Call\Registrations;
12use Deriver\Deriver\Evaluator\Call\StateRegistry;
13use Deriver\Deriver\Evaluator\EvaluatorConfig;
14use Deriver\Deriver\Evaluator\Evidence\Frontier;
15use Deriver\Deriver\Evaluator\Execution\Call\Native\Signatures;
16use Deriver\Deriver\Evaluator\Execution\Context;
17use Deriver\Deriver\Evaluator\Execution\EvaluatorConfig as ExecutionEvaluatorConfig;
18use Deriver\Deriver\Evaluator\Request\Budget;
19use Deriver\Deriver\Evaluator\Request\QueryScope;
20use Deriver\Deriver\Evaluator\Request\ReturnQuery;
21use Deriver\Deriver\Evaluator\TargetProfile;
22use Deriver\Deriver\Evaluator\Term;
23use Deriver\Deriver\Execution\QueryExecution;
24use Deriver\Deriver\Lowerer\Declaration\CallableIdentity;
25use Deriver\Deriver\Lowerer\Declaration\CallableSource;
26use Deriver\Deriver\Lowerer\Declaration\ConstantSignatures;
27use Deriver\Deriver\Lowerer\Declaration\Index;
28use Deriver\Deriver\Lowerer\Declaration\Indexer;
29use Deriver\Deriver\Lowerer\Declaration\Metadata\ClassDeclaration;
30use Deriver\Deriver\Lowerer\Declaration\Traits\Composition;
31use Deriver\Deriver\Lowerer\Graph\BasicBlock;
32use Deriver\Deriver\Lowerer\Graph\CallableGraph;
33use Deriver\Deriver\Lowerer\Graph\Instruction;
34use Deriver\Deriver\Lowerer\Graph\Parameter;
35use Deriver\Deriver\Lowerer\Graph\Terminator;
36use Deriver\Deriver\Lowerer\Hierarchy\Builtins;
37use Deriver\Deriver\Lowerer\Hierarchy\Dispatch;
38use Deriver\Deriver\MicroEvaluatorConversion;
39use Deriver\Deriver\Parser\Node\File;
40use Deriver\Deriver\Parser\Parser;
41use Deriver\Deriver\Parser\ParserConfig;
42use Deriver\Deriver\Parser\TargetSyntax;
43use Deriver\Deriver\Providers\ProviderExpansion;
44use Deriver\Deriver\Resolver\AssignmentPatterns;
45use Deriver\Deriver\Resolver\ClassScope;
46use Deriver\Deriver\Resolver\ExpressionValidation;
47use Deriver\Deriver\Resolver\MagicContext;
48use Deriver\Deriver\Resolver\Resolver;
49use Deriver\Deriver\SnapshotIdentity;
50use Deriver\Deriver\Sources\LineMap;
51use Deriver\Deriver\Sources\Path;
52use Deriver\Deriver\Sources\Source;
53use Deriver\Deriver\Sources\SourceRef;
54use Deriver\Deriver\Sources\Sources;
55use Deriver\Exception\ParserException;
56use Deriver\Exception\ResolutionException;
57use PHPUnit\Framework\Attributes\CoversClass;
58use PHPUnit\Framework\Attributes\Small;
59use PHPUnit\Framework\Attributes\UsesClass;
60use PHPUnit\Framework\TestCase;
61
62/**
63 * @covers \Deriver\Deriver\Evaluator\Execution\Call\Native\Signatures
64 */
65#[UsesClass(Resolver::class)]
66#[UsesClass(ExpressionValidation::class)]
67#[UsesClass(ResolutionException::class)]
68#[UsesClass(ParserConfig::class)]
69#[UsesClass(ParserException::class)]
70#[CoversClass(Signatures::class)]
71#[UsesClass(BasicBlock::class)]
72#[UsesClass(CallableGraph::class)]
73#[UsesClass(CallableIdentity::class)]
74#[UsesClass(ClassDeclaration::class)]
75#[UsesClass(Instruction::class)]
76#[UsesClass(Parameter::class)]
77#[UsesClass(Terminator::class)]
78#[UsesClass(Builtins::class)]
79#[UsesClass(Dispatch::class)]
80#[UsesClass(Context::class)]
81#[UsesClass(Extensions::class)]
82#[UsesClass(Evaluators::class)]
83#[UsesClass(StateRegistry::class)]
84#[UsesClass(DeriverConfig::class)]
85#[UsesClass(Sources::class)]
86#[UsesClass(Path::class)]
87#[UsesClass(Source::class)]
88#[UsesClass(TargetProfile::class)]
89#[UsesClass(Budget::class)]
90#[UsesClass(QueryScope::class)]
91#[UsesClass(ReturnQuery::class)]
92#[UsesClass(SourceRef::class)]
93#[UsesClass(Parser::class)]
94#[UsesClass(File::class)]
95#[UsesClass(ConstantSignatures::class)]
96#[UsesClass(CallableSource::class)]
97#[UsesClass(Indexer::class)]
98#[UsesClass(Index::class)]
99#[UsesClass(Composition::class)]
100#[UsesClass(LineMap::class)]
101#[UsesClass(MagicContext::class)]
102#[UsesClass(AssignmentPatterns::class)]
103#[UsesClass(ClassScope::class)]
104#[UsesClass(TargetSyntax::class)]
105#[UsesClass(Term::class)]
106#[Small]
107final class SignaturesTest extends TestCase
108{
109    public function testFamilyRecognizesInheritedNativeConstructors(): void
110    {
111        $source = '<?php class A extends ErrorException{}';
112        $budget = new Budget();
113        $configuration = new DeriverConfig();
114        $contributions = new Contributions();
115        $input = new Sources([new Source('fixture.php', $source)]);
116        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
117        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
118        $contributions1 = $providers->contributions;
119        $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);
120        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
121        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
122        $snapshotId = $identity->id;
123        $input1 = $providers->input;
124        $parser = new Parser(new ParserConfig($target->version));
125        $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));
126        $program1 = new Index($snapshotId, $trees);
127        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
128        $snapshotId1 = 'test';
129        $input2 = new Sources([new Source('fixture.php', $source)]);
130        $profile = $execution->configuration->target;
131        $parser1 = new Parser(new ParserConfig($profile->version));
132        $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));
133        $program = new Index($snapshotId1, $trees1);
134        $signatures = new Signatures((new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators))->program);
135        self::assertSame('ErrorException', $signatures->family('A'));
136        self::assertSame('Exception', $signatures->family('LogicException'));
137        self::assertSame('Error', $signatures->family('TypeError'));
138        self::assertSame('', $signatures->family('stdClass'));
139    }
140    public function testParametersIncludesErrorExceptionSpecificSlots(): void
141    {
142        $source = '<?php function target(){return 1;}';
143        $budget = new Budget();
144        $configuration = new DeriverConfig();
145        $contributions = new Contributions();
146        $input = new Sources([new Source('fixture.php', $source)]);
147        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
148        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
149        $contributions1 = $providers->contributions;
150        $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);
151        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
152        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
153        $snapshotId = $identity->id;
154        $input1 = $providers->input;
155        $parser = new Parser(new ParserConfig($target->version));
156        $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));
157        $program1 = new Index($snapshotId, $trees);
158        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
159        $snapshotId1 = 'test';
160        $input2 = new Sources([new Source('fixture.php', $source)]);
161        $profile = $execution->configuration->target;
162        $parser1 = new Parser(new ParserConfig($profile->version));
163        $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));
164        $program = new Index($snapshotId1, $trees1);
165        $signatures = new Signatures((new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators))->program);
166        self::assertSame(['string|null', null], $signatures->parameters('ErrorException')['filename']);
167        self::assertSame(['Throwable|null', null], $signatures->parameters('Exception')['previous']);
168    }
169    public function testGraphDisallowsSurplusNativeArguments(): void
170    {
171        $source = '<?php function target(){return 1;}';
172        $budget = new Budget();
173        $configuration = new DeriverConfig();
174        $contributions = new Contributions();
175        $input = new Sources([new Source('fixture.php', $source)]);
176        $target = new TargetProfile($configuration->phpVersion, $configuration->integerBits, $configuration->floatPrecision);
177        $providers = new ProviderExpansion($input, array_map(Term::fromNative(...), $configuration->environment), $contributions);
178        $contributions1 = $providers->contributions;
179        $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);
180        $settings = new EvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $configuration->evaluators));
181        $identity = new SnapshotIdentity($providers->input, $settings, $evaluators, $providers->manifest);
182        $snapshotId = $identity->id;
183        $input1 = $providers->input;
184        $parser = new Parser(new ParserConfig($target->version));
185        $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));
186        $program1 = new Index($snapshotId, $trees);
187        $execution = new QueryExecution($program1, new ExecutionEvaluatorConfig($target, $providers->environment, $configuration->standardEvaluators), $evaluators, $identity->snapshot(array_map(Frontier::fromDiagnostic(...), $program1->diagnostics())));
188        $snapshotId1 = 'test';
189        $input2 = new Sources([new Source('fixture.php', $source)]);
190        $profile = $execution->configuration->target;
191        $parser1 = new Parser(new ParserConfig($profile->version));
192        $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));
193        $program = new Index($snapshotId1, $trees1);
194        $signature = (new Signatures((new Context($program, new ReturnQuery('target', budget: $budget), $execution->configuration, $execution->evaluators))->program))->graph('Exception', '__construct', new SourceRef('s', 'x.php', 0, 1));
195        self::assertCount(3, $signature->parameters);
196        self::assertFalse($signature->allowExtraArguments);
197        self::assertSame('message', $signature->parameters[0]->name);
198        self::assertNotNull($signature->parameters[0]->default);
199    }
200}
201