monos 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 70c115bc6f5762608c35c75b05991cafa719485f
-  data.tar.gz: f6c91d659878aacc2f5902b0525acbbd27a52106
+  metadata.gz: 5cafc90639b5bb02b8be04d5f993dd518a53db83
+  data.tar.gz: b3aba3dbae6d86e86d78eb53add58def4faa3844
 SHA512:
-  metadata.gz: d7c3067d9f56f3b4888017540746ae118dae15cf3c9a46a86d47f5489ac07246105feccf608203c23628f5c15c3a11ff71fca8816f13226aa9e31f21ca6b0d97
-  data.tar.gz: 2e19f6360434425c493ff6bbfbf72fef6b22e7e4d96ec7d99a5a28d7aa89c2599fb009bc8686ee725375b04bbce0ca11d4d9a5b6fed54838e73784feb4e9f479
+  metadata.gz: 9192d91ab18d06d5b167be39171f86d71daf40629c5cf5aeeff8de9e8cb9c5b681e33de16ef08e02ee2986c97b46e9c4bc2292e364d6dab94ee6f28ce98e93e0
+  data.tar.gz: a48bacb9f54bf48e6264c9ece66e030cdd3c8c900373d141cc4d430b913851b802b4cb8b8c6d4d3c7b9f458584dcc372fe4e7e0ea45585d6cfcc20ca6f5a6414

data/Manifest.txt

@@ -8,12 +8,12 @@ lib/mono.rb
 lib/mono/base.rb
 lib/mono/commands/env.rb
 lib/mono/commands/fetch.rb
+lib/mono/commands/run.rb
 lib/mono/commands/status.rb
 lib/mono/commands/sync.rb
-lib/mono/git/base.rb
-lib/mono/sportdb.rb
 lib/mono/tool.rb
 lib/mono/version.rb
 lib/monos.rb
+lib/sportdb/setup.rb
 test/helper.rb
 test/test_base.rb

data/README.md

@@ -52,7 +52,7 @@ openfootball:
 
 ### Commands
 
-`status` • `fetch` • `sync` • `env`
+`status` • `fetch` • `sync` • `run` •`env`
 
 ### `status` Command
 
@@ -114,6 +114,27 @@ $ mo get
 Note:  `install` or `get` or `up` are all aliases that you can use for `sync`.
 
 
+### `run` Command
+
+Use the `run` command to run any command in all repos. Example:
+
+```
+$ mono run git ls-files
+$ mono exec git ls-files   # exec is an alias for run
+$ mo run git ls-files      # mo is a "shortcut" convenience alias for mono
+$ mo exec git ls-files
+
+# -or-
+
+$ mono run tree
+$ mono exec tree
+$ mo run tree
+$ mo exec tree
+```
+
+Note: `exec` is an alias that you can use for `run`.
+
+
 
 ### `env` Command
 

data/Rakefile

@@ -3,12 +3,11 @@ require './lib/mono/version.rb'
 
 Hoe.spec 'monos' do
 
-  self.version = Mono::VERSION
+  self.version = MonoCore::VERSION
 
   self.summary = "monos - monorepo / mono source tree tools and (startup) scripts"
   self.description = summary
 
-  # self.urls = ['https://github.com/sportdb/sport.db' ]
   self.urls = { home: 'https://github.com/sportdb/sport.db' }
 
   self.author = 'Gerald Bauer'
@@ -20,7 +19,9 @@ Hoe.spec 'monos' do
 
   self.licenses = ['Public Domain']
 
