From e5ba52bf5c64ddab07aa76edbb05b46a0c7f7a0d Mon Sep 17 00:00:00 2001
From: Jack Nagel <jacknagel@gmail.com>
Date: Fri, 5 Jul 2013 11:14:18 -0500
Subject: [PATCH] Give advice when GitHub API requests fail

Refs Homebrew/homebrew#21023.
---
 Library/Homebrew/utils.rb | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/Library/Homebrew/utils.rb b/Library/Homebrew/utils.rb
index 346365d775..5b055d8f17 100644
--- a/Library/Homebrew/utils.rb
+++ b/Library/Homebrew/utils.rb
@@ -269,7 +269,11 @@ module GitHub extend self
     Kernel.open(url, default_headers.merge(headers), &block)
   rescue OpenURI::HTTPError => e
     if e.io.meta['x-ratelimit-remaining'].to_i <= 0
-      raise "GitHub #{Utils::JSON.load(e.io.read)['message']}"
+      raise <<-EOS.undent
+        GitHub #{Utils::JSON.load(e.io.read)['message']}
+        You may want to create an API token: https://github.com/settings/applications
+        and then set HOMEBREW_GITHUB_API_TOKEN.
+        EOS
     else
       raise e
     end