TAssertions::assertNotCount() - Code Metrics - Inspection of "BC break: forbidden passing string to parameter $v..." - konecnyjakub/mytester - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( cdf2d7...d7ebd0 )

by Jakub

created 2024-08-02 11:01 UTC

TAssertions::assertNotCount() A

↳ Parent: TAssertions

Complexity

Conditions	2
Paths	2

Size

Total Lines	6
Code Lines	4

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	4
CRAP Score	2

Importance

Changes	5
Bugs	0	Features	1

Metric	Value
cc	2
eloc	4
c	5
b	0
f	1
nc	2
nop	2
dl	0
loc	6
ccs	4
cts	4
cp	1
crap	2
rs	10

<?php
declare(strict_types=1);

namespace MyTester;

trait TAssertions
{
    /** @internal */
    protected int $taskCount = 0;

    /**
     * Prints result of a test
     *
     * @internal
     */
    protected function testResult(string $text, bool $success = true): void
    {
        $this->incCounter();
        if ($success) {
            return;
        }
        echo "Test $this->taskCount failed. $text\n";
    }

    /**
     * Increases task counter
     *
     * @internal
     */
    protected function incCounter(): void
    {
        $this->taskCount++;
    }

    /**
     * Resets task counter
     *
     * @internal
     */
    protected function resetCounter(): void
    {
        $this->taskCount = 0;
    }

    /**
     * @internal
     */
    protected function getCounter(): int
    {
        return $this->taskCount;
    }

    protected function showStringOrArray(string|array $variable): string
    {
        return (is_string($variable) ? "'$variable'" : var_export($variable, true));
    }

    /**
     * Tries an assertion
     */
    protected function assert(mixed $code, string $failureText = ""): void
    {
        $success = ($code == true);
        $message = "";
        if (!$code) {
            $message = ($failureText === "") ? "The assertion is not true." : $failureText;
        }
        $this->testResult($message, $success);
    }

    /**
     * Are both values same?
     */
    protected function assertSame(mixed $expected, mixed $actual): void
    {
        $success = ($expected == $actual);
        $message = ($success) ? "" : "The value is not '$expected' but '$actual'.";
        $this->testResult($message, $success);
    }

    /**
     * Are not both values same?
     */
    protected function assertNotSame(mixed $expected, mixed $actual): void
    {
        $success = ($expected !== $actual);
        $message = ($success) ? "" : "The value is '$expected'.";
        $this->testResult($message, $success);
    }

    /**
     * Is $actual greater than $expected?
     */
    protected function assertGreaterThan(int|float $expected, int|float $actual): void
    {
        $success = ($actual > $expected);
        $message = ($success) ? "" : "$actual is not greater than $expected.";
        $this->testResult($message, $success);
    }

    /**
     * Is $actual less than $expected?
     */
    protected function assertLessThan(int|float $expected, int|float $actual): void
    {
        $success = ($actual < $expected);
        $message = ($success) ? "" : "$actual is not less than $expected.";
        $this->testResult($message, $success);
    }

    /**
     * Is $actual equal to true?
     */
    protected function assertTrue(bool $actual): void
    {
        $success = ($actual);
        $message = ($success) ? "" : "The value is not true.";
        $this->testResult($message, $success);
    }

    /**
     * Is the expression true?
     */
    protected function assertTruthy(mixed $actual): void
    {
        $success = ($actual == true);
        $message = ($success) ? "" : "The expression is not true.";
        $this->testResult($message, $success);
    }

    /**
     * Is $actual equal to false?
     */
    protected function assertFalse(bool $actual): void
    {
        $success = (!$actual);
        $message = ($success) ? "" : "The value is not false.";
        $this->testResult($message, $success);
    }

    /**
     * Is the expression false?
     */
    protected function assertFalsey(mixed $actual): void
    {
        $success = ($actual == false);
        $message = ($success) ? "" : "The expression is not false.";
        $this->testResult($message, $success);
    }

