Completed
Pull Request — master (#251)
by
unknown
11:10
created

Context   A

Complexity

Total Complexity 29

Size/Duplication

Total Lines 342
Duplicated Lines 0 %

Coupling/Cohesion

Components 3
Dependencies 12

Test Coverage

Coverage 74.22%

Importance

Changes 0
Metric Value
dl 0
loc 342
ccs 95
cts 128
cp 0.7422
rs 10
c 0
b 0
f 0
wmc 29
lcom 3
cbo 12

20 Methods

Rating   Name   Duplication   Size   Complexity  
A initGlobals() 0 15 1
A clear() 0 10 1
A clearSymbols() 0 5 1
A warning() 0 9 1
A __construct() 0 8 1
A getExpressionCompiler() 0 4 1
A addVariable() 0 6 1
A getSymbol() 0 4 2
B notice() 0 36 4
B syntaxError() 0 24 1
A getSymbols() 0 4 1
A setScope() 0 4 1
A debug() 0 13 3
A getFilepath() 0 4 1
A setFilepath() 0 4 1
A getCurrentBranch() 0 4 1
A setCurrentBranch() 0 4 1
A modifyReferencedVariables() 0 11 4
A getEventManager() 0 4 1
A addSymbol() 0 7 1
1
<?php
2
/**
3
 * @author Patsura Dmitry https://github.com/ovr <[email protected]>
4
 */
5
6
namespace PHPSA;
7
8
use PHPSA\Compiler\Expression;
9
use PHPSA\Compiler\GlobalVariable;
10
use PHPSA\Definition\AbstractDefinition;
11
use PHPSA\Definition\ParentDefinition;
12
use Symfony\Component\Console\Output\OutputInterface;
13
use Webiny\Component\EventManager\EventManager;
14
15
class Context
16
{
17
    /**
18
     * For FunctionDefinition it's null, use scopePointer
19
     *
20
     * @var ParentDefinition|null
21
     */
22
    public $scope;
23
24
    /**
25
     * @var AliasManager
26
     */
27
    public $aliasManager;
28
29
    /**
30
     * @var Application
31
     */
32
    public $application;
33
34
    /**
35
     * @var string|integer
36
     */
37
    public $currentBranch;
38
39
    /**
40
     * @var OutputInterface
41
     */
42
    public $output;
43
44
    /**
45
     * @var Variable[]
46
     */
47
    protected $symbols = [];
48
49
    /**
50
     * @var ScopePointer|null
51
     */
52
    public $scopePointer;
53
54
    /**
55
     * @var string
56
     */
57
    protected $filepath;
58
59
    /**
60
     * @var EventManager
61
     */
62
    protected $eventManager;
63
64
    /**
65
     * Construct our Context with all needed information
66
     *
67
     * @param OutputInterface $output
68
     * @param Application $application
69
     * @param EventManager $eventManager
70
     */
71 870
    public function __construct(OutputInterface $output, Application $application, EventManager $eventManager)
72
    {
73 870
        $this->output = $output;
74 870
        $this->application = $application;
75
76 870
        $this->initGlobals();
77 870
        $this->eventManager = $eventManager;
78 870
    }
79
80
    /**
81
     * @return Expression
82
     */
83 862
    public function getExpressionCompiler()
84
    {
85 862
        return new Expression($this, $this->eventManager);
86
    }
87
88
    /**
89
     * Adds all global variables to the context.
90
     */
91 870
    public function initGlobals()
92
    {
93
        /**
94
         * http://php.net/manual/language.variables.superglobals.php
95
         */
96 870
        $this->addVariable(new GlobalVariable('GLOBALS', [], CompiledExpression::ARR));
97 870
        $this->addVariable(new GlobalVariable('_SERVER', [], CompiledExpression::ARR));
98 870
        $this->addVariable(new GlobalVariable('_GET', [], CompiledExpression::ARR));
99 870
        $this->addVariable(new GlobalVariable('_POST', [], CompiledExpression::ARR));
100 870
        $this->addVariable(new GlobalVariable('_FILES', [], CompiledExpression::ARR));
101 870
        $this->addVariable(new GlobalVariable('_COOKIE', [], CompiledExpression::ARR));
102 870
        $this->addVariable(new GlobalVariable('_SESSION', [], CompiledExpression::ARR));
103 870
        $this->addVariable(new GlobalVariable('_REQUEST', [], CompiledExpression::ARR));
104 870
        $this->addVariable(new GlobalVariable('_ENV', [], CompiledExpression::ARR));
105 870
    }
106
107
    /**
108
     * Creates a variable from a symbol and adds it to the context.
109
     *
110
     * @param string $name
111
     * @return Variable
112
     */
113 3
    public function addSymbol($name)
114
    {
115 3
        $variable = new Variable($name);
116 3
        $this->symbols[$name] = $variable;
117
118 3
        return $variable;
119 1
    }
120
121
    /**
122
     * Adds a variable to the context.
123
     *
124
     * @param Variable $variable
125
     * @return bool
126
     */
127 870
    public function addVariable(Variable $variable)
128
    {
129 870
        $this->symbols[$variable->getName()] = $variable;
130
131 870
        return true;
132
    }
133
134
    /**
135
     * Resets context to beginning stage.
136
     */
137 43
    public function clear()
138
    {
139 43
        $this->symbols = [];
140 43
        $this->scope = null;
141 43
        $this->scopePointer = null;
142 43
        $this->currentBranch = null;
143 43
        $this->aliasManager = null;
144
145 43
        $this->initGlobals();
146 43
    }
147
148
    /**
149
     * Clears only all symbols.
150
     */
151 40
    public function clearSymbols()
152
    {
153 40
        unset($this->symbols);
154 40
        $this->symbols = [];
155 40
    }
156
157
    /**
158
     * Returns a variable if it exists.
159
     *
160
     * @param $name
161
     * @return Variable|null
162
     */
163 80
    public function getSymbol($name)
164
    {
165 80
        return isset($this->symbols[$name]) ? $this->symbols[$name] : null;
166
    }
167
168
    /**
169
     * Creates a warning message.
170
     *
171
     * @param string $type
172
     * @param string $message
173
     * @return bool
174
     */
175 10
    public function warning($type, $message)
176
    {
177 10
        $this->output
178 10
            ->writeln('<comment>Warning:  ' . $message . ' in ' . $this->filepath . '  [' . $type . ']</comment>');
179
180 10
        $this->output->writeln('');
181
182 10
        return true;
183
    }
184
185
    /**
186
     * Creates a notice message.
187
     *
188
     * @param string $type
189
     * @param string $message
190
     * @param \PhpParser\NodeAbstract $expr
191
     * @param int $status
192
     * @return bool
193
     */
194 43
    public function notice($type, $message, \PhpParser\NodeAbstract $expr, $status = Check::CHECK_SAFE)
0 ignored issues
show
Unused Code introduced by
The parameter $status is not used and could be removed.

This check looks from parameters that have been defined for a function or method, but which are not used in the method body.

Loading history...
195
    {
196 43
        $filepath = $this->filepath;
197 43
        $code = file($filepath);
198
199 43
        $this->output->writeln('<comment>Notice:  ' . $message . " in {$filepath} on {$expr->getLine()} [{$type}]</comment>");
200 43
        $this->output->writeln('');
201
202 43
        if ($this->application->getConfiguration()->valueIsTrue('blame')) {
203
            exec("git blame --show-email -L {$expr->getLine()},{$expr->getLine()} " . $filepath, $result);
204
            if ($result && isset($result[0])) {
205
                $result[0] = trim($result[0]);
206
207
                $this->output->writeln("<comment>\t {$result[0]}</comment>");
208
            }
209
        } else {
210 43
            $code = trim($code[$expr->getLine() - 1]);
211 43
            $this->output->writeln("<comment>\t {$code} </comment>");
212
        }
213
214 43
        $this->output->writeln('');
215
216 43
        $issueCollector = $this->application->getIssuesCollector();
217 43
        $issueCollector->addIssue(
218 43
            new Issue(
219 43
                $type,
220 43
                $message,
221 43
                new IssueLocation(
222 43
                    $this->filepath,
223 43
                    $expr->getLine() - 1
224 43
                )
225 43
            )
226 43
        );
227
228 43
        return true;
229
    }
230
231
    /**
232
     * Creates a syntax error message.
233
     *
234
     * @param \PhpParser\Error $exception
235
     * @param string $filepath
236
     * @return bool
237
     */
238
    public function syntaxError(\PhpParser\Error $exception, $filepath)
239
    {
240
        $code = file($filepath);
241
242
        $this->output->writeln('<error>Syntax error:  ' . $exception->getMessage() . " in {$filepath} </error>");
243
        $this->output->writeln('');
244
245
        $issueCollector = $this->application->getIssuesCollector();
246
        $issueCollector->addIssue(
247
            new Issue(
248
                'syntax-error',
249
                'syntax-error',
250
                new IssueLocation(
251
                    $filepath,
252
                    $exception->getStartLine() - 2
253
                )
254
            )
255
        );
256
257
        $code = trim($code[$exception->getStartLine()-2]);
258
        $this->output->writeln("<comment>\t {$code} </comment>");
259
260
        return true;
261
    }
262
263
    /**
264
     * Returns an array of all variables.
265
     *
266
     * @return Variable[]
267
     */
268 40
    public function getSymbols()
269
    {
270 40
        return $this->symbols;
271
    }
272
273
    /**
274
     * @param AbstractDefinition $scope
275
     */
276 870
    public function setScope(AbstractDefinition $scope = null)
277
    {
278 870
        $this->scope = $scope;
0 ignored issues
show
Documentation Bug introduced by
It seems like $scope can also be of type object<PHPSA\Definition\AbstractDefinition>. However, the property $scope is declared as type object<PHPSA\Definition\ParentDefinition>|null. Maybe add an additional type check?

Our type inference engine has found a suspicous assignment of a value to a property. This check raises an issue when a value that can be of a mixed type is assigned to a property that is type hinted more strictly.

For example, imagine you have a variable $accountId that can either hold an Id object or false (if there is no account id yet). Your code now assigns that value to the id property of an instance of the Account class. This class holds a proper account, so the id value must no longer be false.

Either this assignment is in error or a type check should be added for that assignment.

class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}
Loading history...
279 870
    }
280
281
    /**
282
     * Creates a debug message.
283
     */
284 43
    public function debug($message, \PhpParser\Node $expr = null)
285
    {
286 43
        if ($this->output->isDebug()) {
287
            $this->output->writeln('[DEBUG] ' . $message);
288
            $this->output->write($this->filepath);
289
290
            if ($expr) {
291
                $this->output->write(':' . $expr->getLine());
292
            }
293
294
            $this->output->writeln('');
295
        }
296 43
    }
297
298
    /**
299
     * @return string
300
     */
301
    public function getFilepath()
302
    {
303
        return $this->filepath;
304
    }
305
306
    /**
307
     * @param string $filepath
308
     */
309 43
    public function setFilepath($filepath)
310
    {
311 43
        $this->filepath = $filepath;
312 43
    }
313
314
    /**
315
     * @return integer
316
     */
317 37
    public function getCurrentBranch()
318
    {
319 37
        return $this->currentBranch;
320
    }
321
322
    /**
323
     * @param int|string $currentBranch
324
     */
325 9
    public function setCurrentBranch($currentBranch)
326
    {
327 9
        $this->currentBranch = $currentBranch;
328 9
    }
329
330
    /**
331
     * Updates all references on the given variable.
332
     *
333
     * @param Variable $variable
334
     * @param $type
335
     * @param $value
336
     */
337 5
    public function modifyReferencedVariables(Variable $variable, $type, $value)
338
    {
339 5
        foreach ($this->symbols as $symbol) {
340 5
            $referencedTo = $symbol->getReferencedTo();
0 ignored issues
show
Bug introduced by
Are you sure the assignment to $referencedTo is correct as $symbol->getReferencedTo() (which targets PHPSA\Variable::getReferencedTo()) seems to always return null.

This check looks for function or method calls that always return null and whose return value is assigned to a variable.

class A
{
    function getObject()
    {
        return null;
    }

}

$a = new A();
$object = $a->getObject();

The method getObject() can return nothing but null, so it makes no sense to assign that value to a variable.

The reason is most likely that a function or method is imcomplete or has been reduced for debug purposes.

Loading history...
341 5
            if ($referencedTo) {
342 2
                if ($referencedTo === $variable) {
343 2
                    $symbol->modify($type, $value);
344 2
                }
345 2
            }
346 5
        }
347 5
    }
348
349
    /**
350
     * @return EventManager
351
     */
352 808
    public function getEventManager()
353
    {
354 808
        return $this->eventManager;
355
    }
356
}
357