git_tree 0.3.0 → 1.0.1

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: git_tree
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Mike Slinn
-bindir: bindir
+bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -38,21 +38,27 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 description: |
-  Installs 3 commands that process a git directory tree.
+  Installs 5 commands that process a git directory tree.
   Directories containing a file called .ignore are ignored.
 
-  The git-tree-replicate command writes a script that clones the repos in the tree,
-  and adds any defined remotes.
+  The git-commitAll command commits all changes to each repository in the tree.
+
+  The git-evars command writes a script that defines environment variables pointing to git repos.
 
-  The git-tree-evars command writes a script that defines environment variables pointing to git repos.
+  The git-exec command executes a bash expression on children of a directory, or a list of directories.
+
+  The git-replicate command writes a script that clones the repos in the tree,
+  and adds any defined remotes.
 
-  The git-tree-exec command executes a bash expression on children of a directory, or a list of directories.
+  The git-update command updates each repository in the tree.
 email:
 - mslinn@mslinn.com
 executables:
-- git-tree-evars
-- git-tree-exec
-- git-tree-replicate
+- git-commitAll
+- git-evars
+- git-exec
+- git-replicate
+- git-update
 extensions: []
 extra_rdoc_files: []
 files:
@@ -61,16 +67,28 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
-- bindir/git-tree-evars
-- bindir/git-tree-exec
-- bindir/git-tree-replicate
+- exe/git-commitAll
+- exe/git-evars
+- exe/git-exec
+- exe/git-replicate
+- exe/git-update
 - git_tree.gemspec
+- lib/commands/abstract_command.rb
+- lib/commands/git_commit_all.rb
+- lib/commands/git_evars.rb
+- lib/commands/git_exec.rb
+- lib/commands/git_exec_spec.rb
+- lib/commands/git_replicate.rb
+- lib/commands/git_update.rb
 - lib/git_tree.rb
 - lib/git_tree/version.rb
-- lib/git_tree_evars.rb
-- lib/git_tree_exec.rb
-- lib/git_tree_replicate.rb
-- lib/util.rb
+- lib/util/command_runner.rb
+- lib/util/gem_support.rb
+- lib/util/git_tree_walker.rb
+- lib/util/git_tree_walker_private.rb
+- lib/util/log.rb
+- lib/util/thread_pool_manager.rb
+- lib/util/zowee_optimizer.rb
 homepage: https://www.mslinn.com/git/1100-git-tree.html
 licenses:
 - MIT
@@ -91,16 +109,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.2
+rubygems_version: 3.6.9
 specification_version: 4
-summary: Installs two commands that scan a git directory tree and write out scripts
-  for replication.
+summary: Installs five commands that walk a git directory tree and perform tasks.
 test_files: []
 ...

data/bindir/git-tree-evars

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'git_tree_evars'
-
-GitTree.command_evars

data/bindir/git-tree-exec

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'git_tree_exec'
-
-GitTree.command_exec

data/bindir/git-tree-replicate

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'git_tree_replicate'
-
-GitTree.command_replicate

data/lib/git_tree_evars.rb

