Improve error message when changing Gemfile to a mistyped git ref

[deivid-rodriguez]

What was the end-user or developer problem that led to this PR?

Before #4475, changing a locked git source in the Gemfile with a bad reference name would saw a helpful error saying that the reference does not exist remotely:

$ bundle install
Fetching https://github.com/rails/rails.git
fatal: Needed a single revision
Git error: command `git rev-parse --verify bad` in directory
/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 has failed.
Revision bad does not exist in the repository https://github.com/rails/rails.git. Maybe you misspelled it?
If this error persists you could try removing the cache directory
'/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32'

To be honest, the error was not ideal but at least the culprit is mentioned Revision bad does not exist in the repository https://github.com/rails/rails.git. Maybe you misspelled it?

After #4475, the error is in my opinion worse:

$ bundle install
Fetching https://github.com/rails/rails.git
fatal: couldn't find remote ref refs/heads/bad

Retrying `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` at /Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 due to error (2/4): Bundler::Source::Git::GitCommandError Git error: command `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` in directory /Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 has failed.

If this error persists you could try removing the cache directory '/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32'

Retrying `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` at /Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 due to error (3/4): Bundler::Source::Git::GitCommandError Git error: command `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` in directory /Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 has failed.

If this error persists you could try removing the cache directory '/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32'

Retrying `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` at /Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 due to error (4/4): Bundler::Source::Git::GitCommandError Git error: command `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` in directory /Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 has failed.

If this error persists you could try removing the cache directory '/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32'

Git error: command `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` in directory
/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 has failed.

If this error persists you could try removing the cache directory
'/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32'

The culprit is still mentioned fatal: couldn't find remote ref refs/heads/bad, but the error is flooded with other unhelpful information.

What is your fix for the problem, implemented in this PR?

My fix is to refactor things and show a better error in this situation:

$ bundle install
Fetching https://github.com/rails/rails.git

Git error: command `git fetch --force --quiet --no-tags --depth 1 -- https://github.com/rails/rails.git refs/heads/bad:refs/heads/bad` in directory
/Users/deivid/.asdf/installs/ruby/3.1.3/lib/ruby/gems/3.1.0/cache/bundler/git/rails-fcf0202857b07db1a0f6220dae5ca99319ca0f32 has failed.
Revision bad does not exist in the repository https://github.com/rails/rails.git. Maybe you misspelled it?

Make sure the following tasks are checked

• Describe the problem / feature
• Write tests for features and bug fixes
• Write code to solve the problem
• Make sure you follow the current code style and write meaningful commit messages without tags