Add clear method to TestLogger (#9)

Author: MidnightDesign

src/TestLogger.php

@@ -151,6 +151,14 @@ public function log($level, Stringable|string $message, array $context = []): vo
         $this->records[] = new LogRecord($level, $message, $context);
     }
 
+    /**
+     * Clears all stored records, resetting the storage to an empty state.
+     */
+    public function clear(): void
+    {
+        $this->records = [];
+    }
+
     /**
      * @param Matcher $matcher
      */

tests/unit/TestLoggerTest.php

@@ -14,6 +14,8 @@
 use Psr\Log\LogLevel;
 use Throwable;
 
+use function assert;
+
 /**
  * @phpstan-import-type Matcher from TestLogger
  */
@@ -339,6 +341,29 @@ public function testNeverMatches(array $records, callable $matcher): void
         self::assertTrue($result);
     }
 
+    public function testDoesNotMatchAnythingAfterClearing(): void
+    {
+        $this->logger->log(LogLevel::INFO, 'Foo');
+
+        $matcher = TestLogger::level(LogLevel::INFO);
+        assert($this->logger->once($matcher), 'Sanity check: should match before it is cleared');
+        $this->logger->clear();
+
+        self::assertNotTrue($this->logger->once($matcher));
+    }
+
+    public function testClearIsIdempotent(): void
+    {
+        $this->logger->log(LogLevel::INFO, 'Foo');
+
+        $matcher = TestLogger::level(LogLevel::INFO);
+        assert($this->logger->once($matcher), 'Sanity check: should match before it is cleared');
+        $this->logger->clear();
+        $this->logger->clear();
+
+        self::assertNotTrue($this->logger->once($matcher));
+    }
+
     #[Override]
     protected function setUp(): void
     {