Refactor TestSize to enumeration

Author: sebastianbergmann

ChangeLog-14.0.md

@@ -16,6 +16,7 @@ All notable changes are documented in this file using the [Keep a CHANGELOG](htt
 * In addition to the above, the `process()` method of `SebastianBergmann\CodeCoverage\Report\Xml\Facade` requires the result of `SebastianBergmann\CodeCoverage\CodeCoverage::getTests()`
 * The format of the file written by `SebastianBergmann\CodeCoverage\Serialization\Serializer` is incompatible with the format of the file that was written by `SebastianBergmann\CodeCoverage\Report\PHP` in the past
 * The `<build>` element and its children of the XML report generated by `SebastianBergmann\CodeCoverage\Report\Xml\Facade` require the optional arguments to be passed to the `process()` method
+* The `TestSize` and `TestStatus` value objects are now enumerations
 
 ### Removed
 

phpstan.neon

@@ -52,7 +52,6 @@ parameters:
         # Ignore errors caused by defensive programming
         - '#Call to function assert\(\) with true will always evaluate to true.#'
         - '#Call to method .* will always evaluate to true.#'
-        - '#Call to method .* will always evaluate to false.#'
         - '#Instanceof between .* and .* will always evaluate to true.#'
         - '#SebastianBergmann\\CodeCoverage\\Node\\Iterator::current\(\) should be covariant with return type#'
 

src/CodeCoverage.php

@@ -23,7 +23,6 @@
 use SebastianBergmann\CodeCoverage\Test\Target\TargetCollection;
 use SebastianBergmann\CodeCoverage\Test\Target\TargetCollectionValidator;
 use SebastianBergmann\CodeCoverage\Test\Target\ValidationResult;
-use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
 
 /**
  * Provides collection functionality for PHP code coverage information.
@@ -203,7 +202,7 @@ public function append(RawCodeCoverageData $rawData, ?string $id = null, bool $a
         $size = $this->currentSize;
 
         if ($size === null) {
-            $size = TestSize::unknown();
+            $size = TestSize::Unknown;
         }
 
         $this->cachedReport = null;

src/FilterProcessor.php

@@ -17,7 +17,6 @@
 use SebastianBergmann\CodeCoverage\Data\RawCodeCoverageData;
 use SebastianBergmann\CodeCoverage\StaticAnalysis\FileAnalyser;
 use SebastianBergmann\CodeCoverage\Test\Target\Mapper;
-use SebastianBergmann\CodeCoverage\Test\TestSize\TestSize;
 
 /**
  * @internal This class is not covered by the backward compatibility promise for phpunit/php-code-coverage

src/TestSize.php

@@ -0,0 +1,66 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of phpunit/php-code-coverage.
+ *
+ * (c) Sebastian Bergmann <sebastian@phpunit.de>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace SebastianBergmann\CodeCoverage;
+
+/**
+ * @no-named-arguments Parameter names are not covered by the backward compatibility promise for phpunit/php-code-coverage
+ */
+enum TestSize: string
+{
+    public function isKnown(): bool
+    {
+        return $this !== self::Unknown;
+    }
+
+    public function isUnknown(): bool
+    {
+        return $this === self::Unknown;
+    }
+
+    public function isSmall(): bool
+    {
+        return $this === self::Small;
+    }
+
+    public function isMedium(): bool
+    {
+        return $this === self::Medium;
+    }
+
+    public function isLarge(): bool
+    {
+        return $this === self::Large;
+    }
+
+    public function isGreaterThan(self $other): bool
+    {
+        return $this->order() > $other->order();
+    }
+
+    public function asString(): string
+    {
+        return $this->value;
+    }
+
+    private function order(): int
+    {
+        return match ($this) {
+            self::Unknown => -1,
+            self::Small   => 0,
+            self::Medium  => 1,
+            self::Large   => 2,
+        };
+    }
+
+    case Unknown = 'unknown';
+    case Small   = 'small';
+    case Medium  = 'medium';
+    case Large   = 'large';
+}