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

PhanJsonResultsParser   A

Complexity

Total Complexity 8

Size/Duplication

Total Lines 93
Duplicated Lines 0 %

Importance

Changes 0
Metric Value
wmc 8
eloc 43
dl 0
loc 93
rs 10
c 0
b 0
f 0

5 Methods

Rating   Name   Duplication   Size   Complexity  
A showTypeGuessingWarning() 0 3 1
A convertFromArray() 0 19 3
A convertFromString() 0 9 2
A getIdentifier() 0 3 1
A convertAnalysisResultFromArray() 0 29 1
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\InvalidPathException;
16
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\LineNumber;
17
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\Location;
18
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\ProjectRoot;
19
use DaveLiddament\StaticAnalysisResultsBaseliner\Domain\Common\RelativeFileName;
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
    public function convertFromString(string $resultsAsString, ProjectRoot $projectRoot): AnalysisResults
46
    {
47
        try {
48
            $asArray = JsonUtils::toArray($resultsAsString);
49
        } catch (JsonParseException $e) {
50
            throw new InvalidFileFormatException('Not a valid JSON format');
51
        }
52
53
        return $this->convertFromArray($asArray, $projectRoot);
54
    }
55
56
    public function getIdentifier(): Identifier
57
    {
58
        return new PhanJsonIdentifier();
59
    }
60
61
    public function showTypeGuessingWarning(): bool
62
    {
63
        return false;
64
    }
65
66
    /**
67
     * Converts from an array.
68
     *
69
     * @psalm-param array<mixed> $analysisResultsAsArray
70
     *
71
     * @throws ParseAtLocationException
72
     */
73
    private function convertFromArray(array $analysisResultsAsArray, ProjectRoot $projectRoot): AnalysisResults
74
    {
75
        $analysisResultsBuilder = new AnalysisResultsBuilder();
76
77
        $resultsCount = 0;
78
79
        /** @psalm-suppress MixedAssignment */
80
        foreach ($analysisResultsAsArray as $analysisResultAsArray) {
81
            ++$resultsCount;
82
            try {
83
                ArrayUtils::assertArray($analysisResultAsArray);
84
                $analysisResult = $this->convertAnalysisResultFromArray($analysisResultAsArray, $projectRoot);
85
                $analysisResultsBuilder->addAnalysisResult($analysisResult);
86
            } catch (ArrayParseException | JsonParseException | InvalidPathException $e) {
87
                throw ParseAtLocationException::issueAtPosition($e, $resultsCount);
88
            }
89
        }
90
91
        return $analysisResultsBuilder->build();
92
    }
93
94
    /**
95
     * @psalm-param array<mixed> $analysisResultAsArray
96
     *
97
     * @throws ArrayParseException
98
     * @throws JsonParseException
99
     */
100
    private function convertAnalysisResultFromArray(array $analysisResultAsArray, ProjectRoot $projectRoot): AnalysisResult
101
    {
102
        $typeAsString = ArrayUtils::getStringValue($analysisResultAsArray, self::TYPE);
103
        $type = new Type($typeAsString);
104
105
        $message = ArrayUtils::getStringValue($analysisResultAsArray, self::MESSAGE);
106
107
        $locationArray = ArrayUtils::getArrayValue($analysisResultAsArray, self::LOCATION);
108
109
        // Hack. Phan does not return absolute path. We have to hope that code is in project root directory.
110
        $relativeFileNameAsString = ArrayUtils::getStringValue($locationArray, self::FILE_PATH);
111
        $relativeFileName = new RelativeFileName($relativeFileNameAsString);
112
113
        $absoluteFileName = $projectRoot->getAbsoluteFileName($relativeFileName);
114
115
        $linesArray = ArrayUtils::getArrayValue($locationArray, self::LINES);
116
        $lineAsInt = ArrayUtils::getIntValue($linesArray, self::LINE);
117
118
        $location = Location::fromAbsoluteFileName(
119
            $absoluteFileName,
120
            $projectRoot,
121
            new LineNumber($lineAsInt)
122
        );
123
124
        return new AnalysisResult(
125
            $location,
126
            $type,
127
            $message,
128
            JsonUtils::toString($analysisResultAsArray)
129
        );
130
    }
131
}
132