monos 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 576b842ecee3e88c176654fdf0851b26c85b6e46
+  data.tar.gz: a6d79f70f3deb662cbb60e2d38a558a44a7e9716
+SHA512:
+  metadata.gz: 0bb43687058126a85c6fdbf3e8755c9c28f186686b2132a7a029522af5e65d3d671351cd1ea593fde3f2fe10df86f19893f01a6510d88eb5ecf2ccb531e9bf3b
+  data.tar.gz: 0dc9a08488c235d9df1d269b12a34243df3a7dec2ec6385b22268c692080824b03ea1c32dc9b44b0bd5caa68b63e3f07526cdbb35291127c2c9eb7ec1ee51be2

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.0.1 / 2020-08-30
+
+* Everything is new. First release.

data/Manifest.txt

@@ -0,0 +1,18 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+bin/mo
+bin/moget
+bin/mono
+lib/mono.rb
+lib/mono/base.rb
+lib/mono/git/base.rb
+lib/mono/git/status.rb
+lib/mono/git/sync.rb
+lib/mono/git/tool.rb
+lib/mono/sportdb.rb
+lib/mono/version.rb
+lib/monos.rb
+test/helper.rb
+test/test_base.rb

data/README.md

@@ -0,0 +1,26 @@
+# monos - tools and (startup) scripts for mono source trees / monorepos
+
+
+* 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)
+* 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)
+
+
+
+## Usage
+
+To be done
+
+## License
+
+The `monos` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+
+## Questions? Comments?
+
+Send them along to the
+[Open Sports & Friends Forum/Mailing List](http://groups.google.com/group/opensport).
+Thanks!

data/Rakefile

@@ -0,0 +1,27 @@
+require 'hoe'
+require './lib/mono/version.rb'
+
+Hoe.spec 'monos' do
+
+  self.version = Mono::Module::VERSION
+
+  self.summary = "monos - tools and (startup) scripts for mono source trees / monorepos"
+  self.description = summary
+
+  self.urls = ['https://github.com/sportdb/sport.db']
+
+  self.author = 'Gerald Bauer'
+  self.email = 'opensport@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.licenses = ['Public Domain']
+
+  self.extra_deps = []
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.2.2'
+  }
+end

data/bin/mo

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/mo
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/mo
+#
+
+require 'mono'
+
+Mono::Tool.main

data/bin/moget

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/moget
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/moget
+#
+
+require 'mono'
+
+Mono::Tool.main( ['sync'] )

data/bin/mono

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/mono
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/mono
+#
+
+require 'mono'
+
+Mono::Tool.main

data/lib/mono.rb

@@ -0,0 +1,20 @@
+require 'pp'
+require 'time'
+require 'date'
+require 'yaml'
+require 'open3'
+require 'fileutils'
+require 'optparse'
+
+
+###
+# our own code
+require 'mono/version' # let version always go first
+require 'mono/base'
+require 'mono/git/base'
+require 'mono/git/sync'
+require 'mono/git/status'
+require 'mono/git/tool'
+
+
+puts Mono::Module.banner   # say hello

data/lib/mono/base.rb

@@ -0,0 +1,15 @@
+
+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?
+        'C:/Sites'
+    end
+  end
+
+end  ## module Mono
+
+

data/lib/mono/git/base.rb

@@ -0,0 +1,174 @@
+
+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.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
+
+
+###
+#  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 GitRepo
+  def self.open( path, &blk )
+    new( path ).open( &blk )
+  end
+
+  def initialize( path )
+    raise ArgumentError, "dir >#{path}< not found; dir MUST already exist for GitRepo class - sorry"   unless Dir.exist?( path )
+    @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 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
+
+
+end # class GitRepo

data/lib/mono/git/status.rb

