utils/pypi: specify dependencies needed to update resources

Library/Homebrew/dev-cmd/bump-formula-pr.rb

@@ -72,6 +72,8 @@ def bump_formula_pr_args
                           "or specified <version>."
       switch "-f", "--force",
              description: "Remove all mirrors if `--mirror` was not specified."
+      switch "--install-dependencies",
+             description: "Install missing dependencies required to update resources."
       flag   "--python-package-name=",
              description: "Use the specified <package-name> when finding Python resources for <formula>. " \
                           "If no package name is specified, it will be inferred from the formula's stable URL."
@@ -329,6 +331,7 @@ def bump_formula_pr
                                                         package_name:             args.python_package_name,
                                                         extra_packages:           args.python_extra_packages,
                                                         exclude_packages:         args.python_exclude_packages,
+                                                        install_dependencies:     args.install_dependencies?,
                                                         silent:                   args.quiet?,
                                                         ignore_non_pypi_packages: true
     end

Library/Homebrew/dev-cmd/update-python-resources.rb

@@ -19,6 +19,8 @@ def update_python_resources_args
              description: "Suppress any output."
       switch "--ignore-non-pypi-packages",
              description: "Don't fail if <formula> is not a PyPI package."
+      switch "--install-dependencies",
+             description: "Install missing dependencies required to update resources."
       flag   "--version=",
              description: "Use the specified <version> when finding resources for <formula>. " \
                           "If no version is specified, the current version for <formula> will be used."
@@ -43,6 +45,7 @@ def update_python_resources
                                     package_name:             args.package_name,
                                     extra_packages:           args.extra_packages,
                                     exclude_packages:         args.exclude_packages,
+                                    install_dependencies:     args.install_dependencies?,
                                     print_only:               args.print_only?,
                                     silent:                   args.silent?,
                                     verbose:                  args.verbose?,

Library/Homebrew/utils/pypi.rb

@@ -198,14 +198,17 @@
       package_name:             T.nilable(String),
       extra_packages:           T.nilable(T::Array[String]),
       exclude_packages:         T.nilable(T::Array[String]),
+      dependencies:             T.nilable(T::Array[String]),
+      install_dependencies:     T.nilable(T::Boolean),
       print_only:               T.nilable(T::Boolean),
       silent:                   T.nilable(T::Boolean),
       verbose:                  T.nilable(T::Boolean),
       ignore_non_pypi_packages: T.nilable(T::Boolean),
     ).returns(T.nilable(T::Boolean))
   }
   def self.update_python_resources!(formula, version: nil, package_name: nil, extra_packages: nil,
-                                    exclude_packages: nil, print_only: false, silent: false, verbose: false,
+                                    exclude_packages: nil, dependencies: nil, install_dependencies: false,
+                                    print_only: false, silent: false, verbose: false,
                                     ignore_non_pypi_packages: false)
 
     auto_update_list = formula.tap&.pypi_formula_mappings
@@ -224,9 +227,22 @@
         package_name = list_entry["package_name"]
         extra_packages = list_entry["extra_packages"]
         exclude_packages = list_entry["exclude_packages"]
+        dependencies = list_entry["dependencies"]
       end
     end
 
+    missing_dependencies = Array(dependencies).reject do |dependency|
+      Formula[dependency].any_version_installed?
+    rescue FormulaUnavailableError
+      odie "Formula \"#{dependency}\" not found but it is a dependency to update \"#{formula.name}\" resources."
+    end
+    if missing_dependencies.present?
+      missing_msg = "formulae required to update \"#{formula.name}\" resources: #{missing_dependencies.join(", ")}"
+      odie "Missing #{missing_msg}" unless install_dependencies
+      ohai "Installing #{missing_msg}"
+      missing_dependencies.each(&method(:ensure_formula_installed!))
+    end
+
     python_deps = formula.deps
                          .select { |d| d.name.match?(/^python(@.+)?$/) }
                          .map(&:to_formula)

completions/bash/brew

