Issues (36)

src/bridge/ProcessorInterface.php (1 issue)

Labels
Severity
1
<?php
2
3
/*
4
 * This file is part of the doyo/code-coverage project.
5
 *
6
 * (c) Anthonius Munthi <https://itstoni.com>
7
 *
8
 * For the full copyright and license information, please view the LICENSE
9
 * file that was distributed with this source code.
10
 */
11
12
declare(strict_types=1);
13
14
namespace Doyo\Bridge\CodeCoverage;
15
16
use SebastianBergmann\CodeCoverage\CodeCoverage;
0 ignored issues
show
This use statement conflicts with another class in this namespace, Doyo\Bridge\CodeCoverage\CodeCoverage. Consider defining an alias.

Let?s assume that you have a directory layout like this:

.
|-- OtherDir
|   |-- Bar.php
|   `-- Foo.php
`-- SomeDir
    `-- Foo.php

and let?s assume the following content of Bar.php:

// Bar.php
namespace OtherDir;

use SomeDir\Foo; // This now conflicts the class OtherDir\Foo

If both files OtherDir/Foo.php and SomeDir/Foo.php are loaded in the same runtime, you will see a PHP error such as the following:

PHP Fatal error:  Cannot use SomeDir\Foo as Foo because the name is already in use in OtherDir/Foo.php

However, as OtherDir/Foo.php does not necessarily have to be loaded and the error is only triggered if it is loaded before OtherDir/Bar.php, this problem might go unnoticed for a while. In order to prevent this error from surfacing, you must import the namespace with a different alias:

// Bar.php
namespace OtherDir;

use SomeDir\Foo as SomeDirFoo; // There is no conflict anymore.
Loading history...
17
18
interface ProcessorInterface
19
{
20
    /**
21
     * Set current test case for code coverage.
22
     *
23
     * @param TestCase $testCase
24
     */
25
    public function setCurrentTestCase(TestCase $testCase);
26
27
    /**
28
     * Get current test case for code coverage.
29
     *
30
     * @return TestCase:null
31
     */
32
    public function getCurrentTestCase();
33
34
    /**
35
     * @return CodeCoverage
36
     */
37
    public function getCodeCoverage();
38
39
    /**
40
     * Add test case.
41
     *
42
     * @param TestCase $testCase
43
     */
44
    public function addTestCase(TestCase $testCase);
45
46
    /**
47
     * Merge code coverage from another processor.
48
     *
49
     * @param ProcessorInterface|CodeCoverage $processor
50
     */
51
    public function merge($processor);
52
53
    /**
54
     * @param TestCase $testCase
55
     */
56
    public function start(TestCase $testCase);
57
58
    /**
59
     * @param bool  $append
60
     * @param array $linesToBeCovered
61
     * @param array $linesToBeUsed
62
     * @param bool  $ignoreForceCoversAnnotation
63
     *
64
     * @return array
65
     */
66
    public function stop(bool $append = true, $linesToBeCovered = [], array $linesToBeUsed = [], bool $ignoreForceCoversAnnotation = false): array;
67
68
    /**
69
     * Complete code coverage collecting process.
70
     */
71
    public function complete();
72
73
    /**
74
     * Clear code coverage.
75
     */
76
    public function clear();
77
}
78