Added user suspension & unsuspension, resolves #207.

Author: guillermo.fisher

doc/users.md

@@ -174,3 +174,19 @@ $emails = $client->api('current_user')->emails()->remove(array('[email protected]
 ```
 
 Return an array of the authenticated user emails.
+
+### Suspend a user (Enterprise only)
+
+> Requires [authentication](security.md).
+
+```php
+$client->api('user')->suspend('ornicar');
+```
+
+### Unsuspend a user (Enterprise only)
+
+> Requires [authentication](security.md).
+
+```php
+$client->api('user')->unsuspend('ornicar');
+```

lib/Github/Api/User.php

@@ -182,4 +182,32 @@ public function publicEvents($username)
     {
         return $this->get('users/'.rawurlencode($username) . '/events/public');
     }
+
+    /**
+     * Suspend a user
+     *
+     * @link https://developer.github.com/v3/users/administration/#suspend-a-user
+     *
+     * @param string $username
+     *
+     * @return array
+     */
+    public function suspend($username)
+    {
+        return $this->put('users/'.rawurldecode($username).'/suspended', array('Content-Length' => 0));
+    }
+
+    /**
+     * Unsuspend a user
+     *
+     * @link https://developer.github.com/v3/users/administration/#unsuspend-a-user
+     *
+     * @param string $username
+     *
+     * @return array
+     */
+    public function unsuspend($username)
+    {
+        return $this->delete('users/'.rawurldecode($username).'/suspended');
+    }
 }

test/Github/Tests/Api/UserTest.php

@@ -161,6 +161,38 @@ public function shouldGetUserGists()
         $this->assertEquals($expectedArray, $api->gists('l3l0'));
     }
 
+    /**
+     * @test
+     */
+    public function shouldSuspendUser()
+    {
+        $expectedArray = array();
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('put')
+            ->with('users/l3l0/suspended')
+            ->will($this->returnValue($expectedArray));
+        $this->assertEquals($expectedArray, $api->suspend('l3l0'));
+    }
+
+    /**
+     * @test
+     */
+    public function shouldUnsuspendUser()
+    {
+        $expectedArray = array();
+
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('delete')
+            ->with('users/l3l0/suspended')
+            ->will($this->returnValue($expectedArray));
+
+        $this->assertEquals($expectedArray, $api->unsuspend('l3l0'));
+    }
+
+
     protected function getApiClass()
     {
         return 'Github\Api\User';