Added seeAuthentication function

Author: TavoNiievez

documentation.md

@@ -890,6 +890,20 @@ For checking the raw source code, use `seeInSource()`.
  * `param array|string` $selector optional
 
 
+### seeAuthentication
+ 
+Checks that a user is authenticated.
+You can check users logged in with the option 'remember me' passing true as parameter.
+
+```php
+<?php
+$I->seeAuthentication();
+$I->seeAuthentication(true);
+```
+
+ * `param bool` $remembered
+
+
 ### seeCheckboxIsChecked
 
 Checks that the specified checkbox is checked.

src/Codeception/Module/Symfony.php

@@ -911,7 +911,7 @@ public function amOnAction($action, $params = [])
             $controller = basename($route->getDefault('_controller'));
             if ($controller === $action) {
                 $resource = $router->match($route->getPath());
-                $url = $router->generate(
+                $url      = $router->generate(
                     $resource['_route'],
                     $params,
                     UrlGeneratorInterface::ABSOLUTE_PATH
@@ -921,4 +921,43 @@ public function amOnAction($action, $params = [])
             }
         }
     }
+
+    /**
+     * Checks that a user is authenticated.
+     * You can check users logged in with the option 'remember me' passing true as parameter.
+     *
+     * ```php
+     * <?php
+     * $I->seeAuthentication();
+     * $I->seeAuthentication(true);
+     * ```
+     *
+     * @param bool $remembered
+     */
+    public function seeAuthentication($remembered = false)
+    {
+        $container = $this->_getContainer();
+
+        if (!$container->has('security.helper')) {
+            $this->fail("Symfony container doesn't have 'security.helper' service");
+            return;
+        }
+
+        $security = $this->grabService('security.helper');
+
+        $user = $security->getUser();
+
+        if (!$user) {
+            $this->fail('There is no user in session');
+            return;
+        }
+
+        if ($remembered) {
+            $role = 'IS_AUTHENTICATED_REMEMBERED';
+        } else {
+            $role = 'IS_AUTHENTICATED_FULLY';
+        }
+
+        $this->assertTrue($security->isGranted($role), 'There is no authenticated user');
+    }
 }