    /**
     * Is the value null?
     */
    protected function assertNull(mixed $actual): void
    {
        $success = ($actual == null);
        $message = ($success) ? "" : "The value is not null.";
        $this->testResult($message, $success);
    }

    /**
     * Is not the value null?
     */
    protected function assertNotNull(mixed $actual): void
    {
        $success = ($actual !== null);
        $message = ($success) ? "" : "The value is null.";
        $this->testResult($message, $success);
    }

    /**
     * Does $actual contain $needle?
     */
    protected function assertContains(string|array $needle, string|array $actual): void
    {
        if (is_string($actual) && is_string($needle)) {
            $success = ($needle !== "" && str_contains($actual, $needle));
            $message = ($success) ? "" : "$needle is not in the variable.";
            $this->testResult($message, $success);
        } elseif (is_array($actual)) {
            $success = (in_array($needle, $actual));
            $message = ($success) ? "" : $this->showStringOrArray($needle) . " is not in the variable.";
            $this->testResult($message, $success);
        } else {
            $this->testResult($this->showStringOrArray($needle) . " is not in the variable.", false);
        }
    }

    /**
     * Does $actual not contain $needle?
     */
    protected function assertNotContains(string|array $needle, string|array $actual): void
    {
        if (is_string($actual) && is_string($needle)) {
            $success = ($needle === "" || !str_contains($actual, $needle));
            $message = ($success) ? "" : "$needle is in the variable.";
            $this->testResult($message, $success);
        } elseif (is_array($actual)) {
            $success = (!in_array($needle, $actual));
            $message = ($success) ? "" : $this->showStringOrArray($needle) . " is in the variable.";
            $this->testResult($message, $success);
        } else {
            $this->testResult($this->showStringOrArray($needle) . " is not in the variable.", false);
        }
    }

    /**
     * Does $value contain $count items?
     */
    protected function assertCount(int $count, array|\Countable $value): void
    {
        $actual = count($value);
        $success = ($actual === $count);
        $message = ($success) ? "" : "Count of the variable is $actual.";
        $this->testResult($message, $success);
    }

    /**
     * Does $value not contain $count items?
     */
    protected function assertNotCount(int $count, array|\Countable $value): void
    {
        $actual = count($value);
        $success = ($actual !== $count);
        $message = ($success) ? "" : "Count of the variable is $actual.";
        $this->testResult($message, $success);
    }

    /**
     * Is $value of type $type?
     */
    protected function assertType(string|object $type, mixed $value): void
    {
        if (
            in_array($type, [
            "array", "bool", "float", "int", "string", "null", "object", "resource",
            "scalar", "iterable", "callable",
            ], true)
        ) {
            $success = (call_user_func("is_$type", $value));
            $actual = gettype($value);
            $message = ($success) ? "" : "The variable is $actual.";
            $this->testResult($message, $success);
            return;
        }
        $success = ($value instanceof $type);
        $actual = get_debug_type($value);
        $message = ($success) ? "" : "The variable is instance of $actual.";
        $this->testResult($message, $success);
    }

    /**
     * Does the code throw the expected exception?
     *
     * @param class-string $className
     */
    protected function assertThrowsException(
        callable $callback,
        string $className,
        string $message = null,
        int $code = null
    ): void {
        $success = false;
        $errorMessage = "";
        $e = null;
        try {
            $callback();
        } catch (\Throwable $e) {
            if ($e instanceof $className) {
                if (
                    ($message === null || $e->getMessage() === $message) && ($code === null || $e->getCode() === $code)
                ) {
                    $success = true;
                }
            }
        }
        if (!$success) {
            if ($e === null) {
                $errorMessage = "The code does not throw any exception.";
            } elseif (!$e instanceof $className) {
                $errorMessage = "The code does not throw $className but " . get_class($e) . ".";
            } elseif ($message !== null && $message !== $e->getMessage()) {
                $errorMessage =
                    "The code does not throw an exception with message '$message' but '{$e->getMessage()}'.";
            } elseif ($code !== null && $code !== $e->getCode()) {
                $errorMessage = "The code does not throw an exception with code $code but {$e->getCode()}.";
            }
        }
        $this->testResult($errorMessage, $success);
    }

