Passed
Pull Request — master (#69)
by Dave
02:17
created

PhanJsonResultsParser::getIdentifier()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 3
Code Lines 1

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
cc 1
eloc 1
nc 1
nop 0
dl 0
loc 3
rs 10
c 0
b 0
f 0
1
<?php
2
3
/**
4
 * Static Analysis Results Baseliner (sarb).
5
 *
6
 * (c) Dave Liddament
7
 *
8
 * For the full copyright and licence information please view the LICENSE file distributed with this source code.
9
 */
10
11
declare(strict_types=1);
12
13
namespace DaveLiddament\StaticAnalysisResultsBaseliner\Plugins\ResultsParsers\PhanJsonResultsParser;
14
15
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\AbsoluteFileName;
16
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\InvalidPathException;
17
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\LineNumber;
18
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\Location;
19
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\ProjectRoot;
20
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\Type;
21
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\File\InvalidFileFormatException;
22
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\ResultsParser\AnalysisResult;
23
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\ResultsParser\AnalysisResults;
24
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\ResultsParser\AnalysisResultsBuilder;
25
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\ResultsParser\Identifier;
26
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\ResultsParser\ResultsParser;
27
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Utils\ArrayParseException;
28
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Utils\ArrayUtils;
29
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Utils\JsonParseException;
30
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Utils\JsonUtils;
31
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Utils\ParseAtLocationException;
32
33
/**
34
 * Handles Phan's JSON output.
35
 */
36
class PhanJsonResultsParser implements ResultsParser
37
{
38
    private const LOCATION = 'location';
39
    private const LINES = 'lines';
40
    private const LINE = 'begin';
41
    private const TYPE = 'check_name';
42
    private const MESSAGE = 'description';
43
    private const FILE_PATH = 'path';
44
45
    /**
46
     * {@inheritdoc}
47
     */
48
    public function convertFromString(string $resultsAsString, ProjectRoot $projectRoot): AnalysisResults
49
    {
50
        try {
51
            $asArray = JsonUtils::toArray($resultsAsString);
52
        } catch (JsonParseException $e) {
53
            throw new InvalidFileFormatException('Not a valid JSON format');
54
        }
55
56
        return $this->convertFromArray($asArray, $projectRoot);
57
    }
58
59
    /**
60
     * {@inheritdoc}
61
     */
62
    public function getIdentifier(): Identifier
63
    {
64
        return new PhanJsonIdentifier();
65
    }
66
67
    /**
68
     * {@inheritdoc}
69
     */
70
    public function showTypeGuessingWarning(): bool
71
    {
72
        return false;
73
    }
74
75
    /**
76
     * Converts from an array.
77
     *
78
     * @psalm-param array<mixed> $analysisResultsAsArray
79
     *
80
     * @throws ParseAtLocationException
81
     */
82
    private function convertFromArray(array $analysisResultsAsArray, ProjectRoot $projectRoot): AnalysisResults
83
    {
84
        $analysisResultsBuilder = new AnalysisResultsBuilder();
85
86
        $resultsCount = 0;
87
88
        /** @psalm-suppress MixedAssignment */
89
        foreach ($analysisResultsAsArray as $analysisResultAsArray) {
90
            ++$resultsCount;
91
            try {
92
                ArrayUtils::assertArray($analysisResultAsArray);
93
                $analysisResult = $this->convertAnalysisResultFromArray($analysisResultAsArray, $projectRoot);
94
                $analysisResultsBuilder->addAnalysisResult($analysisResult);
95
            } catch (ArrayParseException | JsonParseException | InvalidPathException $e) {
96
                throw ParseAtLocationException::issueAtPosition($e, $resultsCount);
97
            }
98
        }
99
100
        return $analysisResultsBuilder->build();
101
    }
102
103
    /**
104
     * @psalm-param array<mixed> $analysisResultAsArray
105
     *
106
     * @throws ArrayParseException
107
     * @throws JsonParseException
108
     */
109
    private function convertAnalysisResultFromArray(array $analysisResultAsArray, ProjectRoot $projectRoot): AnalysisResult
110
    {
111
        $typeAsString = ArrayUtils::getStringValue($analysisResultAsArray, self::TYPE);
112
        $type = new Type($typeAsString);
113
114
        $message = ArrayUtils::getStringValue($analysisResultAsArray, self::MESSAGE);
115
116
        $locationArray = ArrayUtils::getArrayValue($analysisResultAsArray, self::LOCATION);
117
        $fileNameAsString = ArrayUtils::getStringValue($locationArray, self::FILE_PATH);
118
        $absoluteFileName = $projectRoot->getFullPath($fileNameAsString);
119
120
        $linesArray = ArrayUtils::getArrayValue($locationArray, self::LINES);
121
        $lineAsInt = ArrayUtils::getIntValue($linesArray, self::LINE);
122
123
        $location = Location::fromAbsoluteFileName(
124
            new AbsoluteFileName($absoluteFileName),
125
            $projectRoot,
126
            new LineNumber($lineAsInt)
127
        );
128
129
        return new AnalysisResult(
130
            $location,
131
            $type,
132
            $message,
133
            JsonUtils::toString($analysisResultAsArray)
134
        );
135
    }
136
}
137