git-multi 5.0.0 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5005557fa2d73eb4101db22dd204c876c6188f39a91325fca56610fe0174d399
-  data.tar.gz: '08c86b9b8f3db86b7f9a1e13f9a7a649af8b586933a746f619c8e9d0fb3329ea'
+  metadata.gz: c73ccad592eda6fef60d7911915d0bb1ca5f737ca2345fefda0df535b58a3a5b
+  data.tar.gz: 576070b973791f819e005dbac1d1df64f45bdcde6e998a2677f7212e046933c8
 SHA512:
-  metadata.gz: 864abb46e6adc5a22072b831631dcb1b5daedc45fcccbc8a0207ed47fb28896b183cca26efdb191771b5df7bc4c44265bb14af9c3cf6456bab6d05c4a708401c
-  data.tar.gz: 4aba904daae482a352e7aef74ad47bcaa5ee56085ea59f092a52c0d0bf92294e0db7e901f1e0d9f10c4c201943afea151bfecf099475cb32e08d9979b1d29a97
+  metadata.gz: 6e8d0b3afb014f47cc25b31e5194b64d25393fa5554417f47ca73c52a1326e020365dbeb0be72becbdfb4b7b4eaad12c7119d703e6b6fa39761de89b29c7c589
+  data.tar.gz: fe03a9afbad48fc226683800286a0da9d9331b96b55c4896ee56c3da75b6c3ef6e52726917b3c60953046cec2619cc7a84ad90e43eadab9a0c79f9c7e925a930

data/.gitignore

@@ -7,3 +7,4 @@
 /spec/reports/
 /tmp/
 /vendor/
+Brewfile.lock.json

data/.pryrc

@@ -4,11 +4,13 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'git/multi'
 
 # this loads all 'git multi' contribs
+# rubocop:disable Lint/NonDeterministicRequireOrder
 Dir.glob File.join(__dir__, 'contrib', '**', '*.rb'), &method(:require)
+# rubocop:enable Lint/NonDeterministicRequireOrder
 
 # configure a logger
 require 'logger'
-logger = Logger.new(STDOUT)
+logger = Logger.new($stdout)
 logger.level = Logger::INFO
 
 # configure Octokit middleware with logger

data/.rubocop.yml

@@ -6,6 +6,10 @@ AllCops:
     - 'tmp/*'
     - 'pkg/*'
 
+require:
+  - rubocop-minitest
+  - rubocop-rake
+
 Layout/LineLength:
   Enabled: false
 
@@ -19,6 +23,9 @@ Metrics/MethodLength:
 Metrics/ModuleLength:
   Enabled: false
 
+Rake/Desc:
+  Enabled: false
+
 Style/BlockDelimiters:
   Enabled: false
 Style/Documentation:
@@ -38,3 +45,7 @@ Style/TrailingCommaInArrayLiteral:
   Enabled: false
 Style/TrailingCommaInHashLiteral:
   Enabled: false
+
+# https://github.com/rubocop/rubocop/issues/10394
+Style/SwapValues:
+  Enabled: false

data/.ruby-version

@@ -1 +1 @@
-2.6.6
+2.6.10

data/Gemfile.lock

@@ -1,56 +1,84 @@
 PATH
   remote: .
   specs:
-    git-multi (5.0.0)
+    git-multi (8.0.0)
       faraday (~> 1)
       octokit (~> 4)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.7.0)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
-    ast (2.4.1)
+    ast (2.4.2)
     coderay (1.1.3)
-    faraday (1.0.1)
-      multipart-post (>= 1.2, < 3)
+    faraday (1.10.0)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.0)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      faraday-retry (~> 1.0)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-multipart (1.0.4)
+      multipart-post (~> 2)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    faraday-retry (1.0.3)
     interception (0.5)
+    json (2.6.2)
     method_source (1.0.0)
-    minitest (5.14.1)
-    multipart-post (2.1.1)
-    octokit (4.18.0)
-      faraday (>= 0.9)
-      sawyer (~> 0.8.0, >= 0.5.3)
-    parallel (1.19.2)
-    parser (2.7.1.4)
+    minitest (5.16.2)
+    multipart-post (2.2.3)
+    octokit (4.25.1)
+      faraday (>= 1, < 3)
+      sawyer (~> 0.9)
+    parallel (1.22.1)
+    parser (3.1.2.0)
       ast (~> 2.4.1)
