multi_repo 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 363ca04276f3d649809c39b6fb2edb051e2eb51f8fd87f945409d08172984e0d
-  data.tar.gz: 8267789b5af70973998fb0ecb0e59107347f7e6403a746fa98c0bc5f43a93f3c
+  metadata.gz: 5f6bfcb82a6c7c9ecb6155693362f6a62969929bf2b545eb02290f7479916b94
+  data.tar.gz: a9fe3ea44406b016e01665382b3469f339b3e1c3aed58cbe07e99a3d1018cef6
 SHA512:
-  metadata.gz: 501f688e2084d24d9bcb39633d974bb08cbb97c8586d25983d1a7d76f41cf4d37836f7455f6d81addff4d03c40655c10a79b668f42a12eee61f378807f06784e
-  data.tar.gz: 43f1aff7d976517022e22ce9903fd21ea20367b2e155bd418c03d66cb960026f0ff0f43b953382b703c3badd47d65e1761234c47325803e07ca0df0e4b000a01
+  metadata.gz: 86b6e1f73bac7fa2cc6e308bebac1c88fab5d2f1dda3b37d111342b5af35da9b1dcf16867c78a3d333b54ebaf55ed58a1fc6c4df274dad8fa86496b8099d6da5
+  data.tar.gz: 558bdc3403403bacab66c49722e77f92bf57a8ffad05015d06e384e2ae6f37bb7c04753b5dbbccefa77c4fad68bf8c26f6cb451da9f25c881d1f8180ce3234c8

data/exe/multi_repo

@@ -2,16 +2,26 @@
 
 SCRIPT_DIR = File.expand_path("../scripts", __dir__)
 
+def available_scripts
+  @available_scripts ||= Dir.children(SCRIPT_DIR).sort.to_h do |script|
+    desc = File.read(File.join(SCRIPT_DIR, script)).match(/synopsis(?:\(|\s+)['"](.*)['"]/)&.captures&.first
+    [script, desc]
+  end
+end
+
 def usage
   puts "Usage: multi_repo <script> [args]"
   puts "  script      Script to run"
   puts "  args        Arguments to pass to the script"
   puts "  -h, --help  Show this help message"
-
-  available_scripts = Dir.children(SCRIPT_DIR).sort.map { |f| "  #{f}"}
+  puts
+  puts "For help on a specific script, run:"
+  puts "  multi_repo <script> --help"
   puts
   puts "Available scripts:"
-  puts available_scripts
+
+  justify = available_scripts.keys.map(&:length).max + 2
+  puts available_scripts.map { |script, desc| "  #{script.ljust(justify)} #{desc}" }.join("\n")
 end
 
 script, args = ARGV[0], ARGV[1..]

data/lib/multi_repo/version.rb

@@ -1,3 +1,3 @@
 module MultiRepo
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

data/scripts/delete_labels

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Delete labels on all GitHub repos."
+
   opt :labels, "The labels to delete.", :type => :strings, :required => true
 
   MultiRepo::CLI.common_options(self, :repo_set_default => nil)

data/scripts/destroy_branch

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Destroy a branch on all local git repos."
+
   opt :branch, "The branch to destroy.", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :except => :dry_run)

data/scripts/destroy_remote

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Destroy a remote on all local git repos."
+
   opt :remote, "The remote to destroy", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self)

data/scripts/destroy_tag

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Destroy a tag on all local git repos."
+
   opt :tag, "The tag to destroy", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :except => :dry_run)

data/scripts/each_repo

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Run a command in each repo."
+
   opt :command, "A command to run in each repo", :type => :string, :required => true
   opt :ref, "Ref to checkout before running the command", :type => :string, :default => "master"
 

data/scripts/fetch_repos

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Fetch all repos."
+
   opt :checkout, "Branch to checkout after fetching.", :type => :string
 
   MultiRepo::CLI.common_options(self, :except => :dry_run)

data/scripts/git_mirror

@@ -6,4 +6,8 @@ gemfile do
   gem "multi_repo", require: "multi_repo/cli", path: File.expand_path("..", __dir__)
 end
 
+Optimist.options do
+  synopsis "Mirror all GitHub repos into another org."
+end
+
 exit 1 unless MultiRepo::Helpers::GitMirror.new.mirror_all

data/scripts/github_rate_limit

@@ -7,4 +7,8 @@ gemfile do
 end
 require "more_core_extensions/core_ext/array/tableize"
 
+Optimist.options do
+  synopsis "Display the current GitHub rate limit."
+end
+
 puts [MultiRepo::Service::Github.client.rate_limit.to_h].tableize

data/scripts/hacktoberfest

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Apply the 'hacktoberfest' label to all 'good first issue' labels."
+
   opt :org,   "The organization to apply the `hacktoberfest` label to", :type => :string, :required => true
   opt :apply, "Apply the `hacktoberfest` label to `good first issue` labels. "\
               "Pass --no-apply to remove the `hacktoberfest` label",

data/scripts/make_alumni

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Move a set of GitHub team members to an 'alumni' team."
+
   opt :users, "The users to make alumni.",     :type => :strings, :required => true
   opt :org,   "The org in which user belongs", :type => :string,  :required => true
 

