packages/deriver/tests/Unit/Deriver/Selection/SelectorResolutionTest.php

1<?php
2
3declare (strict_types=1);
4
5namespace Tests\Unit\Deriver\Selection;
6
7use Deriver\Deriver\Contributions;
8use Deriver\Deriver\DeriverConfig;
9use Deriver\Deriver\Evaluator\Call\Evaluators;
10use Deriver\Deriver\Evaluator\Call\Registrations;
11use Deriver\Deriver\Evaluator\EvaluatorConfig;
12use Deriver\Deriver\Evaluator\Evidence\Frontier;
13use Deriver\Deriver\Evaluator\Index\DefinitionIndex;
14use Deriver\Deriver\Evaluator\Request\ParameterQuery;
15use Deriver\Deriver\Evaluator\Request\ReturnQuery;
16use Deriver\Deriver\Evaluator\TargetProfile;
17use Deriver\Deriver\Evaluator\Term;
18use Deriver\Deriver\Lowerer\Declaration\Index;
19use Deriver\Deriver\MicroEvaluatorConversion;
20use Deriver\Deriver\Parser\Node\File;
21use Deriver\Deriver\Parser\Parser;
22use Deriver\Deriver\Parser\ParserConfig;
23use Deriver\Deriver\Providers\ProviderExpansion;
24use Deriver\Deriver\Publication\CandidateQuery;
25use Deriver\Deriver\Query;
26use Deriver\Deriver\Resolver\Resolver;
27use Deriver\Deriver\Selection\SelectorResolution;
28use Deriver\Deriver\SnapshotIdentity;
29use Deriver\Deriver\Sources\Path;
30use Deriver\Deriver\Sources\Source;
31use Deriver\Deriver\Sources\Sources;
32use Deriver\Exception\InvalidInputException;
33use PHPUnit\Framework\Attributes\CoversNothing;
34use PHPUnit\Framework\Attributes\DataProvider;
35use PHPUnit\Framework\TestCase;
36
37#[CoversNothing]
38final class SelectorResolutionTest extends TestCase
39{
40    public function testResolveBindsSymbolSelectors(): void
41    {
42        $prepared1Input = new Sources([new Source('a.php', '<?php function f($id){return $id;}')]);
43        $prepared1Configuration = new DeriverConfig();
44        $prepared1Contributions = new Contributions();
45        $prepared1Target = new TargetProfile($prepared1Configuration->phpVersion, $prepared1Configuration->integerBits, $prepared1Configuration->floatPrecision);
46        $prepared1Providers = new ProviderExpansion($prepared1Input, array_map(Term::fromNative(...), $prepared1Configuration->environment), $prepared1Contributions);
47        $contributions = $prepared1Providers->contributions;
48        $prepared1Evaluators = new Evaluators(new TargetProfile($prepared1Configuration->phpVersion, $prepared1Configuration->integerBits, $prepared1Configuration->floatPrecision), new Registrations($contributions->evaluators, $contributions->providers, $contributions->domains, $contributions->intrinsics, $contributions->stateSlots), $prepared1Configuration->standardEvaluators);
49        $prepared1Settings = new EvaluatorConfig($prepared1Target, $prepared1Providers->environment, $prepared1Configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $prepared1Configuration->evaluators));
50        $prepared1Identity = new SnapshotIdentity($prepared1Providers->input, $prepared1Settings, $prepared1Evaluators, $prepared1Providers->manifest);
51        $snapshotId = $prepared1Identity->id;
52        $input = $prepared1Providers->input;
53        $parser = new Parser(new ParserConfig($prepared1Target->version));
54        $trees = array_map(static fn (Source $source): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source->path), $source->contents, $source->declarationsOnly))), iterator_to_array($input, false));
55        $prepared1Program = new Index($snapshotId, $trees);
56        $prepared1Snapshot = $prepared1Identity->snapshot(array_map(Frontier::fromDiagnostic(...), $prepared1Program->diagnostics()));
57        $session = new CandidateQuery(new DefinitionIndex($prepared1Program), $prepared1Settings, $prepared1Evaluators, $prepared1Snapshot);
58        $resolver = new SelectorResolution($prepared1Program);
59        self::assertEquals(new ReturnQuery('f'), $resolver->resolve(Query::parse('f#return')));
60        self::assertEquals(new ParameterQuery('f', 'id'), $resolver->resolve(Query::parse('f#parameter(id)')));
61    }
62    public function testCallAtSelectsAnExactCallAmongCallsOnTheSameLine(): void
63    {
64        $prepared2Input = new Sources([new Source('a.php', '<?php sink(1); sink(2);')]);
65        $prepared2Configuration = new DeriverConfig();
66        $prepared2Contributions = new Contributions();
67        $prepared2Target = new TargetProfile($prepared2Configuration->phpVersion, $prepared2Configuration->integerBits, $prepared2Configuration->floatPrecision);
68        $prepared2Providers = new ProviderExpansion($prepared2Input, array_map(Term::fromNative(...), $prepared2Configuration->environment), $prepared2Contributions);
69        $contributions = $prepared2Providers->contributions;
70        $prepared2Evaluators = new Evaluators(new TargetProfile($prepared2Configuration->phpVersion, $prepared2Configuration->integerBits, $prepared2Configuration->floatPrecision), new Registrations($contributions->evaluators, $contributions->providers, $contributions->domains, $contributions->intrinsics, $contributions->stateSlots), $prepared2Configuration->standardEvaluators);
71        $prepared2Settings = new EvaluatorConfig($prepared2Target, $prepared2Providers->environment, $prepared2Configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $prepared2Configuration->evaluators));
72        $prepared2Identity = new SnapshotIdentity($prepared2Providers->input, $prepared2Settings, $prepared2Evaluators, $prepared2Providers->manifest);
73        $snapshotId = $prepared2Identity->id;
74        $input = $prepared2Providers->input;
75        $parser = new Parser(new ParserConfig($prepared2Target->version));
76        $trees = array_map(static fn (Source $source): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source->path), $source->contents, $source->declarationsOnly))), iterator_to_array($input, false));
77        $prepared2Program = new Index($snapshotId, $trees);
78        $prepared2Snapshot = $prepared2Identity->snapshot(array_map(Frontier::fromDiagnostic(...), $prepared2Program->diagnostics()));
79        $session = new CandidateQuery(new DefinitionIndex($prepared2Program), $prepared2Settings, $prepared2Evaluators, $prepared2Snapshot);
80        $call = (new SelectorResolution($prepared2Program))->callAt(Query::parse('a.php:1:16#argument(0)'));
81        self::assertSame(15, $call->source->start);
82        self::assertSame('sink', $call->target);
83    }
84    #[DataProvider('providerInvalidSelections')]
85    public function testResolveRejectsUnsupportedOrMissingTargets(string $query): void
86    {
87        $prepared3Input = new Sources([new Source('a.php', '<?php function f($id){return $id;} sink(1);')]);
88        $prepared3Configuration = new DeriverConfig();
89        $prepared3Contributions = new Contributions();
90        $prepared3Target = new TargetProfile($prepared3Configuration->phpVersion, $prepared3Configuration->integerBits, $prepared3Configuration->floatPrecision);
91        $prepared3Providers = new ProviderExpansion($prepared3Input, array_map(Term::fromNative(...), $prepared3Configuration->environment), $prepared3Contributions);
92        $contributions = $prepared3Providers->contributions;
93        $prepared3Evaluators = new Evaluators(new TargetProfile($prepared3Configuration->phpVersion, $prepared3Configuration->integerBits, $prepared3Configuration->floatPrecision), new Registrations($contributions->evaluators, $contributions->providers, $contributions->domains, $contributions->intrinsics, $contributions->stateSlots), $prepared3Configuration->standardEvaluators);
94        $prepared3Settings = new EvaluatorConfig($prepared3Target, $prepared3Providers->environment, $prepared3Configuration->standardEvaluators, array_map((new MicroEvaluatorConversion())->convert(...), $prepared3Configuration->evaluators));
95        $prepared3Identity = new SnapshotIdentity($prepared3Providers->input, $prepared3Settings, $prepared3Evaluators, $prepared3Providers->manifest);
96        $snapshotId = $prepared3Identity->id;
97        $input = $prepared3Providers->input;
98        $parser = new Parser(new ParserConfig($prepared3Target->version));
99        $trees = array_map(static fn (Source $source): File => (new Resolver())->resolve($parser->parse(new Source(Path::normalize($source->path), $source->contents, $source->declarationsOnly))), iterator_to_array($input, false));
100        $prepared3Program = new Index($snapshotId, $trees);
101        $prepared3Snapshot = $prepared3Identity->snapshot(array_map(Frontier::fromDiagnostic(...), $prepared3Program->diagnostics()));
102        $session = new CandidateQuery(new DefinitionIndex($prepared3Program), $prepared3Settings, $prepared3Evaluators, $prepared3Snapshot);
103        $this->expectException(InvalidInputException::class);
104        (new SelectorResolution($prepared3Program))->resolve(Query::parse($query));
105    }
106    /**
107     * @return iterable<string, array{string}>
108     */
109    public static function providerInvalidSelections(): iterable
110    {
111        foreach (['missing#return', 'f#return(id)', 'f#parameter', 'f#parameter(0)', 'f#parameter(id,extra)', 'f#unknown', 'f#argument(0)', 'a.php:1:1#return', 'a.php:1:1#argument', 'a.php:1:1#argument(0)', 'missing.php:1:34#argument(0)', 'a.php:1:36#argument(1)'] as $query) {
112            yield $query => [$query];
113        }
114    }
115}
116