git-multi 4.0.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ae3ea0db8c3ed8b96a4c03075a8fc03776e263dc
-  data.tar.gz: f5bc88dda1be61636658ecdb265afed9059d81de
+SHA256:
+  metadata.gz: 0124014ecd67cbda989511455a0a46878a40365660a613337c87b35813a48af8
+  data.tar.gz: 46971c1b9b60f26a13eb67453d5ab0f9e88bbcf795ed6709b26b6511d8c341c4
 SHA512:
-  metadata.gz: ae0f27414bc44b20290191c1e126bea2a75fb248bbf64a0f361ffc606a0b55d6fd3f916185874ad6afdb24821972002adbd95c9b05aea47a09e19278c76f881f
-  data.tar.gz: 94649a8d55edbcc6a4ef5e90313d6e46c9357ac87117036e555c17abba1a0609f64d1e5b79d1734b42797cf163e90482c21676fc4ea6daeae4495b327e04a931
+  metadata.gz: f9061a4c54c89b1eb6ad29949e0c72c6d4d2aadce7e37e498cfc5b2ecd8cbd769685e81d9f188b9d12aea30079d7fbb71944de86a6910a66f2734a074a807eea
+  data.tar.gz: 58c513e28b65dcd040b8ac1bf29c62c7130dcf848f0f106db2052ff7578381260b30c4f182c30ba61b4f819cb0a55fd72c9c8773a8a5d08dd3d48b5b93e65f2f

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
-Dir.glob File.join(__dir__, 'contrib', '*', '*.rb'), &method(:require)
+# 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
@@ -28,15 +30,21 @@ end
 
 # utility function to set pry context
 # to an instance of <Octokit::Client>
-def client() pry(Git::Hub.send(:client)); end
+def client
+  pry(Git::Hub.send(:client))
+end
 
 # utility function to set pry context
 # to the Array of github repositories
-def repos() pry(Git::Multi.repositories); end
+def repos
+  pry(Git::Multi.repositories)
+end
 
 # utility function to set pry context
 # to the various 'git multi' commands:
-def cmds() pry(Git::Multi::Commands); end
+def cmds
+  pry(Git::Multi::Commands)
+end
 
 # utility function to set context
 # to the named github repository:

data/.rubocop.yml

@@ -1,14 +1,15 @@
 AllCops:
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.6
+  NewCops: enable
   Exclude:
     - 'doc/*'
     - 'tmp/*'
     - 'pkg/*'
 
-Layout/EmptyLinesAroundClassBody:
-  Enabled: false
-Layout/EmptyLinesAroundModuleBody:
-  Enabled: false
+require:
+  - rubocop-minitest
+  - rubocop-rake
+
 Layout/LineLength:
   Enabled: false
 
@@ -22,6 +23,9 @@ Metrics/MethodLength:
 Metrics/ModuleLength:
   Enabled: false
 
+Rake/Desc:
+  Enabled: false
+
 Style/BlockDelimiters:
   Enabled: false
 Style/Documentation:
@@ -34,11 +38,14 @@ Style/NestedTernaryOperator:
   Enabled: false
 Style/RedundantBegin:
   Enabled: false
-Style/SingleLineMethods:
-  Enabled: false
+
 Style/TrailingCommaInArguments:
   Enabled: false
 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.3.8
+2.6.9

data/Gemfile.lock

@@ -1,51 +1,82 @@
 PATH
   remote: .
   specs:
-    git-multi (4.0.0)
-      faraday (>= 0.9)
+    git-multi (7.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.0)
-    coderay (1.1.2)
-    faraday (1.0.0)
+    ast (2.4.2)
+    coderay (1.1.3)
+    faraday (1.9.3)
+      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.3)
       multipart-post (>= 1.2, < 3)
+    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)
-    jaro_winkler (1.5.4)
-    method_source (0.9.2)
-    minitest (5.14.0)
+    method_source (1.0.0)
+    minitest (5.15.0)
     multipart-post (2.1.1)
-    octokit (4.15.0)
+    octokit (4.22.0)
       faraday (>= 0.9)
       sawyer (~> 0.8.0, >= 0.5.3)
-    parallel (1.19.1)
-    parser (2.7.0.2)
-      ast (~> 2.4.0)
-    pry (0.12.2)
-      coderay (~> 1.1.0)
-      method_source (~> 0.9.0)
-    pry-rescue (1.5.0)
+    parallel (1.21.0)
+    parser (3.1.0.0)
+      ast (~> 2.4.1)
+    pry (0.14.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-rescue (1.5.2)
       interception (>= 0.5)
       pry (>= 0.12.0)
-    public_suffix (4.0.3)
-    rainbow (3.0.0)
-    rake (13.0.1)
-    rubocop (0.79.0)
-      jaro_winkler (~> 1.5.1)
+    public_suffix (4.0.6)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.2.0)
+    rexml (3.2.5)
+    rubocop (1.25.0)
       parallel (~> 1.10)
