Bob 461f49dcb6 fix: Display a warning but continue execution when dumping an exception and unable to find related issues
Occasionally, when failing to `brew install` or `brew upgrade` a formula, users will get an error message and the last line of it will be:
```
Error: Validation Failed: [{"message"=>"The listed users and repositories cannot be searched either because the resources do not exist or you do not have permission to view them.", "resource"=>"Search", "field"=>"q", "code"=>"invalid"}]
```

Here's an old public example: https://gitlab.com/tabos/rogerrouter/-/issues/21

At Square, this error can be caused by a transient issue with a user's GitHub credentials.

My proposal is that any error which prevents `brew` from showing related issues should:
1. Not cause `brew` to exit early (vs. printing diagnostic checks and doing any other cleanup)
2. Be clearly differentiated from the original failure (so it doesn't become a red herring for users troubleshooting their broken formula)
2024-04-29 11:47:01 -07:00
..
2024-04-29 02:52:36 +00:00
2024-04-29 17:42:34 +01:00
2024-04-26 13:20:05 +02:00
2024-04-26 14:04:55 +02:00
2024-04-22 21:16:49 +02:00
2024-04-22 21:16:49 +02:00
2024-04-26 14:04:55 +02:00
2024-04-26 14:04:55 +02:00

Homebrew Ruby API

This is the API for Homebrew.

The main class you should look at is the {Formula} class (and classes linked from there). That's the class that's used to create Homebrew formulae (i.e. package descriptions). Assume anything else you stumble upon is private.

You may also find the Formula Cookbook and Ruby Style Guide helpful in creating formulae.

Good luck!