Implement method to warm the static analysis cache

Author: sebastianbergmann

src/CodeCoverage.php

@@ -398,6 +398,29 @@ public function doNotCacheStaticAnalysis(): void
         $this->cacheDirectory = null;
     }
 
+    /**
+     * @throws CacheNotConfiguredException
+     */
+    public function warmCache(): void
+    {
+        if (!$this->cachesStaticAnalysis()) {
+            throw new CacheNotConfiguredException(
+                'The cache has not been configured using cacheStaticAnalysis()'
+            );
+        }
+
+        $coveredFileAnalyser   = $this->coveredFileAnalyser();
+        $uncoveredFileAnalyser = $this->uncoveredFileAnalyser();
+
+        foreach ($this->filter->files() as $file) {
+            /* @noinspection UnusedFunctionResultInspection */
+            $coveredFileAnalyser->linesOfCodeFor($file);
+
+            /* @noinspection UnusedFunctionResultInspection */
+            $uncoveredFileAnalyser->executableLinesIn($file);
+        }
+    }
+
     /**
      * @psalm-param class-string $className
      */

src/Exception/CacheNotConfiguredException.php

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+/*
+ * This file is part of phpunit/php-code-coverage.
+ *
+ * (c) Sebastian Bergmann <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+namespace SebastianBergmann\CodeCoverage;
+
+use RuntimeException;
+
+final class CacheNotConfiguredException extends RuntimeException implements Exception
+{
+}