@@ -500,6 +500,7 @@ _brew_bump_formula_pr() {
       --force
       --fork-org
       --help
+      --install-dependencies
       --message
       --mirror
       --no-audit
@@ -2471,6 +2472,7 @@ _brew_update_python_resources() {
       --extra-packages
       --help
       --ignore-non-pypi-packages
+      --install-dependencies
       --package-name
       --print-only
       --quiet

completions/fish/brew.fish

@@ -422,6 +422,7 @@ __fish_brew_complete_arg 'bump-formula-pr' -l dry-run -d 'Print what would be do
 __fish_brew_complete_arg 'bump-formula-pr' -l force -d 'Remove all mirrors if `--mirror` was not specified'
 __fish_brew_complete_arg 'bump-formula-pr' -l fork-org -d 'Use the specified GitHub organization for forking'
 __fish_brew_complete_arg 'bump-formula-pr' -l help -d 'Show this message'
+__fish_brew_complete_arg 'bump-formula-pr' -l install-dependencies -d 'Install missing dependencies required to update resources'
 __fish_brew_complete_arg 'bump-formula-pr' -l message -d 'Prepend message to the default pull request message'
 __fish_brew_complete_arg 'bump-formula-pr' -l mirror -d 'Use the specified URL as a mirror URL. If URL is a comma-separated list of URLs, multiple mirrors will be added'
 __fish_brew_complete_arg 'bump-formula-pr' -l no-audit -d 'Don\'t run `brew audit` before opening the PR'
@@ -1611,6 +1612,7 @@ __fish_brew_complete_arg 'update-python-resources' -l exclude-packages -d 'Exclu
 __fish_brew_complete_arg 'update-python-resources' -l extra-packages -d 'Include these additional packages when finding resources'
 __fish_brew_complete_arg 'update-python-resources' -l help -d 'Show this message'
 __fish_brew_complete_arg 'update-python-resources' -l ignore-non-pypi-packages -d 'Don\'t fail if formula is not a PyPI package'
+__fish_brew_complete_arg 'update-python-resources' -l install-dependencies -d 'Install missing dependencies required to update resources'
 __fish_brew_complete_arg 'update-python-resources' -l package-name -d 'Use the specified package-name when finding resources for formula. If no package name is specified, it will be inferred from the formula\'s stable URL'
 __fish_brew_complete_arg 'update-python-resources' -l print-only -d 'Print the updated resource blocks instead of changing formula'
 __fish_brew_complete_arg 'update-python-resources' -l quiet -d 'Make some output more quiet'

completions/zsh/_brew

@@ -546,6 +546,7 @@ _brew_bump_formula_pr() {
     '--force[Remove all mirrors if `--mirror` was not specified]' \
     '--fork-org[Use the specified GitHub organization for forking]' \
     '--help[Show this message]' \
+    '--install-dependencies[Install missing dependencies required to update resources]' \
     '--message[Prepend message to the default pull request message]' \
     '--mirror[Use the specified URL as a mirror URL. If URL is a comma-separated list of URLs, multiple mirrors will be added]' \
     '(--strict --online)--no-audit[Don'\''t run `brew audit` before opening the PR]' \
@@ -1995,6 +1996,7 @@ _brew_update_python_resources() {
     '--extra-packages[Include these additional packages when finding resources]' \
     '--help[Show this message]' \
     '--ignore-non-pypi-packages[Don'\''t fail if formula is not a PyPI package]' \
+    '--install-dependencies[Install missing dependencies required to update resources]' \
     '--package-name[Use the specified package-name when finding resources for formula. If no package name is specified, it will be inferred from the formula'\''s stable URL]' \
     '--print-only[Print the updated resource blocks instead of changing formula]' \
     '--quiet[Make some output more quiet]' \

docs/Manpage.md

@@ -1129,6 +1129,8 @@ nor vice versa. It must use whichever style specification the formula already us
   Specify the new commit *`revision`* corresponding to the specified git *`tag`* or specified *`version`*.
 * `-f`, `--force`:
   Remove all mirrors if `--mirror` was not specified.
+* `--install-dependencies`:
+  Install missing dependencies required to update resources.
 * `--python-package-name`:
   Use the specified *`package-name`* when finding Python resources for *`formula`*. If no package name is specified, it will be inferred from the formula's stable URL.
 * `--python-extra-packages`:
@@ -1666,6 +1668,8 @@ Update versions for PyPI resource blocks in *`formula`*.
   Suppress any output.
 * `--ignore-non-pypi-packages`:
   Don't fail if *`formula`* is not a PyPI package.
+* `--install-dependencies`:
+  Install missing dependencies required to update resources.
 * `--version`:
   Use the specified *`version`* when finding resources for *`formula`*. If no version is specified, the current version for *`formula`* will be used.
 * `--package-name`:

manpages/brew.1

@@ -1622,6 +1622,10 @@ Specify the new commit \fIrevision\fR corresponding to the specified git \fItag\
 Remove all mirrors if \fB\-\-mirror\fR was not specified\.
 .
 .TP
+\fB\-\-install\-dependencies\fR
+Install missing dependencies required to update resources\.
+.
+.TP
 \fB\-\-python\-package\-name\fR
 Use the specified \fIpackage\-name\fR when finding Python resources for \fIformula\fR\. If no package name is specified, it will be inferred from the formula\'s stable URL\.
 .
@@ -2385,6 +2389,10 @@ Suppress any output\.
 Don\'t fail if \fIformula\fR is not a PyPI package\.
 .
 .TP
+\fB\-\-install\-dependencies\fR
+Install missing dependencies required to update resources\.
+.
+.TP
 \fB\-\-version\fR
 Use the specified \fIversion\fR when finding resources for \fIformula\fR\. If no version is specified, the current version for \fIformula\fR will be used\.
 .