Add neverExpect method

Author: tomas-novotny

CHANGELOG.md

@@ -12,3 +12,4 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ## v1.0.0 (2024-05-17) 
 ### Added
 - Added `withConsecutive` assertion method
+- Added `neverExpect` helper method

README.md

@@ -86,7 +86,7 @@ or add requirement to your `composer.json`
 Validate arguments and responses:
 
 ```php
-$mock->expects(self::exactly(count($arguments)))->method('example')
+$mock->expects(self::exactly(2))->method('example')
     ->will(self::withConsecutive(
         arguments: [
             [1, 2, 0.1],
@@ -105,7 +105,7 @@ self::assertFalse($mock->example(2, 3, 0.01));
 Optional responses:
 
 ```php
-$mock->expects(self::exactly(count($arguments)))->method('example')
+$mock->expects(self::exactly(2))->method('example')
     ->will(self::withConsecutive(
         arguments: [
             [1, 2, 0.1],
@@ -120,7 +120,7 @@ $mock->example(2, 3, 0.01);
 Simplification for same response for each call
 
 ```php
-$mock->expects(self::exactly(count($arguments)))->method('example')
+$mock->expects(self::exactly(2))->method('example')
     ->will(self::withConsecutive(
         arguments: [
             [1, 2, 0.1],
@@ -136,7 +136,7 @@ self::assertTrue($mock->example(2, 3, 0.01));
 Supports throwing exceptions:
 
 ```php
-$mock->expects(self::exactly(count($arguments)))->method('example')
+$mock->expects(self::exactly(2))->method('example')
     ->will(self::withConsecutive(
         arguments: [
             [1, 2, 0.1],

src/Extension.php

@@ -11,8 +11,18 @@ trait Extension
     /**
      * @param array<array<int,mixed>|\PHPUnit\Framework\Constraint\Callback<mixed>> $arguments
      */
-    final public static function withConsecutive(array $arguments, mixed $responses = null): Stub
+    protected static function withConsecutive(array $arguments, mixed $responses = null): Stub
     {
         return Assertion::withConsecutive($arguments, $responses);
     }
+
+    /**
+     * @param list<\PHPUnit\Framework\MockObject\MockObject> $mocks
+     */
+    protected static function neverExpect(array $mocks): void
+    {
+        foreach ($mocks as $mock) {
+            $mock->expects(self::never())->method(self::anything());
+        }
+    }
 }

tests/Assertion/BaseWithConsecutiveTestCase.php renamed to tests/BaseWithConsecutiveTestCase.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Inspirum\PHPUnit\Tests\Assertion;
+namespace Inspirum\PHPUnit\Tests;
 
 use LengthException;
 use PHPUnit\Framework\Constraint\Callback;

tests/Assertion/Mock.php renamed to tests/Mock.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Inspirum\PHPUnit\Tests\Assertion;
+namespace Inspirum\PHPUnit\Tests;
 
 interface Mock
 {

tests/NeverExpectTest.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Inspirum\PHPUnit\Tests;
+
+use Inspirum\PHPUnit\Extension;
+use PHPUnit\Framework\MockObject\MockObject;
+use PHPUnit\Framework\TestCase;
+
+final class NeverExpectTest extends TestCase
+{
+    use Extension;
+
+    private Mock&MockObject $mock1;
+    private Mock&MockObject $mock2;
+    private Mock&MockObject $mock3;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->mock1 = $this->createMock(Mock::class);
+        $this->mock2 = $this->createMock(Mock::class);
+        $this->mock3 = $this->createMock(Mock::class);
+    }
+
+    public function testNeverExpect(): void
+    {
+        self::neverExpect([
+            $this->mock1,
+            $this->mock2,
+            $this->mock3,
+        ]);
+    }
+}

tests/Assertion/WithConsecutiveAssertionTest.php renamed to tests/WithConsecutiveAssertionTest.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Inspirum\PHPUnit\Tests\Assertion;
+namespace Inspirum\PHPUnit\Tests;
 
 use Inspirum\PHPUnit\Assertion;
 use PHPUnit\Framework\MockObject\Stub\Stub;

tests/Assertion/WithConsecutiveExtensionTest.php renamed to tests/WithConsecutiveExtensionTest.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace Inspirum\PHPUnit\Tests\Assertion;
+namespace Inspirum\PHPUnit\Tests;
 
 use Inspirum\PHPUnit\Extension;
 use PHPUnit\Framework\MockObject\Stub\Stub;