Give advice when GitHub API requests fail

Refs Homebrew/homebrew#21023.

1 files changed, 5 insertions, 1 deletions

diff --git a/Library/Homebrew/utils.rb b/Library/Homebrew/utils.rb
index 346365d77..5b055d8f1 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