data/scripts/new_rubygems_stub

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Create a stub for a new Ruby gem on rubygems.org."
+
   opt :owners, "Owners to add to the gem stub", :type => :strings, :default => []
 
   MultiRepo::CLI.common_options(self, :except => :repo_set)

data/scripts/pull_request_blaster_outer

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Create a pull request on all repos."
+
   opt :base,    "The target branch for the changes.",                         :type => :string, :required => true
   opt :head,    "The name of the branch to create on your fork.",             :type => :string, :required => true
   opt :script,  "The path to the script that will update the desired files.", :type => :string, :required => true

data/scripts/pull_request_labeler

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Add or remove labels on a set of pull requests."
+
   opt :prs,    "The list of PRs to merge", :type => :strings, :required => true
   opt :add,    "Labels to add",            :type => :strings, :required => true
   opt :remove, "Labels to remove",         :type => :strings, :required => true

data/scripts/pull_request_merger

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Merge a set of pull requests, also setting assignee and labels."
+
   opt :prs,      "The list of PRs to merge",           :type => :strings, :required => true
   opt :assignee, "GitHub user to assign when merging", :type => :string,  :required => true
   opt :labels,   "Labels to apply when merging",       :type => :strings

data/scripts/reenable_repo_workflows

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Reenable all disabled workflows in an org."
+
   opt :org, "The organization to reenable workflows in", :type => :string, :required => true
   opt :extra_repos, "Extra repos to reenable workflows in", :type => :strings, :default => []
 

data/scripts/rename_labels

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Rename labels on all GitHub repos."
+
   opt :old, "The old label names.", :type => :strings, :required => true
   opt :new, "The new label names.", :type => :strings, :required => true
 

data/scripts/restart_travis_builds

@@ -9,6 +9,8 @@ require 'travis'
 require 'travis/pro/auto_login'
 
 opts = Optimist.options do
+  synopsis "Restart all Travis builds for a given branch or tag for all GitHub repos."
+
   opt :ref, "The branch or release tag to rebuild.", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :except => :dry_run, :repo_set_default => nil)

data/scripts/show_commit_history

@@ -11,6 +11,8 @@ require "active_support/core_ext/string/inflections"
 DISPLAY_FORMATS = %w[commit pr-title pr-label]
 
 opts = Optimist.options do
+  synopsis "Show the git commit log between two refs for all git repos."
+
   opt :from,    "The commit log 'from' ref", :type => :string,  :required => true
   opt :to,      "The commit log 'to' ref" ,  :type => :string,  :required => true
   opt :display, "How to display the history. Valid values are: #{DISPLAY_FORMATS.join(", ")}", :default => "commit"

data/scripts/show_org_members

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Show all members of an org."
+
   opt :org,    "The org to list the users for",    :type => :string, :required => true
   opt :team,   "Show members of a specific team",  :type => :string
   opt :alumni, "Whether or not to include alumni", :default => false

data/scripts/show_org_repos

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "List all repos in an org."
+
   opt :org, "The org to list the repos for", :type => :string, :required => true
 end
 

data/scripts/show_org_stats

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Show commit and merge stats for all git repos."
+
   opt :since, "Since what date.", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :except => :dry_run)

data/scripts/show_project_cards

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Show all issues in a GitHub project column."
+
   opt :project_id, "The project ID",                :type => :integer, :required => true
   opt :column,     "The column within the project", :type => :string,  :required => true
 

data/scripts/show_repo_set

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "List all repos in a repo set."
+
   MultiRepo::CLI.common_options(self, :only => :repo_set)
 end
 

data/scripts/show_tag

@@ -8,6 +8,8 @@ end
 require 'more_core_extensions/core_ext/array/tableize'
 
 opts = Optimist.options do
+  synopsis "Show the commit for a tag in all git repos."
+
   opt :tag, "The tag name.", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :except => :dry_run, :repo_set_default => nil)

data/scripts/show_travis_status

@@ -13,6 +13,8 @@ require 'travis'
 require 'travis/pro/auto_login'
 
 opts = Optimist.options do
+  synopsis "Show the Travis status for a branch or tag for all GitHub repos."
+
   opt :ref, "The branch or release tag to check status for.", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :except => :dry_run, :repo_set_default => nil)

data/scripts/update_branch_protection

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Update the branch protection for all GitHub repos."
+
   opt :branch, "The branch to protect.", :type => :string, :required => true
 
   MultiRepo::CLI.common_options(self, :repo_set_default => nil)

data/scripts/update_labels

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Create or update labels on all GitHub repos."
+
   MultiRepo::CLI.common_options(self, :repo_set_default => nil)
 end
 opts[:repo] = MultiRepo::Labels.all.keys.sort unless opts[:repo] || opts[:repo_set]

data/scripts/update_milestone

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Create, update, or close a milestone in all GitHub repos."
+
   opt :title,  "The milestone title.",            :type => :string, :required => true
   opt :due_on, "The due date.",                   :type => :string
   opt :close,  "Whether to close the milestone.", :default => false

data/scripts/update_repo_settings

@@ -7,6 +7,8 @@ gemfile do
 end
 
 opts = Optimist.options do
+  synopsis "Update repo settings in all GitHub repos."
+
   MultiRepo::CLI.common_options(self)
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: multi_repo
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - ManageIQ Authors
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-07-17 00:00:00.000000000 Z
+date: 2023-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport