sportdb-writers 0.2.0 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3483a7e2f321970a2e970ba30e272127892013b61c63be66431a318d32b52c3f
-  data.tar.gz: 4d213ad75e6973aa6ef95bee7fb39a62bca69cd3261fc18e2bfcfc9a6b913b87
+  metadata.gz: 7e39ff7eabe3ea46542b2578b6b16e78898c78fe050f51b8144edd58ca4db6cf
+  data.tar.gz: 5b7217690f74688ea6e58be0471a2469b384da68c2d11a26aaceb8b0dd0a2e89
 SHA512:
-  metadata.gz: b7b00a033d247555ca57acc503c88de73111605738998a9e5b3ea4e53f0353b08df19cfa1f9d5c84a5ad22b5528ddb632ba927b4f0b53fb5493f5391732d3d13
-  data.tar.gz: 23cec6ae8fa9b9ca04cf2242c86f8310de76a191b5a66bc4f2cab09aff7ea5c3e0a0d312bfe582dd2150d344302bdabab592c9b1944385bd75ae86de2367d207
+  metadata.gz: c2f423732fe974d9e6f422a2d1b5b511d67596e5ceaab96a812d2774008f86cc1b94a23c793c12c0b9a058f1a208d2ffc554ae7761777b719d679e1804a9bf91
+  data.tar.gz: e3ae9cf74f038df21a3f3275a03758eae2b1b110ec8571ed6fa6dd17cf4804eb5b34e6037ac85bbfe94a64b9f3645c0b9e8d6c8e67da11cf4f083f34e3417cb4

data/CHANGELOG.md

@@ -1,4 +1,4 @@
-### 0.2.0
+### 0.2.3
 
 ### 0.0.1 / 2020-11-15
 

data/Manifest.txt

@@ -4,17 +4,18 @@ README.md
 Rakefile
 bin/fbgen
 bin/fbtxt
+bin/fbup
 config/leagues_america.csv
 config/leagues_europe.csv
 config/leagues_world.csv
 config/openfootball.csv
-lib/sportdb/fbgen/github.rb
-lib/sportdb/fbgen/github_config.rb
 lib/sportdb/fbgen/main.rb
 lib/sportdb/fbtxt/main.rb
+lib/sportdb/fbup/github.rb
+lib/sportdb/fbup/github_config.rb
+lib/sportdb/fbup/main.rb
 lib/sportdb/writers.rb
 lib/sportdb/writers/goals.rb
 lib/sportdb/writers/league_config.rb
 lib/sportdb/writers/txt_writer.rb
 lib/sportdb/writers/version.rb
-lib/sportdb/writers/write.rb

data/Rakefile

@@ -18,6 +18,7 @@ Hoe.spec 'sportdb-writers' do
   self.history_file = 'CHANGELOG.md'
 
   self.extra_deps = [
+    ['football-timezones'],
     ['sportdb-quick'],
     ['gitti'],
   ]

data/bin/fbup

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/fbup
+
+
+require 'sportdb/writers'
+
+
+Fbup.main( ARGV )
+
+
+puts "bye"

data/config/leagues_america.csv

@@ -2,5 +2,15 @@ key,     name,                      basename,       start_season, end_season, co
 
 ar.1,    Argentina Primera Division, 1-primeradivision,,,
 br.1,    Brasileiro Série A,         1-seriea,,,
+br.2,    Brasileiro Série B,         1-serieb,,,
+
+copa.l,  Copa Libertadores,         libertadores,,,
+copa.s,  Copa Sudamericana,         sudamericana,,,
+
+
+mx.1,    Liga MX,                    1-ligamx,,,
+mx.2,    Liga de Expansión MX,       2-ligaexpansionmx,  2020/21,,
+mx.2,    Ascenso MX,                 2-ascensomx,               ,2019/20,
+
+
 
-mx.1,    Liga MX,                    1-ligamx,,,    ## note: basename gets overwritten by stages e.g. 1-apertura or 1-clausura

data/config/leagues_europe.csv