    /**
     * Is output of code $expected?
     */
    protected function assertOutput(callable $callback, string $expected): void
    {
        ob_start();
        $callback();
        /** @var string $output */
        $output = ob_get_clean();
        $success = ($expected == $output);
        $message = ($success) ? "" : "Output of code  is not '$expected' but '$output'.";
        $this->testResult($message, $success);
    }

    /**
     * Does $actual matches regular expression $expected?
     */
    protected function assertMatchesRegExp(string $expected, string $actual): void
    {
        $success = (preg_match($expected, $actual) === 1);
        $message = ($success) ? "" : "The string does not match regular expression.";
        $this->testResult($message, $success);
    }

    /**
     * Is $actual an array consisting only of instances of $className
     *
     * @param class-string $className
     */
    protected function assertArrayOfClass(string $className, array $actual): void
    {
        if (count($actual) === 0) {
            $this->testResult("The array is empty.", false);
            return;
        }
        $success = array_all($actual, function (mixed $value) use ($className) {
            return $value instanceof $className;
        });
        $message = ($success) ? "" : "The array does not contain only instances of $className.";
        $this->testResult($message, $success);
    }
}


1		<?php
2		declare(strict_types=1);
3
4		namespace MyTester;
5
6		trait TAssertions
7		{
8		/** @internal */
9		protected int $taskCount = 0;
10
11		/**
12		* Prints result of a test
13		*
14		* @internal
15		*/
16		protected function testResult(string $text, bool $success = true): void
17		{
18	1	$this->incCounter();
19	1	if ($success) {
20	1	return;
21		}
22	1	echo "Test $this->taskCount failed. $text\n";
23		}
24
25		/**
26		* Increases task counter
27		*
28		* @internal
29		*/
30		protected function incCounter(): void
31		{
32	1	$this->taskCount++;
33		}
34
35		/**
36		* Resets task counter
37		*
38		* @internal
39		*/
40		protected function resetCounter(): void
41		{
42	1	$this->taskCount = 0;
43		}
44
45		/**
46		* @internal
47		*/
48		protected function getCounter(): int
49		{
50	1	return $this->taskCount;
51		}
52
53		protected function showStringOrArray(string\|array $variable): string
54		{
55	1	return (is_string($variable) ? "'$variable'" : var_export($variable, true));
56		}
57
58		/**
59		* Tries an assertion
60		*/
61		protected function assert(mixed $code, string $failureText = ""): void
62		{
63	1	$success = ($code == true);
64	1	$message = "";
65	1	if (!$code) {
66	1	$message = ($failureText === "") ? "The assertion is not true." : $failureText;
67		}
68	1	$this->testResult($message, $success);
69		}
70
71		/**
72		* Are both values same?
73		*/
74		protected function assertSame(mixed $expected, mixed $actual): void
75		{
76	1	$success = ($expected == $actual);
77	1	$message = ($success) ? "" : "The value is not '$expected' but '$actual'.";
78	1	$this->testResult($message, $success);
79		}
80
81		/**
82		* Are not both values same?
83		*/
84		protected function assertNotSame(mixed $expected, mixed $actual): void
85		{
86	1	$success = ($expected !== $actual);
87	1	$message = ($success) ? "" : "The value is '$expected'.";
88	1	$this->testResult($message, $success);
89		}
90
91		/**
92		* Is $actual greater than $expected?
93		*/
94		protected function assertGreaterThan(int\|float $expected, int\|float $actual): void
95		{
96	1	$success = ($actual > $expected);
97	1	$message = ($success) ? "" : "$actual is not greater than $expected.";
98	1	$this->testResult($message, $success);
99		}
100
101		/**
102		* Is $actual less than $expected?
103		*/
104		protected function assertLessThan(int\|float $expected, int\|float $actual): void
105		{
106	1	$success = ($actual < $expected);
107	1	$message = ($success) ? "" : "$actual is not less than $expected.";
108	1	$this->testResult($message, $success);
109		}
110
111		/**
112		* Is $actual equal to true?
113		*/
114		protected function assertTrue(bool $actual): void
115		{
116	1	$success = ($actual);
117	1	$message = ($success) ? "" : "The value is not true.";
118	1	$this->testResult($message, $success);
119		}
120
121		/**
122		* Is the expression true?
123		*/
124		protected function assertTruthy(mixed $actual): void
125		{
126	1	$success = ($actual == true);
127	1	$message = ($success) ? "" : "The expression is not true.";
128	1	$this->testResult($message, $success);
129		}
130
131		/**
132		* Is $actual equal to false?
133		*/
134		protected function assertFalse(bool $actual): void
135		{
136	1	$success = (!$actual);
137	1	$message = ($success) ? "" : "The value is not false.";
138	1	$this->testResult($message, $success);
139		}
140
141		/**
142		* Is the expression false?
143		*/
144		protected function assertFalsey(mixed $actual): void
145		{
146	1	$success = ($actual == false);
147	1	$message = ($success) ? "" : "The expression is not false.";
148	1	$this->testResult($message, $success);
149		}
150
151		/**
152		* Is the value null?
153		*/
154		protected function assertNull(mixed $actual): void
155		{
156	1	$success = ($actual == null);
157	1	$message = ($success) ? "" : "The value is not null.";
158	1	$this->testResult($message, $success);
159		}
160
161		/**
162		* Is not the value null?
163		*/
164		protected function assertNotNull(mixed $actual): void
165		{
166	1	$success = ($actual !== null);
167	1	$message = ($success) ? "" : "The value is null.";
168	1	$this->testResult($message, $success);
169		}
170
171		/**
172		* Does $actual contain $needle?
173		*/
174		protected function assertContains(string\|array $needle, string\|array $actual): void
175		{
176	1	if (is_string($actual) && is_string($needle)) {
177	1	$success = ($needle !== "" && str_contains($actual, $needle));
178	1	$message = ($success) ? "" : "$needle is not in the variable.";
179	1	$this->testResult($message, $success);
180	1	} elseif (is_array($actual)) {
181	1	$success = (in_array($needle, $actual));
182	1	$message = ($success) ? "" : $this->showStringOrArray($needle) . " is not in the variable.";
183	1	$this->testResult($message, $success);
184		} else {
185	1	$this->testResult($this->showStringOrArray($needle) . " is not in the variable.", false);
186		}
187		}
188
189		/**
190		* Does $actual not contain $needle?
191		*/
192		protected function assertNotContains(string\|array $needle, string\|array $actual): void
193		{
194	1	if (is_string($actual) && is_string($needle)) {
195	1	$success = ($needle === "" \|\| !str_contains($actual, $needle));
196	1	$message = ($success) ? "" : "$needle is in the variable.";
197	1	$this->testResult($message, $success);
198	1	} elseif (is_array($actual)) {
199	1	$success = (!in_array($needle, $actual));
200	1	$message = ($success) ? "" : $this->showStringOrArray($needle) . " is in the variable.";
201	1	$this->testResult($message, $success);
202		} else {
203	1	$this->testResult($this->showStringOrArray($needle) . " is not in the variable.", false);
204		}
205		}
206
207		/**
208		* Does $value contain $count items?
209		*/
210		protected function assertCount(int $count, array\|\Countable $value): void
211		{
212	1	$actual = count($value);
213	1	$success = ($actual === $count);
214	1	$message = ($success) ? "" : "Count of the variable is $actual.";
215	1	$this->testResult($message, $success);
216		}
217
218		/**
219		* Does $value not contain $count items?
220		*/
221		protected function assertNotCount(int $count, array\|\Countable $value): void
222		{
223	1	$actual = count($value);
224	1	$success = ($actual !== $count);
225	1	$message = ($success) ? "" : "Count of the variable is $actual.";
226	1	$this->testResult($message, $success);
227		}
228
229		/**
230		* Is $value of type $type?
231		*/
232		protected function assertType(string\|object $type, mixed $value): void
233		{
234		if (
235	1	in_array($type, [
236	1	"array", "bool", "float", "int", "string", "null", "object", "resource",
237	1	"scalar", "iterable", "callable",
238	1	], true)
239		) {
240	1	$success = (call_user_func("is_$type", $value));
241	1	$actual = gettype($value);
242	1	$message = ($success) ? "" : "The variable is $actual.";
243	1	$this->testResult($message, $success);
244	1	return;
245		}
246	1	$success = ($value instanceof $type);
247	1	$actual = get_debug_type($value);
248	1	$message = ($success) ? "" : "The variable is instance of $actual.";
249	1	$this->testResult($message, $success);
250		}
251
252		/**
253		* Does the code throw the expected exception?
254		*
255		* @param class-string $className
256		*/
257		protected function assertThrowsException(
258		callable $callback,
259		string $className,
260		string $message = null,
261		int $code = null
262		): void {
263	1	$success = false;
264	1	$errorMessage = "";
265	1	$e = null;
266		try {
267	1	$callback();
268	1	} catch (\Throwable $e) {
269	1	if ($e instanceof $className) {
270		if (
271	1	($message === null \|\| $e->getMessage() === $message) && ($code === null \|\| $e->getCode() === $code)
272		) {
273	1	$success = true;
274		}
275		}
276		}
277	1	if (!$success) {
278	1	if ($e === null) {
279	1	$errorMessage = "The code does not throw any exception.";
280	1	} elseif (!$e instanceof $className) {
281	1	$errorMessage = "The code does not throw $className but " . get_class($e) . ".";
282	1	} elseif ($message !== null && $message !== $e->getMessage()) {
283	1	$errorMessage =
284	1	"The code does not throw an exception with message '$message' but '{$e->getMessage()}'.";
285	1	} elseif ($code !== null && $code !== $e->getCode()) {
286	1	$errorMessage = "The code does not throw an exception with code $code but {$e->getCode()}.";
287		}
288		}
289	1	$this->testResult($errorMessage, $success);
290		}
291
292		/**
293		* Is output of code $expected?
294		*/
295		protected function assertOutput(callable $callback, string $expected): void
296		{
297	1	ob_start();
298	1	$callback();
299		/** @var string $output */
300	1	$output = ob_get_clean();
301	1	$success = ($expected == $output);
302	1	$message = ($success) ? "" : "Output of code is not '$expected' but '$output'.";
303	1	$this->testResult($message, $success);
304		}
305
306		/**
307		* Does $actual matches regular expression $expected?
308		*/
309		protected function assertMatchesRegExp(string $expected, string $actual): void
310		{
311	1	$success = (preg_match($expected, $actual) === 1);
312	1	$message = ($success) ? "" : "The string does not match regular expression.";
313	1	$this->testResult($message, $success);
314		}
315
316		/**
317		* Is $actual an array consisting only of instances of $className
318		*
319		* @param class-string $className
320		*/
321		protected function assertArrayOfClass(string $className, array $actual): void
322		{
323	1	if (count($actual) === 0) {
324	1	$this->testResult("The array is empty.", false);
325	1	return;
326		}
327	1	$success = array_all($actual, function (mixed $value) use ($className) {
328	1	return $value instanceof $className;
329	1	});
330	1	$message = ($success) ? "" : "The array does not contain only instances of $className.";
331	1	$this->testResult($message, $success);
332		}
333		}
334

konecnyjakub / mytester

Push — master ( cdf2d7...d7ebd0 )

TAssertions::assertNotCount() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like