Added outOfContext method.

docs/authorization.md

@@ -64,6 +64,11 @@ Returns a copy of the `Authz` service with the given user, in the current contex
 
 Returns a copy of the `Authz` service with the current user, in the given context.
 
+#### outOfContext
+
+    Auth::outOfContext(): Authz
+
+Alias of `Auth::inContextOf(null)`.
 
 ### Immutable state
 

src/Auth.php

@@ -512,6 +512,14 @@ public function inContextOf(?Context $context): Authz
         return $this->authz->inContextOf($context);
     }
 
+    /**
+     * Alias of `inContextOf(null)`.
+     */
+    final public function outOfContext(): Authz
+    {
+        return $this->inContextOf(null);
+    }
+
 
     /**
      * Get service to create or validate confirmation token.

src/Authz/StateTrait.php

@@ -52,6 +52,16 @@ public function inContextOf(?Context $context): Authz
         return $this->withProperty('context', $context);
     }
 
+    /**
+     * Alias of `inContextOf(null)`.
+     *
+     * @return static&Authz
+     */
+    final public function outOfContext(): Authz
+    {
+        return $this->inContextOf(null);
+    }
+
     /**
      * Get current authenticated user.
      *

src/AuthzInterface.php

@@ -36,6 +36,13 @@ public function forUser(?User $user): self;
      */
     public function inContextOf(?Context $context): self;
 
+    /**
+     * Alias of `inContextOf(null)`.
+     *
+     * @return AuthzInterface
+     */
+    public function outOfContext(): self;
+
     /**
      * Get a copy, recalculating the authz role of the user.
      *

tests/AuthTest.php

@@ -1182,7 +1182,7 @@ public function testForUser()
         $this->assertSame($this->authz, $this->service->authz()); // Not modified
     }
 
-    public function testForContext()
+    public function testInContextOf()
     {
         $context = $this->createMock(Context::class);
         $newAuthz = $this->createMock(Authz::class);
@@ -1195,6 +1195,18 @@ public function testForContext()
         $this->assertSame($this->authz, $this->service->authz()); // Not modified
     }
 
+    public function testOutOfContext()
+    {
+        $newAuthz = $this->createMock(Authz::class);
+
+        $this->authz->expects($this->once())->method('inContextOf')
+            ->with(null)
+            ->willReturn($newAuthz);
+
+        $this->assertSame($newAuthz, $this->service->outOfContext());
+        $this->assertSame($this->authz, $this->service->authz()); // Not modified
+    }
+
 
     public function testConfirm()
     {

tests/Authz/LevelsTest.php

@@ -3,6 +3,7 @@
 namespace Jasny\Auth\Tests\Authz;
 
 use Jasny\Auth\AuthException;
+use Jasny\Auth\AuthzInterface;
 use Jasny\Auth\ContextInterface as Context;
 use Jasny\Auth\User\PartiallyLoggedIn;
 use Jasny\Auth\UserInterface as User;
@@ -98,7 +99,7 @@ public function testWithInvalidUserRole()
         $this->authz = $this->authz->forUser($user);
     }
 
-    public function testContext()
+    public function testInContextOf()
     {
         $this->assertNull($this->authz->context());
 
@@ -108,6 +109,20 @@ public function testContext()
         $this->assertNotSame($this->authz, $contextAuthz);
         $this->assertNull($this->authz->context());
         $this->assertSame($context, $contextAuthz->context());
+
+        return $contextAuthz;
+    }
+
+    /**
+     * @depends testInContextOf
+     */
+    public function testOutOfContext(AuthzInterface $contextAuthz)
+    {
+        $noContextAuthz = $contextAuthz->outOfContext();
+
+        $this->assertNotSame($contextAuthz, $noContextAuthz);
+        $this->assertNotNull($contextAuthz->context());
+        $this->assertNull($noContextAuthz->context());
     }