@@ -92,3 +92,13 @@ ru.1,    Russian Premier League,   1-premierliga,,,
 ru.2,    Russian 1. Division,      2-division1,,,
 
 
+
+##  use uefa.1 - why? why not?
+##      uefa.2,
+##      uefa.3
+uefa.cl,      UEFA Champions League,    cl,,,     ### use champs or such?
+uefa.el,      UEFA Europa League,       el,,,     ### use europa
+uefa.conf,    UEFA Conference League,   conf,,,   ###  use con (conf - confusion with config files?)
+
+uefa.nl,      UEFA Nations League,      nl,,,
+euro,         Euro,   euro,,,

data/config/leagues_world.csv

@@ -2,3 +2,7 @@ key,     name,                      basename,       start_season, end_season, co
 
 cn.1,    Chinese Super League,      1-superleague,,,
 jp.1,    Japan J1 League,           1-j1league,,,
+
+
+
+world,   World Cup,                 cup,,,

data/config/openfootball.csv

@@ -42,11 +42,26 @@ ua,  europe/ukraine
 ru,  europe/russia
 
 
+uefa.cl,    europe-champions-league
+uefa.el,    europe-champions-league
+uefa.conf,  europe-champions-league
+
+euro,       euro
+
+
+
 mx, mexico
 
+
 ar, south-america/argentina
 br, south-america/brazil
 
+copa.l,  south-america/copa-libertadores
+copa.s,  south-america/copa-libertadores
+
+
 cn,  world/asia/china
 jp,  world/asia/japan
 
+
+world,   worldcup

data/lib/sportdb/fbgen/main.rb

@@ -4,8 +4,7 @@ def self.main( args=ARGV )
 
 opts = {
   source_path: [],
-  push:     false,
-  dry:      false,  ## dry run (no write)
+  dry:      false,
   debug:    true,
   file:     nil,
 }