@@ -0,0 +1,73 @@
+
+
+module Mono
+
+  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
+  def self.status( h=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|
+
+      ## remove optional number from key e.g.
+      ##   mrhydescripts (3)    =>  mrhydescripts
+      ##   footballjs (4)       =>  footballjs
+      ##   etc.
+      org = org_with_counter.sub( /\([0-9]+\)/, '' ).strip
+
+      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 )
+              GitRepo.open( repo.name ) do |git|
+                output = git.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/git/sync.rb

@@ -0,0 +1,98 @@
+
+
+class GitHubRepo   ## todo: change to GitHubRepoRef or such - why? why not?
+  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
+
+
+
+module Mono
+
+  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 mo|moget|mono configuration file (that is, monorepo|monotree|repos.yml) found in >#{Dir.getwd}<"
+               nil
+            end
+
+    if path
+      YAML.load_file( path )
+    else
+      {}
+    end
+  end
+
+
+  ## pass along hash of repos (e.g. monorepo.yml or repos.yml )
+  def self.sync( h=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
+
+      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 )
+              GitRepo.open( repo.name ) do |git|
+                if git.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)
+                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/git/tool.rb

@@ -0,0 +1,33 @@
+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', '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
+   else
+     puts "!! ERROR: unknown command >#{cmd}<"
+     exit 1
+   end
+
+  end  # method self.main
+end # class Tool
+
+end # module Mono

data/lib/mono/sportdb.rb

@@ -0,0 +1,61 @@
+##########
+#  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 such - why? why not?
+
+
+
+require_relative '../mono'
+
+
+## convenience pre-configured/pre-built shortcut - lets you use
+##    require 'mono/sportdb'
+##    Mono.setup
+
+
+module Mono
+    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}<"
+
+    $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" )
+    ## todo - add readers, models, sync, etc.
+
+    $LOAD_PATH.unshift( "#{root}/sportdb/sport.db/sportdb-catalogs/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" )
+
+
+    pp $:  # print load path
+  end
+end # module Mono
+
+
+## todo/fix:
+##   use
+##   module Starter
+##    module SportDb
+##      def setup ...
+##   end
+##   end
+##
+## or such? and use Mono.extend - why? why not?
+## module Mono
+##   extend Starter::SportDb
+## end
+

data/lib/mono/version.rb

@@ -0,0 +1,25 @@
+## note: use a different module/namespace
+##   for the gem version info e.g. Mono::Module vs Mono
+
+module Mono
+  module Module
+
+    MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+    MINOR = 1
+    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
+
+  end # module Module
+end # module Mono

data/lib/monos.rb

@@ -0,0 +1,5 @@
+# note: allow require 'monos' too
+#        (in addition to require 'mono')
+
+require_relative './mono'
+

data/test/helper.rb

@@ -0,0 +1,7 @@
+## minitest setup
+require 'minitest/autorun'
+
+
+## our own code
+require 'mono'
+

data/test/test_base.rb

@@ -0,0 +1,20 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_base.rb
+
+require 'helper'
+
+class TestBase < MiniTest::Test
+
+  def test_version
+    puts Mono::Module::VERSION
+    puts Mono::Module.banner
+    puts Mono::Module.root
+  end
+
+  def test_root
+     puts Mono.root
+  end
+
+end # class TestBase
+

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: monos
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-09-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.16'
+description: monos - tools and (startup) scripts for mono source trees / monorepos
+email: opensport@googlegroups.com
+executables:
+- mo
+- moget
+- mono
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- bin/mo
+- bin/moget
+- bin/mono
+- lib/mono.rb
+- lib/mono/base.rb
+- lib/mono/git/base.rb
+- lib/mono/git/status.rb
+- lib/mono/git/sync.rb
+- lib/mono/git/tool.rb
+- lib/mono/sportdb.rb
+- lib/mono/version.rb
+- lib/monos.rb
+- test/helper.rb
+- test/test_base.rb
+homepage: https://github.com/sportdb/sport.db
+licenses:
+- Public Domain
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: monos - tools and (startup) scripts for mono source trees / monorepos
+test_files: []