bundle: add --upgrade switch.

This allows overriding the `HOMEBREW_BUNDLE_NO_UPGRADE` environment
variable. The environment variable wasn't really documented specifically
before so let's do that here, too.

Author: MikeMcQuaid

cmd/bundle.rb

@@ -66,7 +66,11 @@ class BundleCmd < AbstractCommand
                env:         :bundle_no_upgrade,
                description: "`install` does not run `brew upgrade` on outdated dependencies. " \
                             "`check` does not check for outdated dependencies. " \
-                            "Note they may still be upgraded by `brew install` if needed."
+                            "Note they may still be upgraded by `brew install` if needed." \
+                            "This is enabled by default if `HOMEBREW_BUNDLE_NO_UPGRADE` is set."
+        switch "--upgrade",
+               description: "`install` runs `brew upgrade` on outdated dependencies, " \
+                            "even if `HOMEBREW_BUNDLE_NO_UPGRADE` is set. "
         switch "-f", "--force",
                description: "`install` runs with `--force`/`--overwrite`. " \
                             "`dump` overwrites an existing `Brewfile`. " \
@@ -126,7 +130,7 @@ def run
         global = args.global?
         file = args.file
         args.zap?
-        no_upgrade = args.no_upgrade?
+        no_upgrade = args.upgrade? ? false : args.no_upgrade?
         verbose = args.verbose?
         force = args.force?
         zap = args.zap?

cmd/bundle.rbi

@@ -57,6 +57,9 @@ class Homebrew::Cmd::BundleCmd::Args < Homebrew::CLI::Args
   sig { returns(T::Boolean) }
   def taps?; end
 
+  sig { returns(T::Boolean) }
+  def upgrade?; end
+
   sig { returns(T::Boolean) }
   def verbose?; end