@@ -1,82 +0,0 @@
-require_relative 'git_tree'
-
-module GitTree
-  using Rainbow
-
-  # @param root might be "$envar" or a fully qualified directory name ("/a/b/c")
-  def self.command_evars(root = ARGV[0])
-    help_evars "Environment variable reference was missing. Please enclose it within single quotes." if root.to_s.empty?
-    help_evars "Environment variable reference must start with a dollar sign ($)." unless root.start_with? '$'
-
-    base = MslinnUtil.expand_env root
-    help_evars "Environment variable '#{root}' is undefined." if base.strip.empty?
-    help_evars "Environment variable '#{root}' points to a non-existant directory (#{base})." unless File.exist?(base)
-    help_evars "Environment variable '#{root}' points to a file (#{base}), not a directory." unless Dir.exist?(base)
-
-    dirs = directories_to_process base
-    puts make_env_vars(root, base, dirs)
-  end
-
-  def self.env_var_name(path)
-    name = path.include?('/') ? File.basename(path) : path
-    name.tr(' ', '_').tr('-', '_')
-  end
-
-  def self.help_evars(msg = nil)
-    prog_name = File.basename $PROGRAM_NAME
-    puts "Error: #{msg}\n".red if msg
-    puts <<~END_HELP
-      #{prog_name} - Examines a tree of git repositories and writes a bash script to STDOUT
-      that defines environment variables which point to the repositories in the tree.
-
-      Does not redefine existing environment variables; messages are written to
-      STDERR to indicate environment variables that are not redefined.
-
-      The environment variable must have been exported, for example:
-
-      $ export work=$HOME/work
-
-      Directories containing a file called .ignore are ignored.
-
-      Usage example:
-
-      $ #{prog_name} '$work'
-
-      The name of the environment variable must be preceded by a dollar sign and enclosed within single quotes.
-    END_HELP
-    exit 1
-  end
-
-  def self.make_env_var(name, value)
-    "export #{env_var_name(name)}=#{value}"
-  end
-
-  # @param root should be an "$envar" that points to the root of a directory tree containing git repos.
-  # @param base a fully qualified directory name ("/a/b/c")
-  # @param dirs directory list to process
-  def self.make_env_vars(root, base, dirs)
-    help_evars "Error: Please specify the subdirectory to traverse." if root.to_s.empty?
-
-    result = []
-    result << make_env_var(env_var_name(base), MslinnUtil.deref_symlink(base))
-    dirs.each do |dir|
-      ename = env_var_name dir
-      ename_value = MslinnUtil.expand_env "$#{ename}"
-      ename_value = ename_value.gsub(' ', '\\ ').delete_prefix('\\') unless ename_value.empty?
-      if ename_value.to_s.strip.empty?
-        result << make_env_var(ename, "#{root}/#{dir}")
-      else
-        msg = "$#{ename} was previously defined as #{ename_value}"
-        dir2 = MslinnUtil.expand_env(ename_value)
-        if Dir.exist? dir2
-          warn msg.cyan
-        else
-          msg += ", but that directory does not exist,\n  so redefining #{ename} as #{dir}."
-          warn msg.green
-          result << make_env_var(ename, "#{root}/#{dir}")
-        end
-      end
-    end
-    result.map { |x| "#{x}\n" }.join + "\n"
-  end
-end

data/lib/git_tree_exec.rb

@@ -1,94 +0,0 @@
-require 'pathname'
-require 'shellwords'
-require_relative 'git_tree'
-
-module GitTree
-  using Rainbow
-
-  # @param root might be:
-  #   - '$envar'
-  #   - A fully qualified directory name ("/a/b/c")
-  #   - A list of either of the above
-  def self.command_exec(args = ARGV)
-    root = args[0]
-    command = args[1]
-
-    help_exec "A directory specification and a command must be specified." if args.empty?
-    help_exec "A command must be specified." if args.length == 1
-
-    base = MslinnUtil.expand_env root
-    help_exec "Environment variable '#{root}' is undefined." if base.empty?
-    base.shellsplit.each do |top|
-      dirs = directories_to_process(top)
-      dirs.each do |dir|
-        dir = File.join(base, dir) if Pathname.new(dir).relative?
-        execute dir, command
-      end
-    end
-  end
-
-  # @return array containing status code and result of running command in the given directory
-  # @param command [String] Shell command to execute
-  def self.execute(dir, command)
-    Dir.chdir(dir) do
-      unless File.exist? dir
-        warn "Warning: directory '#{dir}' does not exist.".yellow
-        return
-      end
-      unless Dir.exist? dir
-        warn "Warning: #{dir} is a file, not a directory.".yellow
-        return
-      end
-      result = `#{command}`.rstrip
-      puts result unless result.empty?
-    end
-  rescue StandardError => e
-    warn "Error: #{e.message} from executing '#{command}' in #{dir}".red
-  end
-
-  def self.help_exec(msg = nil)
-    prog_name = File.basename $PROGRAM_NAME
-    puts "Error: #{msg}\n".red if msg
-    puts <<~END_HELP
-      #{prog_name} - requires only one parameter,
-      which points to the top-level directory to process.
-      3 forms are accepted.
-      Only direct child directories are processed; infinite recursion is not supported.
-        1. A directory name, which may be relative or absolute.
-        2. An environment variable reference,
-           which must be preceded by a dollar sign and enclosed within single quotes
-           to prevent expansion by the shell.
-        3. A list of directory names, which may be relative or absolute,
-           and may contain environment variables.
-
-      The environment variable must have been exported, for example:
-
-        $ export work=$HOME/work
-
-      Directories containing a file called .ignore are ignored.
-
-      Usage examples:
-
-      1) For all subdirectories of the current directory,
-         update `Gemfile.lock` and install a local copy of the gem:
-
-         $ #{prog_name} . 'bundle && bundle update && rake install'
-
-
-      2) For all subdirectories of the directory pointed to by `$work`,
-         run git commit and push changes.
-
-         $ #{prog_name} '$work' 'git commit -am "-" && git push'
-
-
-      3) For all subdirectories of the specified directories,
-         list the projects that have a demo/ subdirectory.
-
-         The specified directories are . (the current directory),
-         ~ (the home directory) and the directory pointed to by $my_plugins
-
-         $ #{prog_name} '. ~ $my_plugins' 'if [ -d demo]; then realpath demo; fi'
-    END_HELP
-    exit 1
-  end
-end