@@ -13,21 +12,22 @@ opts = {
 parser = OptionParser.new do |parser|
   parser.banner = "Usage: #{$PROGRAM_NAME} [options] [args]"
 
-    parser.on( "-p", "--push",
-               "fast forward sync and commit & push changes to git repo - default is (#{opts[:push]})" ) do |push|
-      opts[:push] = push
-    end
     parser.on( "--dry",
                 "dry run; do NOT write - default is (#{opts[:dry]})" ) do |dry|
-      opts[:dry] = dry
+      opts[:dry] = true
     end
     parser.on( "-q", "--quiet",
                "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
-      opts[:debug] = !debug
+      opts[:debug] = false
+    end
+
+    parser.on( "-I DIR", "--include DIR",
+                "add directory to (source) search path - default is (#{opts[:source_path].join(',')})") do |dir|
+      opts[:source_path] += path
     end
 
     parser.on( "-f FILE", "--file FILE",
-                "read leagues via .csv file") do |file|
+                "read leagues (and seasons) via .csv file") do |file|
       opts[:file] = file
     end
 end
@@ -38,71 +38,54 @@ parser.parse!( args )
 if opts[:source_path].empty? &&
   File.exist?( '/sports/cache.api.fbdat')  &&
   File.exist?( '/sports/cache.wfb' )
- opts[:source_path] << '/sports/cache.api.fbdat'
- opts[:source_path] << '/sports/cache.wfb'
+    opts[:source_path] << '/sports/cache.api.fbdat'
+    opts[:source_path] << '/sports/cache.wfb'
+end
+
+
+if opts[:source_path].empty?
+  opts[:source_path] = ['.']    ## use ./ as default
 end
 
+source_path = opts[:source_path]
+
 
 puts "OPTS:"
 p opts
 puts "ARGV:"
 p args
 
+
 datasets =   if opts[:file]
                   read_datasets( opts[:file] )
              else
-                  parse_datasets( args )
+                  parse_datasets_args( args )
              end
 
 puts "datasets:"
 pp datasets
 
 
-source_path = opts[:source_path]
-source_path = ['.']    if source_path.empty?  ## use ./ as default
-
-root_dir =  if opts[:push]
-               GitHubSync.root   # e.g. "/sports"
-            else
-               './o'
-            end
 
+root_dir =  './o'
 puts "  (output) root_dir: >#{root_dir}<"
 
-sync  = if opts[:push]
-           repos = GitHubSync.find_repos( datasets )
-           puts "  #{repos.size} repo(s):"
-           pp repos
-           GitHubSync.new( repos )
-        else
-           nil
-        end
-puts "  sync:"
-pp sync
-
-sync.git_fast_forward_if_clean      if sync
-
 
+### step 0 - validate and fill-in seasons etc.
+validate_datasets!( datasets, source_path: source_path )
 
+## step 1 - generate
 datasets.each do |league_key, seasons|
-    seasons = [ Season('2024/25') ]   if seasons.empty?
-
     puts "==> gen #{league_key} - #{seasons.size} seasons(s)..."
 
     league_info = Writer::LEAGUES[ league_key ]
     pp league_info
 
     seasons.each do |season|
-      ### get matches
-
       filename = "#{season.to_path}/#{league_key}.csv"
       path = find_file( filename, path: source_path )
 
-      if path.nil?
-        puts "!! no source found for #{filename}; sorry"
-        exit 1
-      end
-
+      ## get matches
       puts "  ---> reading matches in #{path} ..."
       matches = SportDb::CsvMatchParser.read( path )
       puts "     #{matches.size} matches"
@@ -112,20 +95,14 @@ datasets.each do |league_key, seasons|
       puts txt   if opts[:debug]
 
       league_name  = league_info[ :name ]      # e.g. Brasileiro Série A
-      basename     = league_info[ :basename]   #.e.g  1-seriea
-
       league_name =  league_name.call( season )   if league_name.is_a?( Proc )  ## is proc/func - name depends on season
-      basename    =  basename.call( season )      if basename.is_a?( Proc )  ## is proc/func - name depends on season
 
       buf = String.new
       buf << "= #{league_name} #{season}\n\n"
       buf << txt
 
-      repo  = GitHubSync::REPOS[ league_key ]
-      repo_path = "#{repo['owner']}/#{repo['name']}"
-      repo_path << "/#{repo['path']}"    if repo['path']  ## note: do NOT forget to add optional extra path!!!
+      outpath = "#{root_dir}/foot/#{season.to_path}/#{league_key}.txt"
 
-      outpath = "#{root_dir}/#{repo_path}/#{season.to_path}/#{basename}.txt"
       if opts[:dry]
         puts "   (dry) writing to >#{outpath}<..."
       else
@@ -133,79 +110,63 @@ datasets.each do |league_key, seasons|
       end
     end
 end
-
-sync.git_push_if_changes   if sync
-
 end  # method self.main
 
 
 
-def self.parse_datasets( args )
-### split args in datasets with leagues and seasons
-datasets = []
-args.each do |arg|
-   if arg =~ %r{^[0-9/-]+$}   ##  season
-       if datasets.empty?
-         puts "!! ERROR - league required before season arg; sorry"
-         exit 1
-       end
-
-       season = Season.parse( arg )  ## check season
-       datasets[-1][1] << season
-   else ## assume league key
-       key = arg.downcase
-       league_info = Writer::LEAGUES[ key ]
-
-       if league_info.nil?
-         puts "!! ERROR - no league found for >#{key}<; sorry"
-         exit 1
-       end
+def self.find_file( filename, path: )
+    path.each do |src_dir|
+       path = "#{src_dir}/#{filename}"
+       return path   if File.exist?( path )
+    end
 
-       datasets << [key, []]
-   end
-end
-datasets
+    ##  fix - raise file not found error!!!
+    nil  ## not found - raise filenot found error - why? why not?
 end
 
 
-def self.read_datasets( path )
-### split args in datasets with leagues and seasons
-datasets = []
-recs = read_csv( path )
-recs.each do |rec|
-    league_code  = rec['league']
-    key = league_code.downcase
-    league_info = Writer::LEAGUES[ key ]
+### use a function for (re)use
+###   note - may add seasons in place!! (if seasons is empty)
+def self.validate_datasets!( datasets, source_path: )
+  datasets.each do |dataset|
+    league_key, seasons = dataset
 
+    league_info = Writer::LEAGUES[ league_key ]
     if league_info.nil?
-      puts "!! ERROR - no league found for >#{key}<; sorry"
+      puts "!! ERROR - no league (config) found for >#{league_key}<; sorry"
       exit 1
     end
 
-    datasets << [key, []]
 
-    seasons_str = rec['seasons']
-    seasons = seasons_str.split( /[ ]+/ )
+    if seasons.empty?
+      ## simple heuristic to find current season
+      [ Season( '2024/25'), Season( '2024') ].each do |season|
+         filename = "#{season.to_path}/#{league_key}.csv"
+         path = find_file( filename, path: source_path )
+         if path
+            seasons = [season]
+            dataset[1] = seasons
+            break
+         end
+      end
 
-    seasons.each do |season_str|
-        season = Season.parse( season_str )  ## check season
-        datasets[-1][1] << season
+      if seasons.empty?
+        puts "!! ERROR - no latest auto-season via source found for #{league_key}; sorry"
+        exit 1
+      end
     end
-end
-datasets
-end
 
+    ## check source path too upfronat - why? why not?
+    seasons.each do |season|
+         filename = "#{season.to_path}/#{league_key}.csv"
+         path = find_file( filename, path: source_path )
 
-def self.find_file( filename, path: )
-    path.each do |src_dir|
-       path = "#{src_dir}/#{filename}"
-       return path   if File.exist?( path )
+         if path.nil?
+           puts "!! ERROR - no source found for #{filename}; sorry"
+           exit 1
+         end
     end
-
-    ##  fix - raise file not found error!!!
-    nil  ## not found - raise filenot found error - why? why not?
+  end
+  datasets
 end
-
-
-
 end  # module Fbgen

data/lib/sportdb/{fbgen → fbup}/github.rb

@@ -1,5 +1,5 @@
 
-module Fbgen
+module Fbup
 
 ###
 ## todo/fix:
@@ -80,4 +80,4 @@ def _git_fast_forward_if_clean( pathspec )
     end
 end
 end  # class GitHub
-end  # module Fbgen
+end  # module Fbup

data/lib/sportdb/{fbgen → fbup}/github_config.rb

@@ -1,5 +1,5 @@
 
-module Fbgen
+module Fbup
 class GitHubConfig
 
   ## map leagues to repo+path
@@ -91,7 +91,7 @@ def find_repo( key )
 end
 
 end # class GitHubConfig
-end # module Fbgen
+end # module Fbup
 
 
 

data/lib/sportdb/fbup/main.rb

@@ -0,0 +1,162 @@
+
+module Fbup
+def self.main( args=ARGV )
+
+opts = {
+  source_path: [],
+  push:     false,
+  ffwd:     false,
+  dry:      false,  ## dry run (no write)
+  test:     true,   ## sets push & ffwd to false
+  debug:    true,
+  file:     nil,
+  test_dir:  './o',
+}
+
+
+parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] [args]"
+
+    parser.on( "-p", "--[no-]push",
+               "fast forward sync and commit & push changes to git repo - default is (#{opts[:push]})" ) do |push|
+      opts[:push] = push
+      if opts[:push]   ## note: autoset ffwd too if push == true
+        opts[:ffwd] = true
+        opts[:test] = false
+      end
+    end
+    ## todo/check - add a --ffwd flag too - why? why not?
+
+    parser.on( "-t", "--test",
+                "test run; writing output to #{opts[:test_dir]} - default is #{opts[:test]}" ) do |test|
+      opts[:test] = true
+      opts[:push] = false
+      opts[:ffwd] = false
+    end
+    parser.on( "--dry",
+                "dry run; do NOT write - default is (#{opts[:dry]})" ) do |dry|
+      opts[:dry] = dry
+      opts[:push] = false    ### autoset push & ffwd - why? why not?
+      opts[:ffwd] = false
+    end
+
+    parser.on( "-q", "--quiet",
+               "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
+      opts[:debug] = false
+    end
+
+    parser.on( "-I DIR", "--include DIR",
+                "add directory to (source) search path - default is (#{opts[:source_path].join(',')})") do |dir|
+      opts[:source_path] += path
+    end
+
+    parser.on( "-f FILE", "--file FILE",
+                "read leagues (and seasons) via .csv file") do |file|
+      opts[:file] = file
+    end
+end
+parser.parse!( args )
+
+
+if opts[:source_path].empty? &&
+   File.exist?( '/sports/cache.api.fbdat')  &&
+   File.exist?( '/sports/cache.wfb' )
+     opts[:source_path] << '/sports/cache.api.fbdat'
+     opts[:source_path] << '/sports/cache.wfb'
+end
+
+if opts[:source_path].empty?
+  opts[:source_path]  = ['.']   ## use ./ as default
+end
+
+
+
+puts "OPTS:"
+p opts
+puts "ARGV:"
+p args
+
+
+datasets =   if opts[:file]
+                  read_datasets( opts[:file] )
+             else
+                  parse_datasets_args( args )
+             end
+
+puts "datasets:"
+pp datasets
+
+
+source_path = opts[:source_path]
+
+root_dir =  if opts[:test]
+               opts[:test_dir]
+            else
+               GitHubSync.root   # e.g. "/sports"
+            end
+
+puts "  (output) root_dir: >#{root_dir}<"
+
+repos = GitHubSync.find_repos( datasets )
+puts "  #{repos.size} repo(s):"
+pp repos
+sync  =  GitHubSync.new( repos )
+
+puts "  sync:"
+pp sync
+
+
+sync.git_fast_forward_if_clean    if opts[:ffwd]
+
+### step 0 - validate and fill-in seasons etc.
+##   reuse from Fbgen tool
+Fbgen.validate_datasets!( datasets, source_path: source_path )
+
+
+datasets.each do |league_key, seasons|
+    puts "==> gen #{league_key} - #{seasons.size} seasons(s)..."
+
+    league_info = Writer::LEAGUES[ league_key ]
+    pp league_info
+
+    seasons.each do |season|
+      filename = "#{season.to_path}/#{league_key}.csv"
+      path = Fbgen.find_file( filename, path: source_path )
+
+      ### get matches
+      puts "  ---> reading matches in #{path} ..."
+      matches = SportDb::CsvMatchParser.read( path )
+      puts "     #{matches.size} matches"
+
+      ## build
+      txt = SportDb::TxtMatchWriter.build( matches )
+      puts txt   if opts[:debug]
+
+      league_name  = league_info[ :name ]      # e.g. Brasileiro Série A
+      basename     = league_info[ :basename]   #.e.g  1-seriea
+
+      league_name =  league_name.call( season )   if league_name.is_a?( Proc )  ## is proc/func - name depends on season
+      basename    =  basename.call( season )      if basename.is_a?( Proc )  ## is proc/func - name depends on season
+
+      buf = String.new
+      buf << "= #{league_name} #{season}\n\n"
+      buf << txt
+
+      repo  = GitHubSync::REPOS[ league_key ]
+      repo_path = "#{repo['owner']}/#{repo['name']}"
+      repo_path << "/#{repo['path']}"    if repo['path']  ## note: do NOT forget to add optional extra path!!!
+
+      outpath = "#{root_dir}/#{repo_path}/#{season.to_path}/#{basename}.txt"
+
+      if opts[:dry]
+        puts "   (dry) writing to >#{outpath}<..."
+      else
+        write_text( outpath, buf )
+      end
+    end
+end
+
+sync.git_push_if_changes   if opts[:push]
+
+end  # method self.main
+end  # module Fbgen

data/lib/sportdb/writers/version.rb

@@ -4,7 +4,7 @@ module Module
   module Writers
     MAJOR = 0    ## todo: namespace inside version or something - why? why not??
     MINOR = 2
-    PATCH = 0
+    PATCH = 3
     VERSION = [MAJOR,MINOR,PATCH].join('.')
 
     def self.version

data/lib/sportdb/writers.rb

@@ -26,11 +26,6 @@ end   # module Writer
 ###
 # our own code
 require_relative 'writers/version'
-require_relative 'writers/txt_writer'
-
-require_relative 'writers/goals'
-require_relative 'writers/write'
-
 
 ## setup  leagues (info) table
 require_relative 'writers/league_config'
@@ -48,9 +43,16 @@ module Writer
 end  # module Writer
 
 
+require_relative 'writers/goals'
+require_relative 'writers/txt_writer'
+
+
 ###
 #  fbtxt tool
+require 'football/timezones'    ## pulls in read_datasets, etc.
+
 require_relative 'fbtxt/main'
+require_relative 'fbgen/main'
 
 
 
@@ -58,11 +60,11 @@ require_relative 'fbtxt/main'
 #  push & pull github scripts
 require 'gitti'    ## note - requires git machinery
 
-require_relative 'fbgen/github_config'
-require_relative 'fbgen/github'   ## github helpers/update machinery
+require_relative 'fbup/github_config'
+require_relative 'fbup/github'   ## github helpers/update machinery
 
 
-module Fbgen
+module Fbup
 class  GitHubSync
   REPOS = GitHubConfig.new
   recs = read_csv( "#{SportDb::Module::Writers.root}/config/openfootball.csv" )
@@ -96,10 +98,10 @@ def self.find_repos( datasets )
   repos.uniq   ## note: remove duplicates (e.g. europe or world or such)
 end
 end  #  class  GitHubSync
-end  # module Fbgen
+end  # module Fbup
 
 
-require_relative 'fbgen/main'
+require_relative 'fbup/main'
 
 
 

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: sportdb-writers
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.3
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-13 00:00:00.000000000 Z
+date: 2024-09-16 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: football-timezones
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: sportdb-quick
   requirement: !ruby/object:Gem::Requirement
@@ -78,6 +92,7 @@ email: gerald.bauer@gmail.com
 executables:
 - fbgen
 - fbtxt
+- fbup
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
@@ -90,20 +105,21 @@ files:
 - Rakefile
 - bin/fbgen
 - bin/fbtxt
+- bin/fbup
 - config/leagues_america.csv
 - config/leagues_europe.csv
 - config/leagues_world.csv
 - config/openfootball.csv
-- lib/sportdb/fbgen/github.rb
-- lib/sportdb/fbgen/github_config.rb
 - lib/sportdb/fbgen/main.rb
 - lib/sportdb/fbtxt/main.rb
+- lib/sportdb/fbup/github.rb
+- lib/sportdb/fbup/github_config.rb
+- lib/sportdb/fbup/main.rb
 - lib/sportdb/writers.rb
 - lib/sportdb/writers/goals.rb
 - lib/sportdb/writers/league_config.rb
 - lib/sportdb/writers/txt_writer.rb
 - lib/sportdb/writers/version.rb
-- lib/sportdb/writers/write.rb
 homepage: https://github.com/sportdb/sport.db
 licenses:
 - Public Domain

data/lib/sportdb/writers/write.rb

@@ -1,272 +0,0 @@
-
-module Writer
-
-
-class Job     ## todo/check: use a module (and NOT a class) - why? why not?
-def self.write( datasets, source:,
-                          normalize: false )
-  datasets.each_with_index do |dataset,i|
-    league  = dataset[0]
-    seasons = dataset[1]
-
-    puts "writing [#{i+1}/#{datasets.size}] #{league}..."
-    seasons.each_with_index do |season,j|
-      puts "  season [#{j+1}/#{season.size}] #{league} #{season}..."
-      Writer.write( league: league,
-                    season: season,
-                    source: source,
-                    normalize: normalize )
-    end
-  end
-end
-end # class Job
-
-
-
-
-def self.split_matches( matches, season: )
-  matches_i  = []
-  matches_ii = []
-  matches.each do |match|
-    date = Date.strptime( match.date, '%Y-%m-%d' )
-    if date.year == season.start_year
-      matches_i << match
-    elsif date.year == season.end_year
-      matches_ii << match
-    else
-      puts "!! ERROR: match date-out-of-range for season:"
-      pp season
-      pp date
-      pp match
-      exit 1
-    end
-  end
-  [matches_i, matches_ii]
-end
-
-
-
-##
-##  note: default - do NOT normalize any more
-
-def self.write( league:, season:,
-                source:,
-                extra: nil,
-                split: false,
-                normalize: false,
-                rounds: true )
-  season = Season( season )  ## normalize season
-
-  league_info = LEAGUES[ league ]
-  if league_info.nil?
-    puts "!! ERROR - no league found for >#{league}<; sorry"
-    exit 1
-  end
-
-  ## check - if source is directory (assume if starting ./ or ../ or /)
-  ## check if directory exists
-  ##   todo/fix - use Dir.exist? why? why not?
-  unless File.exist?( source )
-       puts "!! ERROR: source dir >#{source}< does not exist"
-       exit 1
-  end
-  source_info = { path: source }   ## wrap in "plain" source dir in source info
-
-  source_path = source_info[:path]
-
-  ## format lets you specify directory layout
-  ##   default   = 1888-89
-  ##   century   = 1800s/1888-89
-  ##   ...
-  season_path = season.to_path( (source_info[:format] || 'default').to_sym )
-  in_path = "#{source_path}/#{season_path}/#{league}.csv"   # e.g. ../stage/one/2020/br.1.csv
-
-
-  matches = SportDb::CsvMatchParser.read( in_path )
-  puts "matches- #{matches.size} records"
-
-
-  ## check for goals
-  in_path_goals = "#{source_path}/#{season_path}/#{league}~goals.csv"   # e.g. ../stage/one/2020/br.1~goals.csv
-  if File.exist?( in_path_goals )
-    goals = SportDb::CsvGoalParser.read( in_path_goals )
-    puts "goals - #{goals.size} records"
-    pp goals[0]
-
-    puts
-    puts "merge goals:"
-    merge_goals( matches, goals )
-  end
-
-
-  pp matches[0]
-
-
-  if normalize
-     if normalize.is_a?(Proc)
-        matches = normalize.call( matches, league: league,
-                                           season: season )
-     else
-       puts "!! ERROR - normalize; expected proc got #{normalize.inspect}"
-       exit 1
-     end
-  end
-
-
-
-  league_name  = league_info[ :name ]      # e.g. Brasileiro Série A
-  basename     = league_info[ :basename]   #.e.g  1-seriea
-
-  league_name =  league_name.call( season )   if league_name.is_a?( Proc )  ## is proc/func - name depends on season
-  basename    =  basename.call( season )      if basename.is_a?( Proc )  ## is proc/func - name depends on season
-
-  ## note - repo_path moved!!!
-  ## repo_path    = league_info[ :path ]      # e.g. brazil or world/europe/portugal etc.
-  repo  = SportDb::GitHubSync::REPOS[ league ]
-  repo_path = "#{repo['owner']}/#{repo['name']}"
-  repo_path << "/#{repo['path']}"    if repo['path']  ## note: do NOT forget to add optional extra path!!!
-
-
-
-  season_path = String.new     ## note: allow extra path for output!!!! e.g. archive/2000s etc.
-  season_path << "#{extra}/"   if extra
-  season_path << season.path
-
-
-  ## check for stages
-  stages = league_info[ :stages ]
-  stages = stages.call( season )    if stages.is_a?( Proc )  ## is proc/func - stages depends on season
-
-
-  if stages
-
-  ## split into four stages / two files
-  ## - Grunddurchgang
-  ## - Finaldurchgang - Meister
-  ## - Finaldurchgang - Qualifikation
-  ## - Europa League Play-off
-
-  matches_by_stage = matches.group_by { |match| match.stage }
-  pp matches_by_stage.keys
-
-
-  ## stages = prepare_stages( stages )
-  pp stages
-
-
-  romans = %w[I II III IIII V VI VII VIII VIIII X XI]  ## note: use "simple" romans without -1 rule e.g. iv or ix
-
-  stages.each_with_index do |stage, i|
-
-    ## assume "extended" style / syntax
-    if stage.is_a?( Hash ) && stage.has_key?( :names )
-      stage_names    = stage[ :names ]
-      stage_basename = stage[ :basename ]
-      ## add search/replace {basename} - why? why not?
-      stage_basename = stage_basename.sub( '{basename}', basename )
-    else  ## assume simple style (array of strings OR hash mapping of string => string)
-      stage_names    = stage
-      stage_basename =  if stages.size == 1
-                            "#{basename}"  ## use basename as is 1:1
-                         else
-                            "#{basename}-#{romans[i].downcase}"  ## append i,ii,etc.
-                         end
-    end
-
-    buf = build_stage( matches_by_stage, stages: stage_names,
-                                         name: "#{league_name} #{season.key}"
-                      )
-
-    ## note: might be empty!!! if no matches skip (do NOT write)
-    write_text( "#{config.out_dir}/#{repo_path}/#{season_path}/#{stage_basename}.txt",
-                  buf )   unless buf.empty?
-  end
-  else  ## no stages - assume "regular" plain vanilla season
-
-## always (auto-) sort for now - why? why not?
-matches = matches.sort do |l,r|
-  ## first by date (older first)
-  ## next by matchday (lower first)
-  res =   l.date <=> r.date
-  res =   l.time <=> r.time     if res == 0 && l.time && r.time
-  res =   l.round <=> r.round   if res == 0 && rounds
-  res
-end
-
-  if split
-    matches_i, matches_ii = split_matches( matches, season: season )
-
-    out_path = "#{config.out_dir}/#{repo_path}/#{season_path}/#{basename}-i.txt"
-
-    SportDb::TxtMatchWriter.write( out_path, matches_i,
-                                   name: "#{league_name} #{season.key}",
-                                   rounds: rounds )
-
-    out_path = "#{config.out_dir}/#{repo_path}/#{season_path}/#{basename}-ii.txt"
-
-    SportDb::TxtMatchWriter.write( out_path, matches_ii,
-                                   name: "#{league_name} #{season.key}",
-                                   rounds: rounds )
-  else
-    out_path = "#{config.out_dir}/#{repo_path}/#{season_path}/#{basename}.txt"
-
-    SportDb::TxtMatchWriter.write( out_path, matches,
-                                   name: "#{league_name} #{season.key}",
-                                   rounds: rounds )
-  end
-  end
-end
-
-
-=begin
-def prepare_stages( stages )
-  if stages.is_a?( Array )
-     if stages[0].is_a?( Array )  ## is array of array
-       ## convert inner array shortcuts to hash - stage input is same as stage output
-       stages.map {|ary| ary.reduce({}) {|h,stage| h[stage]=stage; h }}
-     elsif stages[0].is_a?( Hash )  ## assume array of hashes
-       stages  ## pass through as is ("canonical") format!!!
-     else ## assume array of strings
-      ## assume single array shortcut; convert to hash - stage input is same as stage output name
-      stages = stages.reduce({}) {|h,stage| h[stage]=stage; h }
-      [stages]  ## return hash wrapped in array
-     end
-  else  ## assume (single) hash
-    [stages] ## always return array of hashes
-  end
-end
-=end
-
-
-
-def self.build_stage( matches_by_stage, stages:, name: )
-  buf = String.new
-
-  ## note: allow convenience shortcut - assume stage_in is stage_out - auto-convert
-  stages = stages.reduce({}) {|h,stage| h[stage]=stage; h }   if stages.is_a?( Array )
-
-  stages.each_with_index do |(stage_in, stage_out),i|
-    matches = matches_by_stage[ stage_in ]   ## todo/fix: report error if no matches found!!!
-
-    next if matches.nil? || matches.empty?
-
-    ## (auto-)sort matches by
-    ##  1) date
-    matches = matches.sort do |l,r|
-      result = l.date  <=> r.date
-      result
-    end
-
-    buf << "\n\n"   if i > 0 && buf.size > 0
-
-    buf << "= #{name}, #{stage_out}\n"
-    buf << SportDb::TxtMatchWriter.build( matches )
-
-    puts buf
-  end
-
-  buf
-end
-
-
-end   # module Writer