-      parser (>= 2.7.0.1)
+      parser (>= 3.1.0.0)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.15.1, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    ruby-progressbar (1.10.1)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.15.1)
+      parser (>= 3.0.1.1)
+    rubocop-minitest (0.17.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.8.2)
       addressable (>= 2.3.5)
       faraday (> 0.8, < 2.0)
-    unicode-display_width (1.6.1)
+    unicode-display_width (2.1.0)
 
 PLATFORMS
   ruby
@@ -58,6 +89,8 @@ DEPENDENCIES
   pry-rescue
   rake
   rubocop
+  rubocop-minitest
+  rubocop-rake
 
 BUNDLED WITH
-   2.1.4
+   2.3.6

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,13 +6,13 @@ 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')
-elsif (command = ARGV.shift)&.start_with? '++'
-  multi_repo = command[2..-1]
+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
 end
 
@@ -54,8 +54,8 @@ begin
   end
 rescue ArgumentError
   abort \
-    "Unknown multi repo: #{$ERROR_INFO.message}\n\n" \
-    '(use `git multi --report` to list all known multi repos)'
+    "Unknown multi-repo: #{$ERROR_INFO.message}\n\n" \
+    '(use `git multi --report` to list all known multi-repos)'
 end
 
 # That's all Folks!

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', '< 2.7.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)/}) }
@@ -25,7 +35,7 @@ Gem::Specification.new do |spec|
 
   spec.post_install_message = Git::Multi::PIM
 
-  spec.add_dependency 'faraday', '>= 0.9'
+  spec.add_dependency 'faraday', '~> 1'
   spec.add_dependency 'octokit', '~> 4'
 
   spec.add_development_dependency 'bundler'
@@ -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/dir.rb

@@ -1,9 +1,9 @@
 class Dir
   def git_repos(subdir = '*')
     Dir.glob(File.join(path, subdir, '*', '.git')).map { |path_to_git_dir|
-      path_to_git_repo = File.dirname(path_to_git_dir)   # without "/.git"
-      repo_name = path_to_git_repo[%r{[^\/]+\/[^\/]+\z}] # e.g. "pvdb/git-multi"
-      def repo_name.full_name() self; end
+      path_to_git_repo = File.dirname(path_to_git_dir) # without "/.git"
+      repo_name = path_to_git_repo[%r{[^/]+/[^/]+\z}]  # e.g. "pvdb/git-multi"
+      def repo_name.full_name() self; end # rubocop:disable Style/SingleLineMethods
       repo_name
     }
   end

data/lib/ext/string.rb

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

data/lib/git/hub.rb

@@ -2,10 +2,10 @@ require 'octokit'
 
 begin
   require 'net/http/persistent'
-  Octokit.middleware.swap(
-    Faraday::Adapter::NetHttp,          # default Faraday adapter
-    Faraday::Adapter::NetHttpPersistent # experimental Faraday adapter
-  )
+  if Octokit.middleware.adapter == Faraday::Adapter::NetHttp
+    adapter = Faraday::RackBuilder::Handler.new(Faraday::Adapter::NetHttpPersistent)
+    Octokit.middleware.instance_variable_set(:@adapter, adapter)
+  end
 rescue LoadError
   # NOOP  -  `Net::HTTP::Persistent` is optional, so
   # if the gem isn't installed, then we run with the
@@ -16,7 +16,6 @@ end
 
 module Git
   module Hub
-
     module_function
 
     def client
@@ -30,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
@@ -77,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)
@@ -94,16 +93,15 @@ 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)
       # type can be one of: all, public, private, forks, sources, member
       @org_repositories[[org, type]]
     end
-
   end
 end

data/lib/git/multi/commands.rb

@@ -1,7 +1,6 @@
 module Git
   module Multi
     module Commands
-
       module_function
 
       def version
@@ -134,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
@@ -203,7 +202,6 @@ module Git
       end
 
       private_class_method :system
-
     end
   end
 end

data/lib/git/multi/config.rb

@@ -1,6 +1,5 @@
 module Git
   module Multi
-
     module_function
 
     def local_option(path, name, default = nil)
@@ -8,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
 
@@ -23,9 +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

@@ -1,7 +1,6 @@
 module Git
   module Multi
     module Report
-
       TICK  = ['2714'.hex].pack('U*').green.freeze
       CROSS = ['2718'.hex].pack('U*').red.freeze
       ARROW = ['2794'.hex].pack('U*').blue.freeze
@@ -34,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
@@ -43,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
@@ -77,7 +79,7 @@ module Git
         elsif token.empty?
           '(empty)'
         else
-          "#{'*' * 36}#{token[36..-1]}"
+          "#{'*' * 36}#{token[36..]}"
         end
       end
 
@@ -103,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}"
@@ -116,19 +118,18 @@ 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
   end
 end

data/lib/git/multi/version.rb

@@ -1,7 +1,7 @@
 module Git
   module Multi
     NAME = 'git-multi'.freeze