-  self.extra_deps = []
+  self.extra_deps = [
+    ['gitti', '>= 0.4.0' ],
+  ]
 
   self.spec_extras = {
     required_ruby_version: '>= 2.2.2'

data/lib/mono.rb

@@ -1,24 +1,31 @@
-require 'pp'
-require 'time'
-require 'date'
-require 'yaml'
-require 'open3'
-require 'fileutils'
-require 'optparse'
+## first add git support
+##   note: use the "modular" version WITHOUT auto-include gitti,
+##          thus, require 'gitti/base' (and NOT 'gitti')
+require 'gitti/base'
+
+module Mono
+  ## note: make Git, GitProject, GitRepoSet, etc. available without Gitti::
+  include Gitti
+end
+
+
+## some more stdlibs
+# require 'optparse'
+
 
 
 ###
 # our own code
 require 'mono/version' # let version always go first
 require 'mono/base'
-require 'mono/git/base'
 
 require 'mono/commands/status'
 require 'mono/commands/fetch'
 require 'mono/commands/sync'
 require 'mono/commands/env'
+require 'mono/commands/run'
 require 'mono/tool'
 
 
 
-puts Mono::Module.banner   # say hello
+puts MonoCore.banner   # say hello

data/lib/mono/base.rb

@@ -29,9 +29,9 @@ module Mono
             end
 
     if path
-      YAML.load_file( path )
+      GitRepoSet.read( path )
     else
-      {}
+      GitRepoSet.new( {} )  ## return empty set -todo/check: return nil - why? why not?
     end
   end
 

data/lib/mono/commands/env.rb

@@ -2,9 +2,22 @@ module Mono
 
   def self.env   ## check environment setup
     puts "Mono.root (MOPATH): >#{Mono.root}<"
-    puts "Mono::Module.root:  >#{Mono::Module.root}<"
+    puts "MonoCore.root:  >#{MonoCore.root}<"
+    puts
+
+    ## add ruby version and path - why? why not? e.g.
+    ##  ruby:
+    ## bin:        C:/ri330/Ruby2.0.0/bin/ruby.exe
+    ## version:    ruby 2.3.3p222 (2016-11-21 revision 56859) [i386-mingw32]
+
     puts "git version:"
     Git.version
+    ## Git.config( 'user.name' )
+    ## Git.config( 'user.email', show_origin: true )
+
+    ## dump/print all user.* settings e.g. user.name, user.email
+    Git.config( /user/, show_origin: true )
+
     puts
     puts "monorepo.yml:"
     pp   Mono.monofile

data/lib/mono/commands/fetch.rb

@@ -1,21 +1,16 @@
 module Mono
 
   ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
-  def self.fetch( h=Mono.monofile )
+  def self.fetch
+    repos = Mono.monofile
+
     count_orgs  = 0
     count_repos = 0
 
-    ## sum up total number of repos
-    total_repos = h.reduce(0) {|sum,(_,names)| sum+= names.size; sum }
-
+    total_repos = repos.size
 
-    h.each do |org_with_counter,names|
 
-      ## remove optional number from key e.g.
-      ##   mrhydescripts (3)    =>  mrhydescripts
-      ##   footballjs (4)       =>  footballjs
-      ##   etc.
-      org = org_with_counter.sub( /\([0-9]+\)/, '' ).strip
+    repos.each do |org,names|
 
       org_path = "#{Mono.root}/#{org}"
 
@@ -26,8 +21,8 @@ module Mono
 
           Dir.chdir( org_path ) do
             if Dir.exist?( repo.name )
-              GitProject.open( repo.name ) do |git|
-                git.fetch
+              GitProject.open( repo.name ) do |proj|
+                proj.fetch
               end
             else
               puts "!!  repo not found / missing"

data/lib/mono/commands/run.rb

@@ -0,0 +1,47 @@
+module Mono
+
+  def self.run( *args )
+    ## todo/fix: use a "standard" argument to pass along hash of repos
+    ##   (e.g. monorepo.yml or repos.yml ) how?  - why? why not?
+    repos = Mono.monofile
+
+
+    cmd = args.join( ' ' )
+
+    count_orgs  = 0
+    count_repos = 0
+
+    total_repos = repos.size
+
+    repos.each do |org,names|
+
+      org_path = "#{Mono.root}/#{org}"
+
+      names.each do |name|
+          puts "[#{count_repos+1}/#{total_repos}] #{org}@#{name}..."
+
+          repo = GitHubRepo.new( org, name )  ## owner, name e.g. rubylibs/webservice
+
+          Dir.chdir( org_path ) do
+            if Dir.exist?( repo.name )
+              GitProject.open( repo.name ) do |proj|
+                proj.run( cmd )
+              end
+            else
+              puts "!!  repo not found / missing"
+            end
+          end
+
+          count_repos += 1
+      end
+      count_orgs += 1
+    end
+
+
+    ## print stats & changes summary
+    puts
+    print "#{count_repos} repo(s) @ #{count_orgs} org(s)"
+    print "\n"
+  end # method run
+
+end  # module Mono

data/lib/mono/commands/status.rb

@@ -1,23 +1,17 @@
 module Mono
 
   ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
-  def self.status( h=Mono.monofile )
+  def self.status
+    repos = Mono.monofile
+
     changes =  []   ## track changes
 
     count_orgs  = 0
     count_repos = 0
 
-    ## sum up total number of repos
-    total_repos = h.reduce(0) {|sum,(_,names)| sum+= names.size; sum }
-
-
-    h.each do |org_with_counter,names|
+    total_repos = repos.size
 
-      ## remove optional number from key e.g.
-      ##   mrhydescripts (3)    =>  mrhydescripts
-      ##   footballjs (4)       =>  footballjs
-      ##   etc.
-      org = org_with_counter.sub( /\([0-9]+\)/, '' ).strip
+    repos.each do |org,names|
 
       org_path = "#{Mono.root}/#{org}"
 
@@ -28,8 +22,8 @@ module Mono
 
           Dir.chdir( org_path ) do
             if Dir.exist?( repo.name )
-              GitProject.open( repo.name ) do |git|
-                output = git.changes
+              GitProject.open( repo.name ) do |proj|
+                output = proj.changes
                 if output.empty?
                    puts "   - no changes -"
                 else

data/lib/mono/commands/sync.rb

@@ -1,21 +1,15 @@
 module Mono
 
   ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
-  def self.sync( h=Mono.monofile )
+  def self.sync
+    repos = Mono.monofile
+
     count_orgs  = 0
     count_repos = 0
 
-    ## sum up total number of repos
-    total_repos = h.reduce(0) {|sum,(_,names)| sum+= names.size; sum }
-
-    h.each do |org_with_counter,names|
-
-      ## remove optional number from key e.g.
-      ##   mrhydescripts (3)    =>  mrhydescripts
-      ##   footballjs (4)       =>  footballjs
-      ##   etc.
-      org = org_with_counter.sub( /\([0-9]+\)/, '' ).strip
+    total_repos = repos.size
 
+    repos.each do |org,names|
       org_path = "#{Mono.root}/#{org}"
       FileUtils.mkdir_p( org_path ) unless Dir.exist?( org_path )   ## make sure path exists
 
@@ -26,11 +20,11 @@ module Mono
 
           Dir.chdir( org_path ) do
             if Dir.exist?( repo.name )
-              GitProject.open( repo.name ) do |git|
-                if git.changes?
+              GitProject.open( repo.name ) do |proj|
+                if proj.changes?
                   puts "!! WARN - local changes in workdir; skipping fast forward (remote) sync / merge"
                 else
-                  git.fast_forward   ## note: use git pull --ff-only (fast forward only - do NOT merge)
+                  proj.fast_forward   ## note: use git pull --ff-only (fast forward only - do NOT merge)
                 end
               end
             else

data/lib/mono/tool.rb

@@ -26,6 +26,8 @@ class Tool
       Mono.fetch
    when 'env', 'e'
       Mono.env
+   when 'run', 'r', 'exec'
+      Mono.run( args )
    else
      puts "!! ERROR: unknown command >#{cmd}<"
      exit 1

data/lib/mono/version.rb

@@ -1,28 +1,33 @@
 ## note: use a different module/namespace
-##   for the gem version info e.g. Mono::Module vs Mono
+##   for the gem version info e.g. MonoCore vs Mono
 
-module Mono
+module MonoCore   ## todo/check: rename to MonoMeta, MonoModule or such - why? why not?
+
+  ## note: move root to its own namespace to avoid
+  ##   conflict with Mono.root!!!!
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
-  MINOR = 2
-  PATCH = 1
+  MINOR = 3
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version
     VERSION
   end
 
+  def self.banner
+    "monos/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(__FILE__) ))
+  end
 
-  module Module
-     ## note: move root to its own namespace to avoid
-     ##   conflict with Mono.root!!!!
+end # module MonoCore
 
-    def self.banner
-      "monos/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
-    end
 
-    def self.root
-      File.expand_path( File.dirname(File.dirname(__FILE__) ))
-    end
+##################################
+# add a convenience shortcut for now - why? why not?
+module Mono
+  VERSION = MonoCore::VERSION
+end
 
-  end # module Module
-end # module Mono

data/lib/{mono/sportdb.rb → sportdb/setup.rb}

@@ -13,7 +13,7 @@
 
 
 ## todo/fix: move later app/gem-family/-specific configs
-##   to its own gem e.g. mono-sportdb or such - why? why not?
+##   to its own gem e.g. mono-sportdb or sportdb-boot/starter/startup or such - why? why not?
 
 
 
@@ -40,30 +40,22 @@ require_relative '../mono'
 
 
 
-
-SPORTDB_DIR      = "#{Mono.root}/sportdb"     # path to libs
-OPENFOOTBALL_DIR = "#{Mono.root}/openfootball"
-## add more "standard" dirs - why? why not? - why? why not?
-##   use
-##  module SportDb::Source / Code / Boot or such????
-##
-##  use module SportDb::Boot  - yes, yes, yes - why? why not?
-
-
-
 ## convenience pre-configured/pre-built shortcut - lets you use
-##    require 'mono/sportdb'
-##    Mono.setup
+##    require 'sportdb/setup'
+##    SportDb::Boot.setup
+
 
-##  use SportDb::Boot.setup (setup_load_path)  or such??? - why? why not?
+module SportDb
+module Boot
+  def self.root()  Mono.root; end
 
-module Mono
-    def self.setup   ## setup load path
+  def self.setup   ## setup load path
 ### note: for now always assume dev/development
 ###   add ENV check later or pass in as args or such
 
-    puts "Mono.root: >#{root}<"
+    puts "SportDb::Boot.root: >#{root}<"
 
+    ### todo/fix: use an inline Gemfile and bundler's setup? why? why not?
     $LOAD_PATH.unshift( "#{root}/yorobot/sport.db.more/sportdb-exporters/lib" )
     $LOAD_PATH.unshift( "#{root}/yorobot/sport.db.more/sportdb-writers/lib" )
     $LOAD_PATH.unshift( "#{root}/yorobot/sport.db.more/sportdb-linters/lib" )
@@ -90,20 +82,25 @@ module Mono
     $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/alphabets/lib" )
 
     pp $:  # print load path
-  end
-end # module Mono
+    end  # method setup
+end # module Boot
+end # module Sportdb
+
 
+### use something like SportDb::Path[:sportdb]
+##                     SportDb.path( :sportdb )
+##                     SportDb::Boot.sportdb_path or sportdb_dir or such???
+##                     SportDb::Env.path( 'sportdb' )  ???
+##                     SportDb::Env::SPORTDB_DIR ???
+##                     or such - why? why not?
+##
+##  check rails path setup / style ???
 
-## todo/fix:
+SPORTDB_DIR      = "#{SportDb::Boot.root}/sportdb"     # path to libs
+OPENFOOTBALL_DIR = "#{SportDb::Boot.root}/openfootball"
+## add more "standard" dirs - why? why not? - why? why not?
 ##   use
-##   module Starter
-##    module SportDb
-##      def setup ...
-##   end
-##   end
+##  module SportDb::Source / Code / Boot or such????
 ##
-## or such? and use Mono.extend - why? why not?
-## module Mono
-##   extend Starter::SportDb
-## end
+##  use module SportDb::Boot  - yes, yes, yes - why? why not?
 

data/test/test_base.rb

@@ -6,10 +6,14 @@ require 'helper'
 
 class TestBase < MiniTest::Test
 
+  Git = Mono::Git
+
   def test_version
+    puts MonoCore::VERSION
+    puts MonoCore.banner
+    puts MonoCore.root
+
     puts Mono::VERSION
-    puts Mono::Module.banner
-    puts Mono::Module.root
   end
 
   def test_root
@@ -20,5 +24,28 @@ class TestBase < MiniTest::Test
     puts Mono.env
   end
 
+
+  def test_git_config
+    puts "---"
+    Git.config( 'user.name' )
+    Git.config( 'user.name', show_origin: true )
+    # Git.config( 'user.name', show_scope: true )
+
+    puts "---"
+    Git.config( /user/ )   ## note: pass in regex for regex match/search
+    Git.config( /user/, show_origin: true )
+    # Git.config( /user/, show_scope: true )
+
+    puts "---"
+    Git.config( /user\./ )   ## note: pass in regex for regex match/search
+
+    puts "---"
+    ## note: if NOT found Mono::Git.config will exit(1) !!!
+    ## Mono::Git.config( /proxy/, show_origin: true )
+    ## Mono::Git.config( /http/,  show_origin: true )
+
+    puts "---"
+  end
+
 end # class TestBase
 

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: monos
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-04 00:00:00.000000000 Z
+date: 2020-09-06 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: gitti
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -59,13 +73,13 @@ files:
 - lib/mono/base.rb
 - lib/mono/commands/env.rb
 - lib/mono/commands/fetch.rb
+- lib/mono/commands/run.rb
 - lib/mono/commands/status.rb
 - lib/mono/commands/sync.rb
-- lib/mono/git/base.rb
-- lib/mono/sportdb.rb
 - lib/mono/tool.rb
 - lib/mono/version.rb
 - lib/monos.rb
+- lib/sportdb/setup.rb
 - test/helper.rb
 - test/test_base.rb
 homepage: https://github.com/sportdb/sport.db

data/lib/mono/git/base.rb

@@ -1,226 +0,0 @@
-
-class GitError < StandardError
-end
-
-class Git   ## make Git a module - why? why not?
-
-  ###
-  ## todo/fix:  change opts=nil to *args or such - why? why not?
-
-
-  ###############
-  ## "setup" starter git commands
-
-  def self.clone( repo, name=nil )
-    cmd = "git clone #{repo}"
-    cmd << " #{name}"   unless name.nil? || name.empty?
-    Shell.run( cmd )
-  end
-
-  def self.mirror( repo )
-    cmd = "git clone --mirror #{repo}"
-    Shell.run( cmd )
-  end
-
-
-  #################
-  ## standard git commands
-
-  def self.version
-    cmd = 'git --version'
-    Shell.run( cmd )
-  end
-
-  def self.status( short: false )
-    cmd = 'git status'
-    cmd << " --short"   if short
-    Shell.run( cmd )
-  end
-
-  def self.changes  ## same as git status --short  - keep shortcut / alias - why? why not?
-    ## returns changed files - one per line or empty if no changes
-    cmd = 'git status --short'
-    Shell.run( cmd )
-  end
-
-  #####################
-  ## status helpers
-
-  ## git status --short  returns empty stdout/list
-  def self.clean?()   changes.empty?; end
-
-  def self.changes?() clean? == false; end  ## reverse of clean?
-  class << self
-    alias_method :dirty?, :changes?  ## add alias
-  end
-
-
-  #######
-  ## more (major) git commands
-
-  def self.fetch
-    cmd = 'git fetch'
-    Shell.run( cmd )
-  end
-
-  def self.pull
-    cmd = 'git pull'
-    Shell.run( cmd )
-  end
-
-  def self.fast_forward
-    cmd = 'git pull --ff-only'
-    Shell.run( cmd )
-  end
-  class << self
-    alias_method :ff, :fast_forward   ## add alias
-  end
-
-
-  def self.push
-    cmd = 'git push'
-    Shell.run( cmd )
-  end
-
-  def self.add( pathspec=nil )  ## e.g. git add .  or git add *.rb or such
-    cmd = 'git add'
-    cmd << " #{pathspec}"   unless pathspec.nil? || pathspec.empty?
-    Shell.run( cmd )
-  end
-
-  def self.add_all
-    cmd = 'git add --all'
-    Shell.run( cmd )
-  end
-
-  def self.commit( message: )
-    cmd = 'git commit'
-    cmd << %Q{ -m "#{message}"}  unless message.nil? || message.empty?
-    Shell.run( cmd )
-  end
-
-
-  #############
-  #  change git ls-files to git ls-tree ... - why? why not?
-  #
-  #  git ls-tree --full-tree --name-only -r HEAD
-  #   --full-tree makes the command run as if you were in the repo's root directory.
-  #   -r recurses into subdirectories. Combined with --full-tree, this gives you all committed, tracked files.
-  #   --name-only removes SHA / permission info for when you just want the file paths.
-  #   HEAD specifies which branch you want the list of tracked, committed files for.
-  #     You could change this to master or any other branch name, but HEAD is the commit you have checked out right now.
-  #
-  #   see https://stackoverflow.com/questions/15606955/how-can-i-make-git-show-a-list-of-the-files-that-are-being-tracked
-  #
-  #  was:
-
-  def self.files  ## was: e.g. git ls-files .  or git ls-files *.rb or such
-    cmd =  'git ls-tree --full-tree --name-only -r HEAD'  # was:  'git ls-files'
-    Shell.run( cmd )
-  end
-  ## add list_files or ls_files alias - why? why not?
-
-
-###
-#  use nested class for "base" for running commands - why? why not?
-class Shell
-def self.run( cmd )
-  print "cmd exec >#{cmd}<..."
-  stdout, stderr, status = Open3.capture3( cmd )
-
-  if status.success?
-    print " OK"
-    print "\n"
-  else
-    print " FAIL (#{status.exitstatus})"
-    print "\n"
-  end
-
-  unless stdout.empty?
-    puts stdout
-  end
-
-  unless stderr.empty?
-    ## todo/check: or use >2: or &2: or such
-    ##  stderr output not always an error (that is, exit status might be 0)
-    puts "STDERR:"
-    puts stderr
-  end
-
-  if status.success?
-    stdout   # return stdout string
-  else
-    puts "!! ERROR: cmd exec >#{cmd}< failed with exit status #{status.exitstatus}:"
-    puts stderr
-    raise GitError, "git cmd exec >#{cmd}< failed with exit status #{status.exitstatus}<: #{stderr}"
-  end
-end
-end # class Shell
-
-end # class Git
-
-
-
-class GitProject
-  def self.open( path, &blk )
-    new( path ).open( &blk )
-  end
-
-  def initialize( path )
-    raise ArgumentError, "dir >#{path}< not found; dir MUST already exist for GitProject class - sorry"   unless Dir.exist?( path )
-    raise ArgumentError, "dir >#{path}/.git< not found; dir MUST already be initialized with git for GitProject class - sorry"  unless Dir.exist?( "#{path}/.git" )
-    @path = path
-  end
-
-
-  def open( &blk )
-    ## puts "Dir.getwd: #{Dir.getwd}"
-    Dir.chdir( @path ) do
-      blk.call( self )
-    end
-    ## puts "Dir.getwd: #{Dir.getwd}"
-  end
-
-
-  def status( short: false )    Git.status( short: short ); end
-  def changes()                 Git.changes; end
-  def clean?()                  Git.clean?; end
-  def changes?()                Git.changes?; end
-  alias_method :dirty?, :changes?
-
-
-  def fetch()                   Git.fetch; end
-  def pull()                    Git.pull; end
-  def fast_forward()            Git.fast_forward; end
-  alias_method :ff, :fast_forward
-
-  def push()                    Git.push; end
-
-  def add( pathspec )           Git.add( pathspec ); end
-  def add_all()                 Git.add_all; end
-  def commit( message: )        Git.commit( message: message ); end
-
-  def files()                   Git.files; end
-
-end # class GitProject
-
-
-
-
-## todo: change to GitHubRepoRef or GitHubProject
-##   or Git::GitHub or Git::Source::GitHub or such - why? why not?
-class GitHubRepo
-  attr_reader :owner, :name
-
-  def initialize( owner, name )
-    @owner = owner    ## use/rename to login or something - why? why not??
-    @name  = name     #  e.g. "rubylibs/webservice"
-  end
-
-  def ssh_clone_url
-     ##  check: use https: as default? for github - http:// still supported? or redirected?
-     ## "http://github.com/#{@owner}/#{@name}"
-     "git@github.com:#{@owner}/#{@name}.git"
-  end
-end   ## class GitHubRepo
-