exceptions: added RateLimitExceedException

Author: milo

src/Github/Api.php

@@ -266,6 +266,9 @@ public function decode(Http\Response $response, array $okCodes = NULL)
 					throw new UnauthorizedException($content->message, $code, NULL, $response);
 
 				case Http\Response::S403_FORBIDDEN:
+					if ($response->getHeader('X-RateLimit-Remaining') === '0') {
+						throw new RateLimitExceedException($content->message, $code, NULL, $response);
+					}
 					throw new ForbiddenException($content->message, $code, NULL, $response);
 
 				case Http\Response::S404_NOT_FOUND:

src/Github/exceptions.php

@@ -99,6 +99,14 @@ class ForbiddenException extends ApiException
 	{}
 
 
+	/**
+	 * Rate limit exceed.
+	 * @see https://developer.github.com/v3/#rate-limiting
+	 */
+	class RateLimitExceedException extends ForbiddenException
+	{}
+
+
 	/**
 	 * Resource not found.
 	 * @see https://developer.github.com/v3/#authentication

tests/Github/Api.decode.phpt

@@ -58,6 +58,13 @@ $e = Assert::exception(function() use ($api) {
 Assert::null($e->getPrevious());
 
 
+$e = Assert::exception(function() use ($api) {
+	$response = new Milo\Github\Http\Response(403, ['Content-Type' => 'application/json', 'X-RateLimit-Remaining' => '0'], '{"message":"error"}');
+	$api->decode($response);
+}, 'Milo\Github\RateLimitExceedException', 'error', 403);
+Assert::null($e->getPrevious());
+
+
 $e = Assert::exception(function() use ($api) {
 	$response = new Milo\Github\Http\Response(404, [], '');
 	$api->decode($response);