monos 0.4.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 17e75b31f208961c34bd615af15547d1ebe2f0ba
-  data.tar.gz: 150a65ae3b0296acd3659732193377f4552ad1f9
+  metadata.gz: 9c0413c2258822899cb73e090438d21f3ea82fc5
+  data.tar.gz: a9cd0ddc80ea90a8c7cdbafc7a917eeabadb5b8f
 SHA512:
-  metadata.gz: 17b55bd1201b91de073dd1e06fc35834231f0a0092fae88c9a6fbcf9f321127e77fb459786e5ba517508fbe66d8ee04f0d4a14ff6c9099be21fdc1124a16cbbc
-  data.tar.gz: ac18e206c095d17a2586a7c7d6da30017010fa9aba2ff73be58b265be548bbb5712676ff482560d45d9a3a261b450e1cd86f3f15ae2a337dbb11836c8850819f
+  metadata.gz: bc5c4b2083a234faded31cc4bdad78068709c8d7f6aa0e4a21fa1eb0c276f9ba6d6b34fe77b3fcafac9f6024701536337563b5b9d1b7d7b1fa026f045592c3ac
+  data.tar.gz: db404f05b726c7d233996dca624e6e3bc9cfb204d721ca9ee43be701ea2f658d4a0f03233524aa1d4e7b70c218052ea05cf67f347185063cdb5d53b9e106ddb9

data/Manifest.txt

@@ -12,9 +12,10 @@ 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
+test/test_path.rb

data/README.md

@@ -1,8 +1,8 @@
 # monos - monorepo / mono source tree tools and (startup) scripts
 
 
-* home  :: [github.com/rubycoco/monos](https://github.com/rubycoco/monos)
-* bugs  :: [github.com/rubycoco/monos/issues](https://github.com/rubycoco/monos/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)

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/rubycoco/monos' }
+  self.urls = { home: 'https://github.com/rubycoco/git' }
 
   self.author = 'Gerald Bauer'
   self.email  = 'opensport@googlegroups.com'
@@ -20,7 +20,7 @@ Hoe.spec 'monos' do
   self.licenses = ['Public Domain']
 
   self.extra_deps = [
-    ['gitti',         '>= 0.4.0' ],
+    ['gitti',         '>= 0.6.1' ],
     ['gitti-backup',  '>= 0.4.1' ],
   ]
 

data/lib/mono.rb

@@ -18,8 +18,9 @@ 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'
@@ -30,5 +31,4 @@ require 'mono/commands/run'
 require 'mono/tool'
 
 
-
 puts MonoCore.banner   # say hello

data/lib/mono/base.rb

@@ -1,40 +1,160 @@
-
-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
+
+
+
+
+  MONOFILES = ['monorepo.yml', 'monotree.yml', 'repos.yml']
+
+  def self.find_monofile
+    MONOFILES.each do |name|
+      return "./#{name}"  if File.exist?( "./#{name}")
+    end
+
+    nil  ## no monofile found; return nil
+  end
+
+  def self.monofile
+    path = find_monofile
+
+    if path
+      GitRepoSet.read( path )
+    else
+      puts "!! WARN: no mono configuration file found; looking for #{MONOFILES.join(', ')} in (#{Dir.getwd})"
+      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, depth: nil )
+    ## lets you use:
+    ##   @rubycoco/gitti  or
+    ##   gitti@rubycoco
+    ##  =>  rubycoco/gitti
+    norm_name = MonoFile.norm_name( name )
+    path      = "#{Mono.root}/#{norm_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:#{norm_name}.git"
+
+    Dir.chdir( org_path ) do
+      Gitti::Git.clone( ssh_clone_url, depth: depth )
+    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}/#{norm_name( path )}"
+    end
+
+    def self.norm_name( path )
+      #  turn
+      #  - @yorobot/stage/one
+      #  - one@yorobot/stage
+      #  - stage/one@yorobot
+      #      => into
+      #  - yorobot/stage/one
+
+
+      parts = path.split( '@' )
+      raise ArgumentError, "no (required) @ found in name; got >#{path}<"               if parts.size == 1
+      raise ArgumentError, "too many @ found (#{parts.size-1}) in name; got >#{path}<"  if parts.size > 2
+
+      norm_name = String.new('')
+      norm_name << parts[1]  ## add orgs path first
+      if parts[0].length > 0   ## has leading repo name (w/ optional path)
+        norm_name << '/'
+        norm_name << parts[0]
+      end
+      norm_name
+    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, depth: nil ) MonoGitHub.clone( name, depth: depth ); end
+  def self.real_path( name )         MonoFile.real_path( name ); end
+end  ## module Mono
+
+

data/lib/mono/commands/backup.rb

@@ -1,15 +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
+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,41 +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 'backup', 'back', 'b'
-      Mono.backup
-   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,9 +5,9 @@ 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 = 4
-  PATCH = 0
+  MAJOR = 1    ## todo: namespace inside version or something - why? why not??
+  MINOR = 0
+  PATCH = 2
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/test/test_path.rb

@@ -0,0 +1,23 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_path.rb
+
+require 'helper'
+
+class TestPath < MiniTest::Test
+
+
+def test_real_path
+  [
+    '@yorobot/stage/one',
+    'one@yorobot/stage',
+    'stage/one@yorobot',
+  ].each do |name|
+     puts "#{name} => >#{MonoFile.norm_name( name )}<"
+
+     assert_equal "#{Mono.root}/yorobot/stage/one", Mono.real_path( name )
+  end
+end
+
+end # class TestPath
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: monos
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 1.0.2
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-06 00:00:00.000000000 Z
+date: 2020-10-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gitti
@@ -16,14 +16,14 @@ 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
@@ -42,30 +42,36 @@ dependencies:
   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:
@@ -91,13 +97,14 @@ files:
 - 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/rubycoco/monos
+- test/test_path.rb
+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?
-