-    pry (0.13.1)
+    pry (0.14.1)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-rescue (1.5.1)
+    pry-rescue (1.5.2)
       interception (>= 0.5)
       pry (>= 0.12.0)
-    public_suffix (4.0.5)
-    rainbow (3.0.0)
-    rake (13.0.1)
-    regexp_parser (1.7.1)
-    rexml (3.2.4)
-    rubocop (0.85.1)
+    public_suffix (4.0.7)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.5.0)
+    rexml (3.2.5)
+    rubocop (1.32.0)
+      json (~> 2.3)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 3.1.0.0)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.7)
-      rexml
-      rubocop-ast (>= 0.0.3)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.19.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 2.0)
-    rubocop-ast (0.0.3)
-      parser (>= 2.7.0.1)
-    ruby-progressbar (1.10.1)
-    sawyer (0.8.2)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.19.1)
+      parser (>= 3.1.1.0)
+    rubocop-minitest (0.20.1)
+      rubocop (>= 0.90, < 2.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    sawyer (0.9.2)
       addressable (>= 2.3.5)
-      faraday (> 0.8, < 2.0)
-    unicode-display_width (1.7.0)
+      faraday (>= 0.17.3, < 3)
+    unicode-display_width (2.2.0)
 
 PLATFORMS
   ruby
@@ -63,6 +91,8 @@ DEPENDENCIES
   pry-rescue
   rake
   rubocop
+  rubocop-minitest
+  rubocop-rake
 
 BUNDLED WITH
-   2.1.4
+   2.3.19

data/README.md

@@ -35,6 +35,8 @@ There are plenty of other utilities out there that do something similar, but typ
 
 ## Usage
 
+Installing the gem installs the `git-multi` executable on your system's `${PATH}`, which means it can be run as a so-called [git subcommand](https://git.github.io/htmldocs/howto/new-command.html#:~:text=Runtime%20environment), as follows: `git multi`; a good starting point is:
+
     $ git multi --help
 
 ## Known Issues

data/bin/console

@@ -6,4 +6,7 @@ require 'git/multi'
 require 'pry'
 Pry.start
 
+# require "irb"
+# IRB.start(__FILE__)
+
 # That's all Folks!

data/exe/git-multi

@@ -6,11 +6,11 @@ require 'git/multi'
 
 multi_repo = command = nil
 
-if !STDIN.tty?
-  # read list of repo full names from STDIN (~pseudo multi-repo)
-  multi_repo = STDIN.readlines.map(&:strip).map(&:freeze).freeze
-  # reopen STDIN (to ensure all `Kernel.system` based cmds work)
-  STDIN.reopen('/dev/tty')
+if !$stdin.tty?
+  # read list of repo full names from $stdin (~pseudo multi-repo)
+  multi_repo = $stdin.readlines.map(&:strip).map(&:freeze).freeze
+  # reopen $stdin (to ensure all `Kernel.system` based cmds work)
+  $stdin.reopen('/dev/tty')
 elsif (command = ARGV.shift)&.start_with?('++')
   multi_repo = command.delete('++')
   command = nil

data/git-multi.gemspec

@@ -14,7 +14,17 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/pvdb/git-multi'
   spec.license       = 'MIT'
 
-  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
+  spec.required_ruby_version = ['>= 2.6.0', '< 3.0.0']
+
+  spec.metadata['homepage_uri']    = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri']   = File.join(spec.homepage, 'blob', 'master', 'README.md')
+
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`
       .split("\x0")
       .reject { |f| f.match(%r{^(test|spec|features)/}) }
@@ -34,4 +44,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'pry-rescue'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-minitest'
+  spec.add_development_dependency 'rubocop-rake'
 end

data/lib/ext/string.rb

@@ -1,5 +1,4 @@
 class String
-  # rubocop:disable Layout/EmptyLineBetweenDefs
   # rubocop:disable Style/SingleLineMethods
   def colorize(color_code) "\e[#{color_code}m#{self}\e[0m"; end
 
@@ -12,5 +11,4 @@ class String
 
   def undent() gsub(/^.{#{slice(/^ +/).length}}/, ''); end
   # rubocop:enable Style/SingleLineMethods
-  # rubocop:enable Layout/EmptyLineBetweenDefs
 end

data/lib/git/hub.rb

@@ -4,7 +4,7 @@ begin
   require 'net/http/persistent'
   if Octokit.middleware.adapter == Faraday::Adapter::NetHttp
     adapter = Faraday::RackBuilder::Handler.new(Faraday::Adapter::NetHttpPersistent)
-    Octokit.middleware.instance_variable_set(:'@adapter', adapter)
+    Octokit.middleware.instance_variable_set(:@adapter, adapter)
   end
 rescue LoadError
   # NOOP  -  `Net::HTTP::Persistent` is optional, so
@@ -29,31 +29,31 @@ module Git
 
     def connected?
       @connected ||= begin
-                       client.validate_credentials
-                       true
-                     rescue Faraday::ConnectionFailed
-                       false
-                     end
+        client.validate_credentials
+        true
+      rescue Faraday::ConnectionFailed
+        false
+      end
     end
 
     # FIXME: update login as part of `--refresh`
 
     def login
       @login ||= begin
-                   client.user.login
-                 rescue Octokit::Unauthorized, Faraday::ConnectionFailed
-                   nil
-                 end
+        client.user.login
+      rescue Octokit::Unauthorized, Faraday::ConnectionFailed
+        nil
+      end
     end
 
     # FIXME: update orgs as part of `--refresh`
 
     def orgs
       @orgs ||= begin
-                  client.organizations.map(&:login)
-                rescue Octokit::Unauthorized, Faraday::ConnectionFailed
-                  []
-                end
+        client.organizations.map(&:login)
+      rescue Octokit::Unauthorized, Faraday::ConnectionFailed
+        []
+      end
     end
 
     # pick a (semi-)random repo from GitHub
@@ -76,10 +76,10 @@ module Git
 
     @user_repositories = Hash.new { |repos, (user, type)|
       repos[[user, type]] = begin
-                              client
-                                .repositories(user, type: type)
-                                .sort_by { |repo| repo[:name].downcase }
-                            end
+        client
+          .repositories(user, type: type)
+          .sort_by { |repo| repo[:name].downcase }
+      end
     }
 
     def user_repositories(user, type = :owner)
@@ -93,10 +93,10 @@ module Git
 
     @org_repositories = Hash.new { |repos, (org, type)|
       repos[[org, type]] = begin
-                             client
-                               .org_repositories(org, type: type)
-                               .sort_by { |repo| repo[:name].downcase }
-                           end
+        client
+          .org_repositories(org, type: type)
+          .sort_by { |repo| repo[:name].downcase }
+      end
     }
 
     def org_repositories(org, type = :owner)

data/lib/git/multi/commands.rb

@@ -133,7 +133,7 @@ module Git
             begin
               if repository.instance_eval(commands.join(' && '))
                 repository.just_do_it(
-                  ->(_repo) { nil },
+                  ->(_repo) {}, # empty lambda: nil
                   ->(repo) { puts repo.full_name },
                 )
               end

data/lib/git/multi/config.rb

@@ -7,8 +7,8 @@ module Git
       value.empty? && default ? default : value
     end
 
-    def full_names_for(superproject)
-      list = `git config --get-all superproject.#{superproject}.repo`
+    def global_options(name)
+      list = `git config --global --get-all #{name}`
       list.split($RS).map(&:strip).map(&:freeze)
     end
 
@@ -22,8 +22,7 @@ module Git
     end
 
     def env_var(name, default = nil)
-      value = ENV[name]
-      (value.nil? || value.empty?) && default ? default : value
+      ENV.fetch(name, default)
     end
   end
 end

data/lib/git/multi/gemspec.rb

@@ -16,6 +16,13 @@ module Git
 
       \tgit config --global --add \033[1mgit.multi.workarea\033[0m <your_root_workarea>
 
+      You can specify a list of user or organization repositories to ignore:
+
+      \tgit config --global --add \033[1mgit.multi.exclude\033[0m <org_name>/<repo_name>
+      \tgit config --global --add \033[1mgit.multi.exclude\033[0m <user_name>/<repo_name>
+
+      (can be used multiple times to exclude multiple user or organization repositories)
+
       Thanks for using \033[1mgit multi\033[0m ... the ultimate multi-repo utility for git!
 
     PIM

data/lib/git/multi/report.rb

@@ -33,7 +33,10 @@ module Git
         setting_status(["\tGitHub ", "#{github_count} repositories"])
         setting_status(["\tcloned ", cloned_count, "(#{missing_count} missing)"])
         Git::Multi.missing_repositories_for(owner).each do |missing|
-          setting_status(["\tmissing", missing.full_name], false, false)
+          setting_status(["\tmissing", missing.full_name], valid: false, optional: false)
+        end
+        Git::Multi.excluded_repositories_for(owner).each do |excluded|
+          setting_status(["\texcluded", excluded.full_name], valid: false, optional: false)
         end
         setting_status(["\tsubdirs", subdir_count, "(#{surplus_count} surplus)"])
       end
@@ -42,14 +45,14 @@ module Git
         github_count = Git::Multi.repositories_for(superproject).count
 
         if github_count.zero?
-          setting_status([message, 'listed but not configured'], false, false)
+          setting_status([message, 'listed but not configured'], valid: false, optional: false)
         else
-          setting_status([message], true)
+          setting_status([message], valid: true)
           Git::Multi.repositories_for(superproject).each do |repo|
             if File.directory? repo.local_path
-              setting_status(["\tcloned ", repo.full_name], true)
+              setting_status(["\tcloned ", repo.full_name], valid: true)
             else
-              setting_status(["\tmissing", repo.full_name], false, false)
+              setting_status(["\tmissing", repo.full_name], valid: false, optional: false)
             end
           end
         end
@@ -102,7 +105,7 @@ module Git
         end
       end
 
-      private_class_method def setting_status(messages, valid = false, optional = true)
+      private_class_method def setting_status(messages, valid: false, optional: true)
         fields = messages.compact.join(' - ')
         icon = valid ? TICK : optional ? ARROW : CROSS
         puts "#{icon}  #{fields}"
@@ -115,16 +118,16 @@ module Git
             abbreviate(file),
             File.file?(file) ? "#{File.size(file).commify} bytes" : nil,
           ],
-          file && !file.empty? && File.file?(file),
-          false
+          valid: file && !file.empty? && File.file?(file),
+          optional: false,
         )
       end
 
       private_class_method def directory_status(messages, directory)
         setting_status(
           messages,
-          directory && !directory.empty? && File.directory?(directory),
-          false
+          valid: directory && !directory.empty? && File.directory?(directory),
+          optional: false,
         )
       end
     end

data/lib/git/multi/version.rb

@@ -1,7 +1,7 @@
 module Git
   module Multi
     NAME = 'git-multi'.freeze
-    VERSION = '5.0.0'.freeze
+    VERSION = '8.0.0'.freeze
 
     def self.version
       "#{NAME} v#{VERSION}"

data/lib/git/multi.rb

@@ -36,9 +36,6 @@ module Git
     TOKEN            = global_option('github.token', DEFAULT_TOKEN)
 
     GIT_MULTI_DIR    = File.join(HOME, '.git', 'multi')
-
-    FileUtils.mkdir_p(GIT_MULTI_DIR) # ensure `~/.git/multi` directory exists
-
     GITHUB_CACHE     = File.join(GIT_MULTI_DIR, 'repositories.byte')
 
     USERS            = global_list('git.multi.users')
@@ -46,6 +43,7 @@ module Git
     SUPERPROJECTS    = global_list('git.multi.superprojects')
 
     MULTI_REPOS      = (USERS + ORGANIZATIONS + SUPERPROJECTS)
+    EXCLUDED_REPOS   = global_options('git.multi.exclude')
 
     MAN_PAGE         = File.expand_path('../../man/git-multi.1', __dir__)
     HTML_PAGE        = File.expand_path('../../man/git-multi.html', __dir__)
@@ -129,6 +127,9 @@ module Git
     #
 
     def refresh_repositories
+      # ensure `~/.git/multi` directory exists
+      FileUtils.mkdir_p(GIT_MULTI_DIR)
+
       File.open(GITHUB_CACHE, 'wb') do |file|
         Marshal.dump(github_repositories, file)
       end
@@ -148,15 +149,15 @@ module Git
                       else Dir.pwd
                       end
         Dir.chdir(working_dir) do
-          if STDOUT.tty? && STDERR.tty?
-            STDOUT.puts "#{full_name.invert} (#{fractional_index})"
+          if $stdout.tty? && $stderr.tty?
+            $stdout.puts "#{full_name.invert} (#{fractional_index})"
             interactive.call(self)
-          elsif STDERR.tty? && captured
-            errors = File.join(ENV['TMPDIR'], "git-multi.#{$PID}")
+          elsif $stderr.tty? && captured
+            errors = File.join(Dir.tmpdir, "git-multi.#{$PID}")
             captured.call(self, errors)
             if File.exist?(errors) && !File.zero?(errors)
               # rubocop:disable Style/StderrPuts
-              STDERR.puts "#{full_name.invert} (#{fractional_index})"
+              $stderr.puts "#{full_name.invert} (#{fractional_index})"
               Kernel.system "cat #{errors} > /dev/tty ;"
               # rubocop:enable Style/StderrPuts
             end
@@ -194,8 +195,10 @@ module Git
             repo.parent_dir = Pathname.new(File.join(WORKAREA, repo.owner.login))
             repo.local_path = Pathname.new(File.join(WORKAREA, repo.full_name))
             repo.fractional_index = "#{index + 1}/#{repos.count}"
+            # git multi will "hard ignore" all excluded repos
+            repo.excluded = EXCLUDED_REPOS.include?(repo.full_name)
             # fix 'repo' => https://github.com/octokit/octokit.rb/issues/727
-            repo.compliant_ssh_url = 'ssh://' + repo.ssh_url.split(':', 2).join('/')
+            repo.compliant_ssh_url = "ssh://#{repo.ssh_url.split(':', 2).join('/')}"
             # remove optional '.git' suffix from 'git@github.com:pvdb/git-multi.git'
             repo.abbreviated_ssh_url = repo.ssh_url.chomp('.git')
             # extend 'repo' with 'just do it' capabilities
@@ -213,7 +216,11 @@ module Git
     # lists of repos for a given multi-repo
     #
 
-    def repositories_for(multi_repo = nil)
+    def full_names_for(superproject)
+      global_options("superproject.#{superproject}.repo")
+    end
+
+    def all_repositories_for(multi_repo = nil)
       case (owner = superproject = full_names = multi_repo)
       when nil
         repositories # all of them
@@ -226,26 +233,34 @@ module Git
           repository.owner.login == owner
         }
       when *SUPERPROJECTS
-        repositories_for(full_names_for(superproject))
+        all_repositories_for(full_names_for(superproject))
       else
         raise ArgumentError, multi_repo
       end
     end
 
+    def repositories_for(multi_repo = nil)
+      all_repositories_for(multi_repo).delete_if(&:excluded)
+    end
+
     #
     # lists of repositories with a given state
     #
 
     def archived_repositories_for(multi_repo = nil)
-      repositories_for(multi_repo).find_all(&:archived)
+      all_repositories_for(multi_repo).find_all(&:archived)
     end
 
     def forked_repositories_for(multi_repo = nil)
-      repositories_for(multi_repo).find_all(&:fork)
+      all_repositories_for(multi_repo).find_all(&:fork)
     end
 
     def private_repositories_for(multi_repo = nil)
-      repositories_for(multi_repo).find_all(&:private)
+      all_repositories_for(multi_repo).find_all(&:private)
+    end
+
+    def excluded_repositories_for(multi_repo = nil)
+      all_repositories_for(multi_repo).find_all(&:excluded)
     end
 
     #

data/man/git-multi.1

@@ -2,12 +2,12 @@
 .\"     Title: git-multi
 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 06/20/2020
+.\"      Date: 07/30/2022
 .\"    Manual: Git Manual
-.\"    Source: Git 2.27.0.112.g101b3204f3.dirty
+.\"    Source: Git 2.35.1.455.g1a4874565f.dirty
 .\"  Language: English
 .\"
-.TH "GIT\-MULTI" "1" "06/20/2020" "Git 2\&.27\&.0\&.112\&.g101b32" "Git Manual"
+.TH "GIT\-MULTI" "1" "07/30/2022" "Git 2\&.35\&.1\&.455\&.g1a4874" "Git Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -31,7 +31,7 @@
 git-multi \- execute the same git command in multiple repositories
 .SH "VERSION"
 .sp
-This is \fBv5\&.0\&.0\fR of \fIgit multi\fR \&... hooray!
+This is \fBv8\&.0\&.0\fR of \fIgit multi\fR \&... hooray!
 .SH "SYNOPSIS"
 .sp
 There are some options for \fBgit multi\fR itself, in which case it is invoked as follows:
@@ -490,32 +490,34 @@ The following is a list of valid arguments for the \fBgit multi \-\-query\fR opt
 .RS 4
 .\}
 .nf
-archive_url          archived             assignees_url
-blobs_url            branches_url         clone_url
-collaborators_url    comments_url         commits_url
-compare_url          contents_url         contributors_url
-created_at           default_branch       deployments_url
-description          disabled             downloads_url
-events_url           fork                 forks
-forks_count          forks_url            full_name
-git_commits_url      git_refs_url         git_tags_url
-git_url              has_downloads        has_issues
-has_pages            has_projects         has_wiki
-homepage             hooks_url            html_url
-id                   issue_comment_url    issue_events_url
-issues_url           keys_url             labels_url
-language             languages_url        license
-merges_url           milestones_url       mirror_url
-name                 network_count        node_id
-notifications_url    open_issues          open_issues_count
-organization         owner                permissions
-private              pulls_url            pushed_at
-releases_url         size                 ssh_url
-stargazers_count     stargazers_url       statuses_url
-subscribers_count    subscribers_url      subscription_url
-svn_url              tags_url             teams_url
-temp_clone_token     trees_url            updated_at
-url                  watchers             watchers_count
+allow_forking        archive_url          archived
+assignees_url        blobs_url            branches_url
+clone_url            collaborators_url    comments_url
+commits_url          compare_url          contents_url
+contributors_url     created_at           default_branch
+deployments_url      description          disabled
+downloads_url        events_url           fork
+forks                forks_count          forks_url
+full_name            git_commits_url      git_refs_url
+git_tags_url         git_url              has_downloads
+has_issues           has_pages            has_projects
+has_wiki             homepage             hooks_url
+html_url             id                   is_template
+issue_comment_url    issue_events_url     issues_url
+keys_url             labels_url           language
+languages_url        license              merges_url
+milestones_url       mirror_url           name
+network_count        node_id              notifications_url
+open_issues          open_issues_count    organization
+owner                permissions          private
+pulls_url            pushed_at            releases_url
+size                 ssh_url              stargazers_count
+stargazers_url       statuses_url         subscribers_count
+subscribers_url      subscription_url     svn_url
+tags_url             teams_url            temp_clone_token
+topics               trees_url            updated_at
+url                  visibility           watchers
+watchers_count       web_commit_signoff_required
 .fi
 .if n \{\
 .RE
@@ -545,6 +547,33 @@ git multi \-\-json | jq \-r \*(Aq\&.[] | select(\&.fork == true) | \&.full_name\
 .if n \{\
 .RE
 .\}
+.SH "CHAINED INVOCATION"
+.sp
+When \fBgit multi\fR gets its input from a Unix pipeline \fI(as opposed to from a TTY)\fR, it constructs an "implicit" multi repo comprised of the "full" repo names it reads from \fBSTDIN\fR \fI(one full repo name per line)\fR\&.
+.sp
+This allows multiple \fBgit multi\fR invocations to be chained, for example by using the \fB\-\-json\fR or \fB\-\-find\fR options as follows:
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+# run a git query or subcommand on repos that aren\*(Aqt archived (on GitHub)
+git multi ++<multi_repo> \-\-json | jq \-r \*(Aq\&.[] | select(\&."archived" == false) | \&."full_name"\*(Aq | git multi <git_command>
+.fi
+.if n \{\
+.RE
+.\}
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+# run a shell command inside repos that have Ruby as their main language
+git multi ++<multi_repo> \-\-find \*(Aqlanguage == "Ruby"\*(Aq | git multi \-\-raw \*(Aqcat \&.ruby\-version\*(Aq
+.fi
+.if n \{\
+.RE
+.\}
 .SH "FILES"
 .PP
 \fB${HOME}/Workarea\fR
@@ -556,11 +585,6 @@ root directory where repos will been cloned
 .RS 4
 local, binary cache of GitHub repository metadata
 .RE
-.PP
-\fB${HOME}/\&.git/multi/superprojects\&.config\fR
-.RS 4
-definitions for so\-called "superproject" multi\-repos
-.RE
 .SH "REFERENCES"
 .sp
 .RS 4

data/man/git-multi.erb

@@ -246,6 +246,19 @@ are some examples:
  # print out the name of all "forked" repositories
  git multi --json | jq -r '.[] | select(.fork == true) | .full_name'
 
+CHAINED INVOCATION
+------------------
+
+When `git multi` gets its input from a Unix pipeline _(as opposed to from a TTY)_, it constructs an "implicit" multi repo comprised of the "full" repo names it reads from `STDIN` _(one full repo name per line)_.
+
+This allows multiple `git multi` invocations to be chained, for example by using the `--json` or `--find` options as follows:
+
+ # run a git query or subcommand on repos that aren't archived (on GitHub)
+ git multi ++<multi_repo> --json | jq -r '.[] | select(."archived" == false) | ."full_name"' | git multi <git_command>
+
+ # run a shell command inside repos that have Ruby as their main language
+ git multi ++<multi_repo> --find 'language == "Ruby"' | git multi --raw 'cat .ruby-version'
+
 FILES
 -----
 
@@ -255,9 +268,6 @@ FILES
 `${HOME}/.git/multi/repositories.byte`::
 	local, binary cache of GitHub repository metadata
 
-`${HOME}/.git/multi/superprojects.config`::
-	definitions for so-called "superproject" multi-repos
-
 REFERENCES
 ----------
 

data/man/git-multi.html

@@ -4,7 +4,7 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 9.0.0" />
+<meta name="generator" content="AsciiDoc 10.2.0" />
 <title>git-multi(1)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -748,7 +748,7 @@ git-multi(1) Manual Page
 <div class="sect1">
 <h2 id="_version">VERSION</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>This is <code>v5.0.0</code> of <em>git multi</em> &#8230; hooray!</p></div>
+<div class="paragraph"><p>This is <code>v8.0.0</code> of <em>git multi</em> &#8230; hooray!</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1113,32 +1113,34 @@ and cached locally <em>(in binary format)</em> for performance and offline usage
 <div class="paragraph"><p>The following is a list of valid arguments for the <code>git multi --query</code> option:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><code>archive_url          archived             assignees_url
-blobs_url            branches_url         clone_url
-collaborators_url    comments_url         commits_url
-compare_url          contents_url         contributors_url
-created_at           default_branch       deployments_url
-description          disabled             downloads_url
-events_url           fork                 forks
-forks_count          forks_url            full_name
-git_commits_url      git_refs_url         git_tags_url
-git_url              has_downloads        has_issues
-has_pages            has_projects         has_wiki
-homepage             hooks_url            html_url
-id                   issue_comment_url    issue_events_url
-issues_url           keys_url             labels_url
-language             languages_url        license
-merges_url           milestones_url       mirror_url
-name                 network_count        node_id
-notifications_url    open_issues          open_issues_count
-organization         owner                permissions
-private              pulls_url            pushed_at
-releases_url         size                 ssh_url
-stargazers_count     stargazers_url       statuses_url
-subscribers_count    subscribers_url      subscription_url
-svn_url              tags_url             teams_url
-temp_clone_token     trees_url            updated_at
-url                  watchers             watchers_count</code></pre>
+<pre><code>allow_forking        archive_url          archived
+assignees_url        blobs_url            branches_url
+clone_url            collaborators_url    comments_url
+commits_url          compare_url          contents_url
+contributors_url     created_at           default_branch
+deployments_url      description          disabled
+downloads_url        events_url           fork
+forks                forks_count          forks_url
+full_name            git_commits_url      git_refs_url
+git_tags_url         git_url              has_downloads
+has_issues           has_pages            has_projects
+has_wiki             homepage             hooks_url
+html_url             id                   is_template
+issue_comment_url    issue_events_url     issues_url
+keys_url             labels_url           language
+languages_url        license              merges_url
+milestones_url       mirror_url           name
+network_count        node_id              notifications_url
+open_issues          open_issues_count    organization
+owner                permissions          private
+pulls_url            pushed_at            releases_url
+size                 ssh_url              stargazers_count
+stargazers_url       statuses_url         subscribers_count
+subscribers_url      subscription_url     svn_url
+tags_url             teams_url            temp_clone_token
+topics               trees_url            updated_at
+url                  visibility           watchers
+watchers_count       web_commit_signoff_required</code></pre>
 </div></div>
 </div>
 </div>
@@ -1162,6 +1164,23 @@ git multi --json | jq -r '.[] | select(.fork == true) | .full_name'</code></pre>
 </div>
 </div>
 <div class="sect1">
+<h2 id="_chained_invocation">CHAINED INVOCATION</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>When <code>git multi</code> gets its input from a Unix pipeline <em>(as opposed to from a TTY)</em>, it constructs an "implicit" multi repo comprised of the "full" repo names it reads from <code>STDIN</code> <em>(one full repo name per line)</em>.</p></div>
+<div class="paragraph"><p>This allows multiple <code>git multi</code> invocations to be chained, for example by using the <code>--json</code> or <code>--find</code> options as follows:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># run a git query or subcommand on repos that aren't archived (on GitHub)
+git multi ++&lt;multi_repo&gt; --json | jq -r '.[] | select(."archived" == false) | ."full_name"' | git multi &lt;git_command&gt;</code></pre>
+</div></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># run a shell command inside repos that have Ruby as their main language
+git multi ++&lt;multi_repo&gt; --find 'language == "Ruby"' | git multi --raw 'cat .ruby-version'</code></pre>
+</div></div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_files">FILES</h2>
 <div class="sectionbody">
 <div class="dlist"><dl>
@@ -1181,14 +1200,6 @@ git multi --json | jq -r '.[] | select(.fork == true) | .full_name'</code></pre>
         local, binary cache of GitHub repository metadata
 </p>
 </dd>
-<dt class="hdlist1">
-<code>${HOME}/.git/multi/superprojects.config</code>
-</dt>
-<dd>
-<p>
-        definitions for so-called "superproject" multi-repos
-</p>
-</dd>
 </dl></div>
 </div>
 </div>
@@ -1222,7 +1233,7 @@ the <code>jq</code> command-line utility:
 <div id="footer">
 <div id="footer-text">
 Last updated
- 2020-06-20 07:51:21 BST
+ 2022-07-30 10:20:13 BST
 </div>
 </div>
 </body>

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: git-multi
 version: !ruby/object:Gem::Version
-  version: 5.0.0
+  version: 8.0.0
 platform: ruby
 authors:
 - Peter Vandenberk
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-06-20 00:00:00.000000000 Z
+date: 2022-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -122,6 +122,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Run the same git command in a set of related repos
 email:
 - pvandenberk@mac.com
@@ -165,14 +193,22 @@ files:
 homepage: https://github.com/pvdb/git-multi
 licenses:
 - MIT
-metadata: {}
+metadata:
+  homepage_uri: https://github.com/pvdb/git-multi
+  source_code_uri: https://github.com/pvdb/git-multi
+  changelog_uri: https://github.com/pvdb/git-multi/blob/master/README.md
+  rubygems_mfa_required: 'true'
 post_install_message: "\nThe only required setting for \e[1mgit multi\e[0m is:\n\n\tgit
   config --global --add \e[1mgithub.token\e[0m <your_github_oauth_token>\n\nThe following
   settings for \e[1mgit multi\e[0m are\noptional, and take 0, 1 or more values:\n\n\tgit
   config --global --add \e[1mgit.multi.users\e[0m <list_of_github_users>\n\tgit config
   --global --add \e[1mgit.multi.organizations\e[0m <list_of_github_orgs>\n\nUnless
   your top-level workarea is `${HOME}/Workarea` you should also set:\n\n\tgit config
-  --global --add \e[1mgit.multi.workarea\e[0m <your_root_workarea>\n\nThanks for using
+  --global --add \e[1mgit.multi.workarea\e[0m <your_root_workarea>\n\nYou can specify
+  a list of user or organization repositories to ignore:\n\n\tgit config --global
+  --add \e[1mgit.multi.exclude\e[0m <org_name>/<repo_name>\n\tgit config --global
+  --add \e[1mgit.multi.exclude\e[0m <user_name>/<repo_name>\n\n(can be used multiple
+  times to exclude multiple user or organization repositories)\n\nThanks for using
   \e[1mgit multi\e[0m ... the ultimate multi-repo utility for git!\n\n"
 rdoc_options: []
 require_paths:
@@ -181,14 +217,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.6.0
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.3.1
 signing_key:
 specification_version: 4
 summary: The ultimate multi-repo utility for git!