Add ability for DBs to be granted to users

Author: Jamie Hannaford

doc/services/database/users.rst

@@ -65,3 +65,15 @@ Check if root user is enabled
 
   // true for yes, false for no
   $instance->isRootEnabled();
+
+
+Grant database access
+---------------------
+
+To grant access to one or more databases, you can run:
+
+.. code-block:: php
+
+    $user = $instance->user('{userName}');
+    $user->grantDbAccess(['{dbName1}', '{dbName2}']);
+

lib/OpenCloud/Database/Resource/User.php

@@ -152,4 +152,29 @@ protected function createJson()
             'users' => array($user)
         );
     }
+
+    /**
+     * Grant access to a set of one or more databases to a user.
+     *
+     * @param []string $databases An array of one or more database names that this user will be granted access to. For
+     *                            example, ['foo', 'bar'] or ['baz'] are valid inputs.
+     *
+     * @return \Guzzle\Http\Message\Response
+     */
+    public function grantDbAccess(array $databases)
+    {
+        $json = [];
+
+        foreach ($databases as $database) {
+            $json[] = ['name' => $database];
+        }
+
+        $json = ['databases' => $json];
+
+        $url = $this->getUrl('databases');
+        $headers = self::getJsonHeader();
+        $body = json_encode($json);
+
+        return $this->getClient()->put($url, $headers, $body)->send();
+    }
 }

tests/OpenCloud/Tests/Database/Resource/UserTest.php

@@ -46,7 +46,7 @@ public function test__construct()
             'OpenCloud\Database\Resource\User', $this->user
         );
 
-        $u = $this->instance->user('glen', array('one', 'two'));
+        $u = $this->instance->user('glen', ['one', 'two']);
         $this->assertEquals('glen', $u->name);
         $this->assertEquals(2, count($u->databases));
     }
@@ -84,14 +84,14 @@ public function testAddDatabase()
 
     public function testCreate()
     {
-        $response = $this->user->create(array(
+        $response = $this->user->create([
             'name'      => 'FOOBAR',
             'password'  => 'BAZ',
-            'databases' => array(
+            'databases' => [
                 'foo',
                 'baz'
-            )
-        ));
+            ]
+        ]);
         $this->assertLessThan(205, $response->getStatusCode());
         $this->assertEquals('FOOBAR', $this->user->getName());
         $this->assertEquals('BAZ', $this->user->password);
@@ -119,4 +119,15 @@ public function testNameFailsWhenNotSet()
     {
         $this->instance->user()->getName();
     }
+
+    public function test_It_Grants_Access_To_Db()
+    {
+        $this->user->name = 'foo';
+
+        $response = $this->user->grantDbAccess([
+            'foo', 'bar', 'baz',
+        ]);
+
+        $this->isResponse($response);
+    }
 }