Merge pull request #15491 from Homebrew/maintainer-json

dev-cmd/update-maintainers: write JSON of maintainers

.github/maintainers.json

@@ -0,0 +1 @@
+["Moisan","MikeMcQuaid","singingwolfboy","issyl0","dtrodrigues","dduugg","bayandin","Bo98","reitermarkus","SMillerDev","chenrui333","samford","fxcoudert","EricFromCanada","iMichka","alebcay","miccal","razvanazamfirei","danielnachun","dawidd6","branchvincent","gdams","cho-m","ZhongRuoyu","carlocab","Rylan12","nandahkrishna","bevanjkay","apainintheneck","p-linnane"]

.github/workflows/sponsors-maintainers-man-completions.yml

@@ -66,7 +66,8 @@ jobs:
             git checkout "README.md" \
                          "docs/Manpage.md" \
                          "manpages/brew.1" \
-                         "completions"
+                         "completions" \
+                         ".github/maintainers.json"
           else
             git checkout --no-track -B "${BRANCH}" origin/master
           fi
@@ -83,7 +84,8 @@ jobs:
           then
             git add "README.md" \
                     "docs/Manpage.md" \
-                    "manpages/brew.1"
+                    "manpages/brew.1" \
+                    ".github/maintainers.json"
             git commit -m "Update maintainers." \
                        -m "Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow."
             COMMITTED=true

Library/Homebrew/dev-cmd/update-maintainers.rb

@@ -26,11 +26,15 @@ module Homebrew
 
     # We assume that only public members wish to be included in the README
     public_members = GitHub.public_member_usernames("Homebrew")
+    maintainers = GitHub.members_by_team("Homebrew", "maintainers")
+
+    HOMEBREW_MAINTAINER_JSON.write(maintainers.keys.to_json)
+    maintainer_json_relative_path = HOMEBREW_MAINTAINER_JSON.relative_path_from(HOMEBREW_REPOSITORY).to_s
 
     members = {
       plc:         GitHub.members_by_team("Homebrew", "plc"),
       tsc:         GitHub.members_by_team("Homebrew", "tsc"),
-      maintainers: GitHub.members_by_team("Homebrew", "maintainers"),
+      maintainers: maintainers,
     }
 
     sentences = {}
@@ -53,7 +57,7 @@ module Homebrew
     File.write(readme, content)
 
     diff = system_command "git", args: [
-      "-C", HOMEBREW_REPOSITORY, "diff", "--exit-code", "README.md"
+      "-C", HOMEBREW_REPOSITORY, "diff", "--exit-code", "README.md", maintainer_json_relative_path
     ]
     if diff.status.success?
       ofail "No changes to list of maintainers."

Library/Homebrew/startup/config.rb

@@ -42,6 +42,9 @@ HOMEBREW_CACHE_FORMULA = (HOMEBREW_CACHE/"Formula").freeze
 # Where build, postinstall, and test logs of formulae are written to
 HOMEBREW_LOGS = Pathname(ENV.fetch("HOMEBREW_LOGS")).expand_path.freeze
 
+# Path to the list of Homebrew maintainers as a JSON file
+HOMEBREW_MAINTAINER_JSON = (HOMEBREW_REPOSITORY/".github/maintainers.json").freeze
+
 # Must use `/tmp` instead of `TMPDIR` because long paths break Unix domain sockets
 HOMEBREW_TEMP = Pathname(ENV.fetch("HOMEBREW_TEMP")).then do |tmp|
   tmp.mkpath unless tmp.exist?

docs/Manpage.md

@@ -1853,6 +1853,8 @@ This sanitized build environment ignores unrequested dependencies, which makes s
   `list` Mac App Store dependencies.
 * `--whalebrew`:
   `list` Whalebrew dependencies.
+* `--vscode`:
+  `list` VSCode extensions.
 * `--describe`:
   `dump` adds a description comment above each line, unless the dependency does not have a description.
 * `--no-restart`:

manpages/brew.1

@@ -2651,6 +2651,10 @@ Read the \fBBrewfile\fR from \fB~/\.Brewfile\fR\.
 \fBlist\fR Whalebrew dependencies\.
 .
 .TP
+\fB\-\-vscode\fR
+\fBlist\fR VSCode extensions\.
+.
+.TP
 \fB\-\-describe\fR
 \fBdump\fR adds a description comment above each line, unless the dependency does not have a description\.
 .