Merge branch 'feature/7327' into develop

Close zendframework/zendframework#7327

src/Assertion/CallbackAssertion.php

@@ -0,0 +1,45 @@
+<?php
+/**
+ * Zend Framework (http://framework.zend.com/).
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ */
+namespace Zend\Permissions\Rbac\Assertion;
+
+use Zend\Permissions\Rbac\AssertionInterface;
+use Zend\Permissions\Rbac\Exception\InvalidArgumentException;
+use Zend\Permissions\Rbac\Rbac;
+
+class CallbackAssertion implements AssertionInterface
+{
+    /**
+     * @var callable
+     */
+    protected $callback;
+
+    /**
+     * @param callable $callback The assertion callback
+     */
+    public function __construct($callback)
+    {
+        if (! is_callable($callback)) {
+            throw new InvalidArgumentException('Invalid callback provided; not callable');
+        }
+        $this->callback = $callback;
+    }
+
+    /**
+     * Assertion method - must return a boolean.
+     *
+     * Returns the result of the composed callback.
+     *
+     * @param Rbac $rbac
+     * @return bool
+     */
+    public function assert(Rbac $rbac)
+    {
+        return (bool) call_user_func($this->callback, $rbac);
+    }
+}

test/Assertion/CallbackAssertionTest.php

@@ -0,0 +1,82 @@
+<?php
+/**
+ * Zend Framework (http://framework.zend.com/)
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ */
+namespace ZendTest\Permissions\Rbac\Assertion;
+
+use Zend\Permissions\Rbac;
+
+class CallbackAssertionTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * Ensures constructor throws InvalidArgumentException if not callable is provided
+     */
+    public function testConstructorThrowsExceptionIfNotCallable()
+    {
+        $this->setExpectedException(
+            'Zend\Permissions\Rbac\Exception\InvalidArgumentException',
+            'Invalid callback provided; not callable'
+        );
+        new Rbac\Assertion\CallbackAssertion('I am not callable!');
+    }
+
+    /**
+     * Ensures callback is set in object
+     */
+    public function testCallbackIsSet()
+    {
+        $callback   = function () {
+        };
+        $assert     = new Rbac\Assertion\CallbackAssertion($callback);
+        $this->assertAttributeSame($callback, 'callback', $assert);
+    }
+
+    /**
+     * Ensures assert method provides callback with rbac as argument
+     */
+    public function testAssertMethodPassRbacToCallback()
+    {
+        $rbac   = new Rbac\Rbac();
+        $that   = $this;
+        $assert = new Rbac\Assertion\CallbackAssertion(function ($rbacArg) use ($that, $rbac) {
+            $that->assertSame($rbacArg, $rbac);
+            return false;
+        });
+        $foo  = new Rbac\Role('foo');
+        $foo->addPermission('can.foo');
+        $this->assertFalse($rbac->isGranted($foo, 'can.foo', $assert));
+    }
+
+    /**
+     * Ensures assert method returns callback's function value
+     */
+    public function testAssertMethod()
+    {
+        $rbac = new Rbac\Rbac();
+        $foo  = new Rbac\Role('foo');
+        $bar  = new Rbac\Role('bar');
+
+        $assertRoleMatch = function ($role) {
+            return function ($rbac) use ($role) {
+                return $role->getName() == 'foo';
+            };
+        };
+
+        $roleNoMatch = new Rbac\Assertion\CallbackAssertion($assertRoleMatch($bar));
+        $roleMatch   = new Rbac\Assertion\CallbackAssertion($assertRoleMatch($foo));
+
+        $foo->addPermission('can.foo');
+        $bar->addPermission('can.bar');
+
+        $rbac->addRole($foo);
+        $rbac->addRole($bar);
+
+        $this->assertFalse($rbac->isGranted($bar, 'can.bar', $roleNoMatch));
+        $this->assertFalse($rbac->isGranted($bar, 'can.foo', $roleNoMatch));
+        $this->assertTrue($rbac->isGranted($foo, 'can.foo', $roleMatch));
+    }
+}