Add isRedirect assertion for responses in the 3xx range (#17)

Author: gsteel

README.md

@@ -188,6 +188,7 @@ assertThat($response, hasStatus(logicalAnd(greaterThanOrEqual(200), lessThan(400
 For the most common checks, some shorthand assertions are available:
 
 - `assertResponseIsSuccess($response)` / `isSuccess()` -- Status codes 200 to 299
+- `assertResponseIsRedirect($response)` / `isRedirect()` -- Status codes 300 to 399
 - `assertResponseIsClientError($response)` / `isClientError()` -- Status codes 400 to 499
 - `assertResponseIsServerError($response)` / `isServerError()` -- Status codes 500 to 599
 

src/Functions.php

@@ -45,6 +45,11 @@ function isSuccess(): Constraint
     return Psr7Assertions::isSuccess();
 }
 
+function isRedirect(): Constraint
+{
+    return Psr7Assertions::isRedirect();
+}
+
 function isClientError(): Constraint
 {
     return Psr7Assertions::isClientError();
@@ -114,4 +119,4 @@ function bodyMatchesForm(array $constraints): Constraint
 function isAbsoluteUri(): Constraint
 {
     return new IsAbsoluteUriConstraint();
-}
+}

src/Psr7Assertions.php

@@ -63,6 +63,11 @@ public static function assertResponseIsSuccess(ResponseInterface $response): voi
         Assert::assertThat($response, static::isSuccess());
     }
 
+    public static function assertResponseIsRedirect(ResponseInterface $response): void
+    {
+        Assert::assertThat($response, static::isRedirect());
+    }
+
     public static function assertResponseIsClientError(ResponseInterface $response): void
     {
         Assert::assertThat($response, static::isClientError());
@@ -141,6 +146,11 @@ public static function isSuccess(): Constraint
         return new HasStatusConstraint(Assert::logicalAnd(Assert::greaterThanOrEqual(200), Assert::lessThan(300)));
     }
 
+    public static function isRedirect(): Constraint
+    {
+        return new HasStatusConstraint(Assert::logicalAnd(Assert::greaterThanOrEqual(300), Assert::lessThan(400)));
+    }
+
     public static function isClientError(): Constraint
     {
         return new HasStatusConstraint(Assert::logicalAnd(Assert::greaterThanOrEqual(400), Assert::lessThan(500)));

tests/Functional/ConstraintTest.php

@@ -209,6 +209,18 @@ public function testIsSuccessCanFail()
         $this->assertResponseIsSuccess(new Response(404));
     }
 
+    public function testIsRedirectCanSucceed()
+    {
+        $this->assertResponseIsRedirect(new Response(300));
+    }
+
+    public function testIsRedirectCanFail()
+    {
+        $this->expectException(AssertionFailedError::class);
+
+        $this->assertResponseIsRedirect(new Response(200));
+    }
+
     public function testIsClientErrorCanSucceed()
     {
         $this->assertResponseIsClientError(new Response(404));