-    VERSION = '4.0.0'.freeze
+    VERSION = '7.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
@@ -139,7 +140,6 @@ module Git
     #
 
     module Nike
-
       # rubocop:disable Metrics/PerceivedComplexity
       # rubocop:disable Metrics/CyclomaticComplexity
       def just_do_it(interactive, pipelined, captured = nil, options = {})
@@ -149,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
+          elsif $stderr.tty? && captured
             errors = File.join(ENV['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
@@ -182,7 +182,6 @@ module Git
           end
         end
       end
-
     end
 
     def repositories
@@ -196,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
@@ -215,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
@@ -228,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
 
     #
@@ -293,6 +306,5 @@ module Git
         File.directory? repo.local_path
       }
     end
-
   end
 end

data/man/git-multi.1

@@ -1,13 +1,13 @@
 '\" t
 .\"     Title: git-multi
-.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
-.\"      Date: 01/25/2020
+.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
+.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
+.\"      Date: 02/02/2022
 .\"    Manual: Git Manual
-.\"    Source: Git 2.23.0.606.g08da6496b6.dirty
+.\"    Source: Git 2.35.1.4.g5d01301f2b.dirty
 .\"  Language: English
 .\"
-.TH "GIT\-MULTI" "1" "01/25/2020" "Git 2\&.23\&.0\&.606\&.g08da64" "Git Manual"
+.TH "GIT\-MULTI" "1" "02/02/2022" "Git 2\&.35\&.1\&.4\&.g5d01301f" "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 \fBv4\&.0\&.0\fR of \fIgit multi\fR \&... hooray!
+This is \fBv7\&.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:
@@ -48,7 +48,7 @@ To execute the same git command in multiple repositories, the invocation is as f
 .fi
 .sp
 .sp
-Both ways of running \fBgit multi\fR take an optional, so\-called "multi repo" argument to limit the operation to the list of repositories in the referenced "multi repo", ie\&. a single GitHub user or a single GitHub organization:
+Both ways of running \fBgit multi\fR take an optional, so\-called "multi\-repo" argument to limit the operation to the list of repositories in the referenced "multi\-repo", ie\&. a single GitHub user or a single GitHub organization:
 .sp
 .nf
 \fIgit multi\fR ++<multi_repo> \-\-<option> [<option_arguments>]
@@ -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
 .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

@@ -26,9 +26,9 @@ invocation is as follows:
 [verse]
 'git multi' <git_command> [<git_command_arguments>]
 
-Both ways of running `git multi` take an optional, so-called "multi repo"
+Both ways of running `git multi` take an optional, so-called "multi-repo"
 argument to limit the operation to the list of repositories in the referenced
-"multi repo", ie. a single GitHub user or a single GitHub organization:
+"multi-repo", ie. a single GitHub user or a single GitHub organization:
 
 [verse]
 'git multi' ++<multi_repo> --<option> [<option_arguments>]
@@ -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 8.6.10" />
+<meta name="generator" content="AsciiDoc 10.1.1" />
 <title>git-multi(1)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -436,7 +436,7 @@ thead, p.table.header {
 p.table {
   margin-top: 0;
 }
-/* Because the table frame attribute is overriden by CSS in most browsers. */
+/* Because the table frame attribute is overridden by CSS in most browsers. */
 div.tableblock > table[frame="void"] {
   border-style: none;
 }
@@ -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>v4.0.0</code> of <em>git multi</em> &#8230; hooray!</p></div>
+<div class="paragraph"><p>This is <code>v7.0.0</code> of <em>git multi</em> &#8230; hooray!</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -766,9 +766,9 @@ invocation is as follows:</p></div>
 <pre class="content"><em>git multi</em> &lt;git_command&gt; [&lt;git_command_arguments&gt;]</pre>
 <div class="attribution">
 </div></div>
-<div class="paragraph"><p>Both ways of running <code>git multi</code> take an optional, so-called "multi repo"
+<div class="paragraph"><p>Both ways of running <code>git multi</code> take an optional, so-called "multi-repo"
 argument to limit the operation to the list of repositories in the referenced
-"multi repo", ie. a single GitHub user or a single GitHub organization:</p></div>
+"multi-repo", ie. a single GitHub user or a single GitHub organization:</p></div>
 <div class="verseblock">
 <pre class="content"><em>git multi</em> ++&lt;multi_repo&gt; --&lt;option&gt; [&lt;option_arguments&gt;]</pre>
 <div class="attribution">
@@ -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</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-01-25 11:55:56 GMT
+ 2022-02-02 17:29:17 GMT
 </div>
 </div>
 </body>

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: git-multi
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 7.0.0
 platform: ruby
 authors:
 - Peter Vandenberk
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-01-25 00:00:00.000000000 Z
+date: 2022-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: octokit
   requirement: !ruby/object:Gem::Requirement
@@ -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,16 +217,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.6.0
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.3
-signing_key: 
+rubygems_version: 3.0.3.1
+signing_key:
 specification_version: 4
 summary: The ultimate multi-repo utility for git!
 test_files: []