Completed
Pull Request — master (#149)
by Enrico
04:04
created

Context::setCurrentBranch()   A

Complexity

Conditions 1
Paths 1

Size

Total Lines 4
Code Lines 2

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 3
CRAP Score 1

Importance

Changes 0
Metric Value
cc 1
eloc 2
c 0
b 0
f 0
nc 1
nop 1
dl 0
loc 4
ccs 3
cts 3
cp 1
crap 1
rs 10
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 801
    public function __construct(OutputInterface $output, Application $application, EventManager $eventManager)
72
    {
73 801
        $this->output = $output;
74 801
        $this->application = $application;
75
76 801
        $this->initGlobals();
77 801
        $this->eventManager = $eventManager;
78 801
    }
79
80
    /**
81
     * @return Expression
82
     */
83 793
    public function getExpressionCompiler()
84
    {
85 793
        return new Expression($this, $this->eventManager);
86
    }
87
88
    /**
89
     * Adds all global variables to the context.
90
     */
91 801
    public function initGlobals()
92
    {
93
        /**
94
         * http://php.net/manual/language.variables.superglobals.php
95
         */
96 801
        $this->addVariable(new GlobalVariable('GLOBALS', [], CompiledExpression::ARR));
97 801
        $this->addVariable(new GlobalVariable('_SERVER', [], CompiledExpression::ARR));
98 801
        $this->addVariable(new GlobalVariable('_GET', [], CompiledExpression::ARR));
99 801
        $this->addVariable(new GlobalVariable('_POST', [], CompiledExpression::ARR));
100 801
        $this->addVariable(new GlobalVariable('_FILES', [], CompiledExpression::ARR));
101 801
        $this->addVariable(new GlobalVariable('_COOKIE', [], CompiledExpression::ARR));
102 801
        $this->addVariable(new GlobalVariable('_SESSION', [], CompiledExpression::ARR));
103 801
        $this->addVariable(new GlobalVariable('_REQUEST', [], CompiledExpression::ARR));
104 801
        $this->addVariable(new GlobalVariable('_ENV', [], CompiledExpression::ARR));
105 801
    }
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 1
    public function addSymbol($name)
114
    {
115 1
        $variable = new Variable($name);
116 1
        $this->symbols[$name] = $variable;
117
118 1
        return $variable;
119
    }
120
121
    /**
122
     * Adds a variable to the context.
123
     *
124
     * @param Variable $variable
125
     * @return bool
126
     */
127 801
    public function addVariable(Variable $variable)
128
    {
129 801
        $this->symbols[$variable->getName()] = $variable;
130
131 801
        return true;
132
    }
133
134
    /**
135
     * Resets context to beginning stage.
136
     */
137 25
    public function clear()
138
    {
139 25
        $this->symbols = [];
140 25
        $this->scope = null;
141 25
        $this->scopePointer = null;
142 25
        $this->currentBranch = null;
143 25
        $this->aliasManager = null;
144
145 25
        $this->initGlobals();
146 25
    }
147
148
    /**
149
     * Clears only all symbols.
150
     */
151 24
    public function clearSymbols()
152
    {
153 24
        unset($this->symbols);
154 24
        $this->symbols = [];
155 24
    }
156
157
    /**
158
     * Returns a variable if it exists.
159
     *
160
     * @param $name
161
     * @return Variable|null
162
     */
163 69
    public function getSymbol($name)
164
    {
165 69
        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 3
    public function warning($type, $message)
176
    {
177 3
        $this->output
178 3
            ->writeln('<comment>Warning:  ' . $message . ' in ' . $this->filepath . '  [' . $type . ']</comment>');
179
180 3
        $this->output->writeln('');
181
182 3
        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 25
    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 25
        $filepath = $this->filepath;
197 25
        $code = file($filepath);
198
199 25
        $this->output->writeln('<comment>Notice:  ' . $message . " in {$filepath} on {$expr->getLine()} [{$type}]</comment>");
200 25
        $this->output->writeln('');
201
202 25
        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 25
            $code = trim($code[$expr->getLine() - 1]);
211 25
            $this->output->writeln("<comment>\t {$code} </comment>");
212
        }
213
214 25
        $this->output->writeln('');
215
216 25
        $this->application->getIssuesCollector()
217 25
            ->addIssue($type, $message, basename($this->filepath), $expr->getLine() - 1);
218
219 25
        return true;
220
    }
221
222
    /**
223
     * Creates a syntax error message.
224
     *
225
     * @param \PhpParser\Error $exception
226
     * @param string $filepath
227
     * @return bool
228
     */
229
    public function syntaxError(\PhpParser\Error $exception, $filepath)
230
    {
231
        $code = file($filepath);
232
233
        $this->output->writeln('<error>Syntax error:  ' . $exception->getMessage() . " in {$filepath} </error>");
234
        $this->output->writeln('');
235
236
        $this->application->getIssuesCollector()
237
            ->addIssue('syntax-error', 'syntax-error', $filepath, $exception->getStartLine() - 2);
238
239
        $code = trim($code[$exception->getStartLine()-2]);
240
        $this->output->writeln("<comment>\t {$code} </comment>");
241
242
        return true;
243
    }
244
245
    /**
246
     * Returns an array of all variables.
247
     *
248
     * @return Variable[]
249
     */
250 24
    public function getSymbols()
251
    {
252 24
        return $this->symbols;
253
    }
254
255
    /**
256
     * @param AbstractDefinition $scope
257
     */
258 801
    public function setScope(AbstractDefinition $scope = null)
259
    {
260 801
        $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...
261 801
    }
262
263
    /**
264
     * Creates a debug message.
265
     */
266 25
    public function debug($message, \PhpParser\Node $expr = null)
267
    {
268 25
        if ($this->output->isDebug()) {
269
            $this->output->writeln('[DEBUG] ' . $message);
270
            $this->output->write($this->filepath);
271
272
            if ($expr) {
273
                $this->output->write(':' . $expr->getLine());
274
            }
275
276
            $this->output->writeln('');
277
        }
278 25
    }
279
280
    /**
281
     * @return string
282
     */
283
    public function getFilepath()
284
    {
285
        return $this->filepath;
286
    }
287
288
    /**
289
     * @param string $filepath
290
     */
291 25
    public function setFilepath($filepath)
292
    {
293 25
        $this->filepath = $filepath;
294 25
    }
295
296
    /**
297
     * @return integer
298
     */
299 26
    public function getCurrentBranch()
300
    {
301 26
        return $this->currentBranch;
302
    }
303
304
    /**
305
     * @param int|string $currentBranch
306
     */
307 4
    public function setCurrentBranch($currentBranch)
308
    {
309 4
        $this->currentBranch = $currentBranch;
310 4
    }
311
312
    /**
313
     * Updates all references on the given variable.
314
     *
315
     * @param Variable $variable
316
     * @param $type
317
     * @param $value
318
     */
319 3
    public function modifyReferencedVariables(Variable $variable, $type, $value)
320
    {
321 3
        foreach ($this->symbols as $symbol) {
322 3
            $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...
323 3
            if ($referencedTo) {
324 2
                if ($referencedTo === $variable) {
325 2
                    $symbol->modify($type, $value);
326 2
                }
327 2
            }
328 3
        }
329 3
    }
330
331
    /**
332
     * @return EventManager
333
     */
334 38
    public function getEventManager()
335
    {
336 38
        return $this->eventManager;
337
    }
338
}
339