monos 0.3.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5cafc90639b5bb02b8be04d5f993dd518a53db83
-  data.tar.gz: b3aba3dbae6d86e86d78eb53add58def4faa3844
+  metadata.gz: cce729ba6d11269232cc35aeb9bd0e776cbbc8c6
+  data.tar.gz: d9bc60169106dc76750a275e9bd8e5bd71cb6333
 SHA512:
-  metadata.gz: 9192d91ab18d06d5b167be39171f86d71daf40629c5cf5aeeff8de9e8cb9c5b681e33de16ef08e02ee2986c97b46e9c4bc2292e364d6dab94ee6f28ce98e93e0
-  data.tar.gz: a48bacb9f54bf48e6264c9ece66e030cdd3c8c900373d141cc4d430b913851b802b4cb8b8c6d4d3c7b9f458584dcc372fe4e7e0ea45585d6cfcc20ca6f5a6414
+  metadata.gz: c43df16d49a5928d0937a0869b342966c5302543791084b1914a137fd984a2f55e99bd7c1d2f335c76a84142951e2a223f15f7d2a7e4789fc25782e1d5d06a6c
+  data.tar.gz: 86003e902a54018859e48c627e15027711b67aa2bd51f3c36c7963a6cd0a8ec4731089fb54c43c33583973334de569d2d5ca72e4341ff1491a33997e835a3916

data/Manifest.txt

@@ -6,14 +6,15 @@ bin/mo
 bin/mono
 lib/mono.rb
 lib/mono/base.rb
+lib/mono/commands/backup.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/experimental.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

@@ -1,8 +1,8 @@
 # monos - monorepo / mono source tree tools and (startup) scripts
 
 