data/lib/git_tree_replicate.rb

@@ -1,86 +0,0 @@
-require_relative 'git_tree'
-
-module GitTree
-  using Rainbow
-
-  # @param root might be "$envar" or a fully qualified directory name ("/a/b/c")
-  def self.command_replicate(root = ARGV[0])
-    help_replicate "Environment variable reference was missing. Please enclose it within single quotes." if root.to_s.empty?
-    help_replicate "Error: Environment variable reference must start with a dollar sign ($)" unless root.start_with? '$'
-
-    base = MslinnUtil.expand_env root
-    help_replicate "Environment variable '#{root}' is undefined." if base.strip.empty?
-    help_replicate "Environment variable '#{root}' points to a non-existant directory (#{base})." unless File.exist?(base)
-    help_replicate "Environment variable '#{root}' points to a file (#{base}), not a directory." unless Dir.exist?(base)
-
-    dirs = directories_to_process base
-    puts make_replicate_script(root, base, dirs)
-  end
-
-  def self.help_replicate(msg = nil)
-    prog_name = File.basename $PROGRAM_NAME
-    puts "Error: #{msg}\n".red if msg
-    puts <<~END_HELP
-      #{prog_name} - Replicates a tree of git repositories and writes a bash script
-      to STDOUT that clones the repositories in the tree. Replicates any remotes
-      defined in the source repositories to the target repositories.
-
-      The environment variable must have been exported, for example:
-
-      $ export work=$HOME/work
-
-      Directories containing a file called .ignore are ignored.
-
-      Usage example:
-      Assuming that 'work' is an environment variable that contains the name of a
-      directory that contains a tree of git repositories:
-
-      $ #{prog_name} '$work'
-
-      The name of the environment variable must be preceded by a dollar sign and enclosed within single quotes.
-    END_HELP
-    exit 1
-  end
-
-  # @param root should be an "$envar" that points to the root of a directory tree containing git repos.
-  # @param base a fully qualified directory name ("/a/b/c")
-  # @param dirs directory list to process
-  def self.make_replicate_script(root, base, dirs)
-    help_replicate "Error: Please specify the subdirectory to traverse.\n\n" if root.to_s.empty?
-
-    Dir.chdir(base) do
-      result = dirs.map { |dir| replicate_one(dir) }
-      result.join "\n"
-    end
-  end
-
-  def self.replicate_one(dir)
-    output = []
-    # project_dir = File.basename dir
-    parent_dir = File.dirname dir
-    repo = Rugged::Repository.new dir
-    origin_url = repo.config['remote.origin.url']
-
-    output << "if [ ! -d \"#{dir}/.git\" ]; then"
-    output << "  mkdir -p '#{parent_dir}'"
-    output << "  pushd '#{parent_dir}' > /dev/null"
-    output << "  git clone #{origin_url}"
-
-    repo.remotes.each do |remote|
-      next if remote.name == 'origin' || remote.url == 'no_push'
-
-      output << "  git remote add #{remote.name} '#{remote.url}'"
-    end
-
-    output << '  popd > /dev/null'
-
-    # git_dir_name = File.basename Dir.pwd
-    # if git_dir_name != project_dir
-    #   output << '  # Git project directory was renamed, renaming this copy to match original directory structure'
-    #   output << "  mv #{git_dir_name} #{project_dir}"
-    # end
-    output << 'fi'
-    output << ''
-    output
-  end
-end