Merge pull request #17841 from Homebrew/debrew-disable

Library/Homebrew/build.rb

@@ -122,7 +122,7 @@ class Build
     }
 
     with_env(new_env) do
-      if args.debug?
+      if args.debug? && !Homebrew::EnvConfig.disable_debrew?
         require "debrew"
         formula.extend(Debrew::Formula)
       end

Library/Homebrew/env_config.rb

@@ -152,6 +152,10 @@ module Homebrew
                      "budding) by e.g. turning warnings into errors.",
         boolean:     true,
       },
+      HOMEBREW_DISABLE_DEBREW:                   {
+        description: "If set, the interactive formula debugger available via `--debug` will be disabled.",
+        boolean:     true,
+      },
       HOMEBREW_DISABLE_LOAD_FORMULA:             {
         description: "If set, refuse to load formulae. This is useful when formulae are not trusted (such " \
                      "as in pull requests).",

Library/Homebrew/postinstall.rb

@@ -21,7 +21,7 @@ begin
   trap("INT", old_trap)
 
   formula = T.must(args.named.to_resolved_formulae.first)
-  if args.debug?
+  if args.debug? && !Homebrew::EnvConfig.disable_debrew?
     require "debrew"
     formula.extend(Debrew::Formula)
   end

Library/Homebrew/sorbet/rbi/dsl/homebrew/env_config.rbi

@@ -88,6 +88,9 @@ module Homebrew::EnvConfig
     sig { returns(T::Boolean) }
     def developer?; end
 
+    sig { returns(T::Boolean) }
+    def disable_debrew?; end
+
     sig { returns(T::Boolean) }
     def disable_load_formula?; end
 

Library/Homebrew/test.rb

@@ -35,7 +35,7 @@ begin
   formula = T.must(args.named.to_resolved_formulae.first)
   formula.extend(Homebrew::Assertions)
   formula.extend(Homebrew::FreePort)
-  if args.debug?
+  if args.debug? && !Homebrew::EnvConfig.disable_debrew?
     require "debrew"
     formula.extend(Debrew::Formula)
   end

docs/Manpage.md

@@ -3691,6 +3691,11 @@ command execution e.g. `$(cat file)`.
 : If set, tweak behaviour to be more relevant for Homebrew developers (active or
   budding) by e.g. turning warnings into errors.
 
+`HOMEBREW_DISABLE_DEBREW`
+
+: If set, the interactive formula debugger available via `--debug` will be
+  disabled.
+
 `HOMEBREW_DISABLE_LOAD_FORMULA`
 
 : If set, refuse to load formulae. This is useful when formulae are not trusted

manpages/brew.1

@@ -2395,6 +2395,9 @@ If set, always assume \fB\-\-debug\fP when running commands\.
 \fBHOMEBREW_DEVELOPER\fP
 If set, tweak behaviour to be more relevant for Homebrew developers (active or budding) by e\.g\. turning warnings into errors\.
 .TP
+\fBHOMEBREW_DISABLE_DEBREW\fP
+If set, the interactive formula debugger available via \fB\-\-debug\fP will be disabled\.
+.TP
 \fBHOMEBREW_DISABLE_LOAD_FORMULA\fP
 If set, refuse to load formulae\. This is useful when formulae are not trusted (such as in pull requests)\.
 .TP