-* home  :: [github.com/sportdb/sport.db](https://github.com/sportdb/sport.db)
-* bugs  :: [github.com/sportdb/sport.db/issues](https://github.com/sportdb/sport.db/issues)
+* home  :: [github.com/rubycoco/git](https://github.com/rubycoco/git)
+* bugs  :: [github.com/rubycoco/git/issues](https://github.com/rubycoco/git/issues)
 * gem   :: [rubygems.org/gems/monos](https://rubygems.org/gems/monos)
 * rdoc  :: [rubydoc.info/gems/monos](http://rubydoc.info/gems/monos)
 * forum :: [opensport](http://groups.google.com/group/opensport)
@@ -52,7 +52,7 @@ openfootball:
 
 ### Commands
 
-`status` • `fetch` • `sync` • `run` •`env`
+`status` • `fetch` • `sync` • `run` • `env` • `backup`
 
 ### `status` Command
 
@@ -141,6 +141,20 @@ Note: `exec` is an alias that you can use for `run`.
 Use the `env` command to check your `mono` environment setup.
 
 
+
+
+### `backup` Command
+
+Use the `backup` command to backup all repos using
+the [`gitti-backup` machinery »](https://github.com/rubycoco/gitti/tree/master/gitti-backup)
+
+In a nutshell backup will backup all repos by using
+1. `git clone --mirror` or
+2. `git remote update`  (if the local backup already exists)
+and store all bare repos (without workspace) in the `~/backup` directory.
+
+
+
 That's all for now.
 
 

data/Rakefile

@@ -8,7 +8,7 @@ Hoe.spec 'monos' do
   self.summary = "monos - monorepo / mono source tree tools and (startup) scripts"
   self.description = summary
 
-  self.urls = { home: 'https://github.com/sportdb/sport.db' }
+  self.urls = { home: 'https://github.com/rubycoco/git' }
 
   self.author = 'Gerald Bauer'
   self.email  = 'opensport@googlegroups.com'
@@ -20,7 +20,8 @@ Hoe.spec 'monos' do
   self.licenses = ['Public Domain']
 
   self.extra_deps = [
-    ['gitti', '>= 0.4.0' ],
+    ['gitti',         '>= 0.6.1' ],
+    ['gitti-backup',  '>= 0.4.1' ],
   ]
 
   self.spec_extras = {

data/lib/mono.rb

@@ -2,6 +2,8 @@
 ##   note: use the "modular" version WITHOUT auto-include gitti,
 ##          thus, require 'gitti/base' (and NOT 'gitti')
 require 'gitti/base'
+require 'gitti/backup/base'
+
 
 module Mono
   ## note: make Git, GitProject, GitRepoSet, etc. available without Gitti::
@@ -16,16 +18,17 @@ end
 
 ###
 # our own code
-require 'mono/version' # let version always go first
+require 'mono/version'      # let version always go first
 require 'mono/base'
+require 'mono/experimental'
 
 require 'mono/commands/status'
 require 'mono/commands/fetch'
 require 'mono/commands/sync'
 require 'mono/commands/env'
+require 'mono/commands/backup'
 require 'mono/commands/run'
 require 'mono/tool'
 
 
-
 puts MonoCore.banner   # say hello

data/lib/mono/base.rb

@@ -1,40 +1,131 @@
-
-module Mono
-
-  def self.root   ## root of single (monorepo) source tree
-    @@root ||= begin
-        ## todo/fix:
-        ##  check if windows - otherwise use /sites
-        ##  check if root directory exists?
-        if ENV['MOPATH']
-          ENV['MOPATH']
-        elsif Dir.exist?( 'C:/Sites' )
-          'C:/Sites'
-        else
-          '/sites'
-        end
-    end
-  end
-
-  def self.monofile
-    path =  if File.exist?( './monorepo.yml' )
-               './monorepo.yml'
-            elsif File.exist?( './monotree.yml' )
-               './monotree.yml'
-            elsif File.exist?( './repos.yml' )
-               './repos.yml'
-            else
-               puts "!! WARN: no mono configuration file (that is, {monorepo,monotree,repos}.yml) found in >#{Dir.getwd}<"
-               nil
-            end
-
-    if path
-      GitRepoSet.read( path )
-    else
-      GitRepoSet.new( {} )  ## return empty set -todo/check: return nil - why? why not?
-    end
-  end
-
-end  ## module Mono
-
-
+
+module Mono
+
+  def self.root   ## root of single (monorepo) source tree
+    @@root ||= begin
+        ## todo/fix:
+        ##  check if windows - otherwise use /sites
+        ##  check if root directory exists?
+        if ENV['MOPATH']
+          ## use expand path to make (assure) absolute path - why? why not?
+          ::File.expand_path( ENV['MOPATH'] )
+        elsif ::Dir.exist?( 'C:/Sites' )
+          'C:/Sites'
+        else
+          '/sites'
+        end
+    end
+  end
+
+  def self.root=( path )
+    ## use expand path to make (assure) absolute path - why? why not?
+    @@root = ::File.expand_path( path )
+  end
+
+
+
+
+  def self.monofile
+    path =  if ::File.exist?( './monorepo.yml' )
+               './monorepo.yml'
+            elsif ::File.exist?( './monotree.yml' )
+               './monotree.yml'
+            elsif ::File.exist?( './repos.yml' )
+               './repos.yml'
+            else
+               puts "!! WARN: no mono configuration file (that is, {monorepo,monotree,repos}.yml) found in >#{Dir.getwd}<"
+               nil
+            end
+
+    if path
+      GitRepoSet.read( path )
+    else
+      GitRepoSet.new( {} )  ## return empty set -todo/check: return nil - why? why not?
+    end
+  end
+end  ## module Mono
+
+
+
+
+#####################
+#  add file and repo helper
+
+##
+## todo/fix:  ALWAYS assert name format
+##   (rename to mononame and monopath) - why? why not?
+
+class MonoGitHub
+  def self.clone( name )
+    path = MonoFile.real_path( name )
+
+    org_path = File.dirname( path )
+    FileUtils.mkdir_p( org_path ) unless Dir.exist?( org_path )   ## make sure path exists
+
+    ### note: use a github clone url (using ssh) like:
+    ##     git@github.com:rubycoco/gitti.git
+    ssh_clone_url = "git@github.com:#{name}.git"
+
+    Dir.chdir( org_path ) do
+      Gitti::Git.clone( ssh_clone_url )
+    end
+  end
+end
+MonoGithub = MonoGitHub  ## add convenience (typo?) alias
+
+
+
+class MonoGitProject
+  def self.open( name, &block )
+    path = MonoFile.real_path( name )
+    Gitti::GitProject.open( path, &block )
+  end
+end
+
+
+
+class MonoFile
+    ## e.g. openfootball/austria etc.
+    ##      expand to to "real" absolute path
+    ##
+    ## todo/check: assert name must be  {orgname,username}/reponame
+    def self.real_path( path )
+      "#{Mono.root}/#{path}"
+    end
+    def self.exist?( path )
+      ::File.exist?( real_path( path ))
+    end
+
+
+    ## path always relative to Mono.root
+    ##   todo/fix:  use File.expand_path( path, Mono.root ) - why? why not?
+    ##    or always enfore "absolut" path e.g. do NOT allow ../ or ./ or such
+    def self.open( path, mode='r:utf-8', &block )
+       full_path = real_path( path )
+       ## make sure path exists if we open for writing/appending - why? why not?
+       if mode[0] == 'w' || mode[0] == 'a'
+        ::FileUtils.mkdir_p( ::File.dirname( full_path ) )  ## make sure path exists
+       end
+
+       ::File.open( full_path, mode ) do |file|
+         block.call( file )
+       end
+    end
+
+    def self.read_utf8( path )
+       open( path, 'r:utf-8') { |file| file.read }
+    end
+end  ## class MonoFile
+
+
+
+module Mono
+  #################
+  ## add some short cuts
+  def self.open( name, &block ) MonoGitProject.open( name, &block ); end
+  def self.clone( name )        MonoGitHub.clone( name ); end
+  def self.real_path( name)     MonoFile.real_path( name ); end
+end  ## module Mono
+
+
+

data/lib/mono/commands/backup.rb

@@ -0,0 +1,15 @@
+module Mono
+
+  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
+  def self.backup
+    repos = Mono.monofile
+
+    backup = GitBackup.new
+
+    ## step 2: pass in all repos to backup by using
+    ##   1) git clone --mirror or
+    ##   2) git remote update  (if local backup already exists)
+    backup.backup( repos )
+  end # method backup
+
+end  # module Mono

data/lib/mono/commands/env.rb

@@ -1,26 +1,26 @@
-module Mono
-
-  def self.env   ## check environment setup
-    puts "Mono.root (MOPATH): >#{Mono.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
-  end
-
-end # module Mono
+module Mono
+
+  def self.env   ## check environment setup
+    puts "Mono.root (MOPATH): >#{Mono.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
+  end
+
+end # module Mono

data/lib/mono/commands/fetch.rb

@@ -1,44 +1,43 @@
-module Mono
-
-  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
-  def self.fetch
-    repos = Mono.monofile
-
-    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.fetch
-              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 fetch
-
-end  # module Mono
+module Mono
+  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
+  def self.fetch
+    repos = Mono.monofile
+
+    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.fetch
+              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 fetch
+
+end  # module Mono

data/lib/mono/commands/run.rb

@@ -1,47 +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
+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,65 +1,65 @@
-module Mono
-
-  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
-  def self.status
-    repos = Mono.monofile
-
-    changes =  []   ## track changes
-
-    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|
-                output = proj.changes
-                if output.empty?
-                   puts "   - no changes -"
-                else
-                  changes << ["#{org}@#{name}", :CHANGES, output]
-                end
-              end
-            else
-              puts "!!  repo not found / missing"
-              changes << ["#{org}@#{name}", :NOT_FOUND]
-            end
-          end
-
-          count_repos += 1
-      end
-      count_orgs += 1
-    end
-
-
-    ## print stats & changes summary
-    puts
-    print "#{changes.size} change(s) in "
-    print "#{count_repos} repo(s) @ #{count_orgs} org(s)"
-    print "\n"
-
-    changes.each do |item|
-      puts
-      print "== #{item[0]} - #{item[1]}"
-      case item[1]
-      when :CHANGES
-        print ":\n"
-        print item[2]
-      when :NOT_FOUND
-        print "\n"
-      end
-    end
-
-  end # method status
-
-end  # module Mono
+module Mono
+
+  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
+  def self.status
+    repos = Mono.monofile
+
+    changes =  []   ## track changes
+
+    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|
+                output = proj.changes
+                if output.empty?
+                   puts "   - no changes -"
+                else
+                  changes << ["#{org}@#{name}", :CHANGES, output]
+                end
+              end
+            else
+              puts "!!  repo not found / missing"
+              changes << ["#{org}@#{name}", :NOT_FOUND]
+            end
+          end
+
+          count_repos += 1
+      end
+      count_orgs += 1
+    end
+
+
+    ## print stats & changes summary
+    puts
+    print "#{changes.size} change(s) in "
+    print "#{count_repos} repo(s) @ #{count_orgs} org(s)"
+    print "\n"
+
+    changes.each do |item|
+      puts
+      print "== #{item[0]} - #{item[1]}"
+      case item[1]
+      when :CHANGES
+        print ":\n"
+        print item[2]
+      when :NOT_FOUND
+        print "\n"
+      end
+    end
+
+  end # method status
+
+end  # module Mono

data/lib/mono/commands/sync.rb

@@ -1,53 +1,53 @@
-module Mono
-
-  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
-  def self.sync
-    repos = Mono.monofile
-
-    count_orgs  = 0
-    count_repos = 0
-
-    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
-
-      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|
-                if proj.changes?
-                  puts "!! WARN - local changes in workdir; skipping fast forward (remote) sync / merge"
-                else
-                  proj.fast_forward   ## note: use git pull --ff-only (fast forward only - do NOT merge)
-                end
-              end
-            else
-              Git.clone( repo.ssh_clone_url )
-            end
-          end
-
-#
-# todo/fix: add (back) error log !!!!!!!!!!!!
-#        rescue GitError => ex
-#          puts "!! ERROR: #{ex.message}"
-#
-#          File.open( './errors.log', 'a' ) do |f|
-#              f.write "#{Time.now} -- repo #{org}/#{name} - #{ex.message}\n"
-#           end
-
-          count_repos += 1
-      end
-      count_orgs += 1
-    end
-
-    ## print stats
-    puts "#{count_repos} repo(s) @ #{count_orgs} org(s)"
-  end # method sync
-
-end  # module Mono
+module Mono
+
+  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
+  def self.sync
+    repos = Mono.monofile
+
+    count_orgs  = 0
+    count_repos = 0
+
+    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
+
+      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|
+                if proj.changes?
+                  puts "!! WARN - local changes in workdir; skipping fast forward (remote) sync / merge"
+                else
+                  proj.fast_forward   ## note: use git pull --ff-only (fast forward only - do NOT merge)
+                end
+              end
+            else
+              Git.clone( repo.ssh_clone_url )
+            end
+          end
+
+#
+# todo/fix: add (back) error log !!!!!!!!!!!!
+#        rescue GitError => ex
+#          puts "!! ERROR: #{ex.message}"
+#
+#          File.open( './errors.log', 'a' ) do |f|
+#              f.write "#{Time.now} -- repo #{org}/#{name} - #{ex.message}\n"
+#           end
+
+          count_repos += 1
+      end
+      count_orgs += 1
+    end
+
+    ## print stats
+    puts "#{count_repos} repo(s) @ #{count_orgs} org(s)"
+  end # method sync
+
+end  # module Mono

data/lib/mono/experimental.rb

@@ -0,0 +1,104 @@
+##############
+# experimental stuff
+#
+
+module Mono
+
+######################
+### lint/print mono (source) tree
+###   - check for git repos (via .git/ dir)
+#
+#  turn into
+#   - tree or
+#   - lint or
+#   - doctor or
+#   - check or such command - why? why not?
+def self.walk( path=root)
+   repos = walk_dir( path )
+   repos
+end
+
+
+###############
+# private helpers
+private
+
+## todo/check - use max_depth or max_level or such - why? why not?
+def self.walk_dir( path, repos=[], level=1, depth: nil )
+  entries = ::Dir.entries(path)
+
+  ## filter dirs
+  dirs = entries.select do |entry|
+    if ['..', '.'].include?( entry )  ## first check for excludes
+      false
+    else
+      full_path = ::File.join( path, entry )
+      ::File.directory?( full_path )
+    end
+  end
+
+  if dirs.size == 0   ## shortcircuit - no dirs in dir
+    return repos
+  end
+
+  repos_count = 0  ## note: local (only) repos count
+  warns_count = 0
+  sub_dirs = []
+
+
+
+  buf = String.new('')    ## use an output buffer (allows optional print)
+
+
+  buf << ">#{path}< - level #{level}:\n"
+  dirs.each do |entry|
+    next if ['..', '.', '.git'].include?( entry )
+    full_path = ::File.join( path, entry )
+
+    if ::Dir.exist?( ::File.join( full_path, '.git' ))
+      repos_count += 1
+
+      if level == 1
+        warns_count += 1
+        buf << "!! WARN - top-level repo (w/o user/org) >#{entry}< @ #{path}\n"
+      end
+
+      if level > 2
+        warns_count += 1
+        buf << "!! WARN - hidden (?) sub-level #{level} repo (nested too deep?) >#{entry}< @ #{path}\n"
+      end
+
+      buf << "    repo ##{'%-2d' % repos_count} | "
+      buf << "#{'%-20s' % entry} @ #{::File.basename(path)} (#{path})"
+      buf << "\n"
+      repos << full_path
+
+    ## check for bare bone git repos  - todo/fix: add .gitconfig or such and more - why? why not?
+    elsif ::Dir.exist?( ::File.join( full_path, 'hooks' )) &&
+          ::Dir.exist?( ::File.join( full_path, 'info' )) &&
+          ::Dir.exist?( ::File.join( full_path, 'objects' )) &&
+          ::Dir.exist?( ::File.join( full_path, 'refs' ))
+      warns_count += 1
+      buf << "!! WARN - skip bare git repo >#{entry}< @ #{path}\n"
+    else
+      buf << "     x  >#{entry}<\n"
+      sub_dirs << entry
+    end
+  end
+  buf << "  #{repos_count} repos(s), #{dirs.size} dir(s), #{warns_count} warn(s)\n"
+  buf << "\n"
+
+  ## note: skip output of "plain" diretory listings (no repos, no warnings)
+  puts buf   if repos_count > 0 || warns_count > 0
+
+
+  sub_dirs.each do |entry|
+    ## continue walking
+    full_path = ::File.join( path, entry )
+    walk_dir( full_path, repos, level+1, depth: depth )
+  end
+
+  repos
+end
+
+end  # module Mono

data/lib/mono/tool.rb

@@ -1,39 +1,46 @@
-module Mono
-
-
-class Tool
-  def self.main( args=ARGV )
-
-   ## note: for now assume first argument is command
-   ##  add options later
-
-   cmd = if args.size == 0
-           'status'   ## make status "default" command
-         else
-           args.shift   ## remove first (head) element
-         end
-
-   ## note: allow shortcut for commands
-   case cmd.downcase
-   when 'status', 'stati', 'stat', 'st', 's'
-      Mono.status
-   when 'sync', 'syn', 'sy',  ## note: allow aliases such as install, get & up too
-        'get', 'g',
-        'install', 'insta', 'inst', 'ins', 'i',
-        'up', 'u'
-      Mono.sync
-   when 'fetch', 'f'
-      Mono.fetch
-   when 'env', 'e'
-      Mono.env
-   when 'run', 'r', 'exec'
-      Mono.run( args )
-   else
-     puts "!! ERROR: unknown command >#{cmd}<"
-     exit 1
-   end
-
-  end  # method self.main
-end # class Tool
-
+module Mono
+
+
+class Tool
+  def self.main( args=ARGV )
+
+   ## note: for now assume first argument is command
+   ##  add options later
+
+   cmd = if args.size == 0
+           'status'   ## make status "default" command
+         else
+           args.shift   ## remove first (head) element
+         end
+
+   ## note: allow shortcut for commands
+   case cmd.downcase
+   when 'status', 'stati', 'stat', 'st', 's'
+      Mono.status
+   when 'sync', 'syn', 'sy',  ## note: allow aliases such as install, get & up too
+        'get', 'g',
+        'install', 'insta', 'inst', 'ins', 'i',
+        'up', 'u'
+      Mono.sync
+   when 'fetch', 'f'
+      Mono.fetch
+   when 'env', 'e'
+      Mono.env
+   when 'backup', 'back', 'b'
+      Mono.backup
+   when 'run', 'r', 'exec'
+      Mono.run( args )
+
+   ##################
+   ## for debugging / linting
+   when 'walk'
+      Mono.walk
+   else
+     puts "!! ERROR: unknown command >#{cmd}<"
+     exit 1
+   end
+
+  end  # method self.main
+end # class Tool
+
 end # module Mono

data/lib/mono/version.rb

@@ -5,8 +5,8 @@ module MonoCore   ## todo/check: rename to MonoMeta, MonoModule or such - why? w
 
   ## 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 = 3
+  MAJOR = 1    ## todo: namespace inside version or something - why? why not??
+  MINOR = 0
   PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: monos
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-06 00:00:00.000000000 Z
+date: 2020-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gitti
@@ -16,42 +16,62 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.6.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.6.1
+- !ruby/object:Gem::Dependency
+  name: gitti-backup
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.1
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: hoe
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.16'
+        version: '3.22'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.16'
+        version: '3.22'
 description: monos - monorepo / mono source tree tools and (startup) scripts
 email: opensport@googlegroups.com
 executables:
@@ -71,18 +91,19 @@ files:
 - bin/mono
 - lib/mono.rb
 - lib/mono/base.rb
+- lib/mono/commands/backup.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/experimental.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
+homepage: https://github.com/rubycoco/git
 licenses:
 - Public Domain
 metadata: {}

data/lib/sportdb/setup.rb

@@ -1,106 +0,0 @@
-########
-##
-#  fix:
-#   move to sportdb/setup   or sportdb/boot ?
-#   use module SportDb::Boot
-
-
-
-##########
-#  setup load path
-#     lets you use environments
-#     e.g. dev/development or production
-
-
-## todo/fix: move later app/gem-family/-specific configs
-##   to its own gem e.g. mono-sportdb or sportdb-boot/starter/startup or such - why? why not?
-
-
-
-
-
-$RUBYLIBS_DEBUG = true
-$RUBYCOCO_DEBUG = true    ## always include (NOT just in sportdb?)
-
-
-### include / check for ruby debug flag too - why? why not?
-def debug?     ## always include (NOT just insportdb?)
-  value = ENV['DEBUG']
-  if value && ['true', 't',
-               'yes', 'y',
-               'on'].include?( value.downcase )
-    true
-  else
-    false
-  end
-end
-
-
-require_relative '../mono'
-
-
-
-## convenience pre-configured/pre-built shortcut - lets you use
-##    require 'sportdb/setup'
-##    SportDb::Boot.setup
-
-
-module SportDb
-module Boot
-  def self.root()  Mono.root; end
-
-  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 "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" )
-
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sports/lib" )
-
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-importers/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-readers/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-sync/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-models/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-catalogs/lib" )
-
-    ## todo/check:
-    ##   add fifa, footballdb-leagues, footballdb-clubs too ???
-    $LOAD_PATH.unshift( "#{root}/sportdb/football.db/footballdb-clubs/lib" ))
-    $LOAD_PATH.unshift( "#{root}/sportdb/football.db/footballdb-leagues/lib" ))
-    $LOAD_PATH.unshift( "#{root}/sportdb/football.db/fifa/lib" ))
-
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-formats/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-structs/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-langs/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/score-formats/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/date-formats/lib" )
-    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/alphabets/lib" )
-
-    pp $:  # print load path
-    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 ???
-
-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 SportDb::Source / Code / Boot or such????
-##
-##  use module SportDb::Boot  - yes, yes, yes - why? why not?
-