Added new authentication assertions

Author: TavoNiievez

src/Codeception/Module/Laravel/InteractsWithAuthentication.php

@@ -4,6 +4,7 @@
 
 namespace Codeception\Module\Laravel;
 
+use Illuminate\Auth\GuardHelpers;
 use Illuminate\Contracts\Auth\Authenticatable;
 
 trait InteractsWithAuthentication
@@ -40,6 +41,60 @@ public function amLoggedAs($user, string $guardName = null): void
         );
     }
 
+    /**
+     * Set the given user object to the current or specified Guard.
+     */
+    public function amActingAs(Authenticatable $user, string $guardName = null): void
+    {
+        if (isset($user->wasRecentlyCreated) && $user->wasRecentlyCreated) {
+            $user->wasRecentlyCreated = false;
+        }
+
+        $this->getAuth()->guard($guardName)->setUser($user);
+
+        $this->getAuth()->shouldUse($guardName);
+    }
+
+    /**
+     * Assert that the user is authenticated as the given user.
+     */
+    public function assertAuthenticatedAs(Authenticatable $user, string $guardName = null): void
+    {
+        $expected = $this->getAuth()->guard($guardName)->user();
+
+        $this->assertNotNull($expected, 'The current user is not authenticated.');
+
+        $this->assertInstanceOf(
+            get_class($expected), $user,
+            'The currently authenticated user is not who was expected'
+        );
+
+        $this->assertSame(
+            $expected->getAuthIdentifier(), $user->getAuthIdentifier(),
+            'The currently authenticated user is not who was expected'
+        );
+    }
+
+    /**
+     * Assert that the given credentials are valid.
+     */
+    public function assertCredentials(array $credentials, string $guardName = null): void
+    {
+        $this->assertTrue(
+            $this->hasCredentials($credentials, $guardName), 'The given credentials are invalid.'
+        );
+    }
+
+    /**
+     * Assert that the given credentials are invalid.
+     */
+    public function assertInvalidCredentials(array $credentials, string $guardName = null): void
+    {
+        $this->assertFalse(
+            $this->hasCredentials($credentials, $guardName), 'The given credentials are valid.'
+        );
+    }
+
     /**
      * Check that user is not authenticated.
      */
@@ -64,6 +119,20 @@ public function logout(): void
         $this->getAuth()->logout();
     }
 
+    /**
+     * Return true if the credentials are valid, false otherwise.
+     */
+    protected function hasCredentials(array $credentials, string $guardName = null): bool
+    {
+        /** @var GuardHelpers $guard */
+        $guard = $this->getAuth()->guard($guardName);
+        $provider = $guard->getProvider();
+
+        $user = $provider->retrieveByCredentials($credentials);
+
+        return $user && $provider->validateCredentials($user, $credentials);
+    }
+
     /**
      * Return true if the user is authenticated, false otherwise.
      */