RubyGems - fbup - Versions diffs - 0.2.1 → 0.2.2 - Mend

fbup 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0cc7c6bdb92fe41bd89ddf67258bf59ce8feb70ad16c9b1908fdda37f165c03
-  data.tar.gz: 3d7cc168bd623108f549e4c531738350065a1c7743ffd42ab0a7d7e66d89c8d1
+  metadata.gz: 3702c807ac8aeba8d67f0dfa4376432a9e20c940cddfcc09e01e94130ec886f0
+  data.tar.gz: 050c128c6dd7d70c8f6a7a0c2e0bb753c7bb8b485de2200dd9861dee39352889
 SHA512:
-  metadata.gz: 4851fcc456089aa461f5fa01f2866c414acfa5ed75e921e58e28224fa2a23e8190e581627d36637732d4065a7a01d06f1d7c0843b26f9e7d5e3154dc1041f1c4
-  data.tar.gz: 5c38c8ea0aa370ad42e1f9a7be5b2df211bd0989af16d14efe7a634ec5ffe07c10884a4ff672035ae396a8ce8dd0ded746ee136c8bacf63806ccda4dc27ca856
+  metadata.gz: f6767ba7dac8c0964111b8478a35a43cf01d0f430040efb3f0f21e07fa744344ade9a422caea1b8a4a3e7e18b83f4828d8952cbb603aa44d328b2e5794f19025
+  data.tar.gz: fcb90df77da3dc26e260ba607354477fd9cfa8c21de3c24f4c253531b090e1070fa1c448de2c534658f5b3be3499d650f906aa0bf579901fc2be02475cfa0f8a

data/CHANGELOG.md CHANGED Viewed

@@ -1,4 +1,4 @@
-### 0.2.1
+### 0.2.2
 ### 0.0.1 / 2024-12-29
 * Everything is new. First release.

data/Manifest.txt CHANGED Viewed

@@ -3,11 +3,6 @@ Manifest.txt
 README.md
 Rakefile
 bin/fbup
-config/leagues.csv
-config/openfootball.csv
 lib/fbup.rb
-lib/fbup/github.rb
-lib/fbup/github_config.rb
-lib/fbup/league_config.rb
 lib/fbup/main.rb
 lib/fbup/version.rb

data/Rakefile CHANGED Viewed

@@ -20,9 +20,9 @@ Hoe.spec 'fbup' do
   self.licenses = ['Public Domain']
   self.extra_deps = [
-       ['gitti',              '>= 0.6.1'],
        ['sportdb-writers',    '>= 0.4.3'],
        ['leagues',            '>= 0.2.1'],
+       ['openfootball'],
   ]
   self.spec_extras = {

data/bin/fbup CHANGED Viewed

@@ -9,6 +9,8 @@
 ## note - quick hack - auto-add local football timezones
 $LOAD_PATH.unshift( '/sports/sportdb/sport.db/leagues/lib' )
 $LOAD_PATH.unshift( '/sports/sportdb/sport.db/fifa/lib' )
+## note - use latest (local) if available
+$LOAD_PATH.unshift( '/sports/yorobot/fbup/fbup/lib' )
 require 'fbup'

data/lib/fbup/main.rb CHANGED Viewed

@@ -3,19 +3,20 @@ module Fbup
 LEAGUE_NAMES_V2 = {
   'jp.1' => 'Japan | J1 League',
-  'cn.1' => 'China | Super League',
-  'kz.1' => 'Kazakhstan | Premier League',
+  'cn.1' => 'China | Super League',
+  'kz.1' => 'Kazakhstan | Premier League',
   'eg.1' => 'Egypt | Premiership',
   'ma.1' => 'Morocco | Botola Pro 1',
-  'dz.1' => 'Algeria | Ligue 1',
+  'dz.1' => 'Algeria | Ligue 1',
   'il.1' => 'Israel | Premier League',
-  'au.1' => 'Australia | A-League',
-############
-## international
+  'au.1' => 'Australia | A-League',
+  ############
+## international
 ##    note - will fetch team pages one-by-one too to get country (codes)
   'afl'    =>  'African Football League',
-  'caf.cl' =>  'CAF Champions League',
-}
+  'caf.cl' =>  'CAF Champions League',
+}
 def self.main( args=ARGV )
@@ -122,9 +123,9 @@ source_path = opts[:source_path]
 ##     todo use new LeaguesetAutofiller class - why? why not?
 ##    or move code of autofiller here - why? why not?
 ##
-autofiller = ->(league_query) {
+autofiller = ->(league_query) {
   Leagueset.autofiller( league_query, source_path: source_path )
-}
+}
 datasets =   if opts[:file]
                   read_leagueset( opts[:file], autofill: autofiller )
@@ -174,7 +175,7 @@ datasets.each do |league_query, seasons|
     seasons.each do |season|
-      ## note - league info requires season
+      ## note - league info requires season
       ##          PLUS use (canoncial) league code from info!!!
       league_info = LeagueCodes.find_by( code: league_query, season: season )
       pp league_info
@@ -182,11 +183,10 @@ datasets.each do |league_query, seasons|
       league_code  = league_info[ 'code' ]
       league_name  = league_info[ 'name' ]       # e.g. Brasileiro Série A
-      ### todo/fix - move basename out of league_info
-      ###               make it github/openfootball "legacy" code
-      ## basename     = league_info[ 'basename' ]   #.e.g  1-seriea
+      league_name = LEAGUE_NAMES_V2[league_code] || league_name
       filename = "#{season.to_path}/#{league_code}.csv"
       path = find_file( filename, path: source_path )
@@ -196,61 +196,30 @@ datasets.each do |league_query, seasons|
       puts "     #{matches.size} matches"
-      ## get repo config for flags and more
-      repo  = GitHubSync::REPOS[ league_code ]
-      flags = repo['flags'] || {}
-      classic_flag = flags['classic'] || false
       ## build
       txt =  if opts[:v1]
                ## todo - change upstream build to build_v1
                SportDb::TxtMatchWriter.build( matches )
-             else
+             else
                SportDb::TxtMatchWriter.build_v2( matches )
              end
       puts txt   if opts[:debug]
-      basename = nil
-      if classic_flag || opts[:classic]
-         league_config = LeagueConfig.find_by( code: league_query, season: season )
-         if league_config.nil?
-            puts "!! ERROR - basename league config required for classic format; no config found for #{league_query} #{season}; sorry"
-            exit 1
-         end
-         basename  = league_config['basename']
-      else
-         ## change base name to league key
-         ##   todo - fix - make gsub smarter
-         ##    change at.cup to at_cup - why? why not?
-         basename = league_code.gsub( '.', '' )
-         ## bonus - add quick fix for new league name overwrites
-         league_name = LEAGUE_NAMES_V2[league_code] || league_name
-      end
       buf = String.new
       buf << "= #{league_name} #{season}\n\n"
       buf << txt
-      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}"
-      outpath +=  if classic_flag || opts[:classic]
-                     "/#{season.to_path}/#{basename}.txt"
-                  else
-                     ## note - add season "inline" (to basename) or use dir
-                     "/#{season.to_path}_#{basename}.txt"
-                  end
+      ## get repo config for flags and more
+      repo  = GitHubSync::REPOS[ league_code ]
+      repo_path  = repo.mkpath( code: league_code, season: season,
+                                classic: opts[:classic] )
+      outpath = "#{root_dir}/#{repo_path}"
       if opts[:dry]
         puts "   (dry) writing to >#{outpath}<..."

data/lib/fbup/version.rb CHANGED Viewed

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

data/lib/fbup.rb CHANGED Viewed

@@ -1,25 +1,17 @@
-require 'sportdb/writers'
-require 'leagues'   ## pulls-in find_league_info, etc.
+## use latest if available
+$LOAD_PATH.unshift( '/sports/yorobot/fbup/openfootball/lib' )
+require 'openfootball'
-require 'optparse'    ## command-line processing; check if included updstream?
-########################
-#  push & pull github scripts
-require 'gitti'    ## note - requires git machinery
+require 'sportdb/writers'
+require 'leagues'   ## pulls-in find_league_info, etc.
 ###
 # our own code
 require_relative 'fbup/version'
-require_relative 'fbup/github_config'
-require_relative 'fbup/github'   ## github helpers/update machinery
-require_relative 'fbup/league_config'   ## for "classic" custom basenames e.g. eng.1 => 1-premierleague etc.
 require_relative 'fbup/main'

metadata CHANGED Viewed

@@ -1,57 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: fbup
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-02 00:00:00.000000000 Z
+date: 2026-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: gitti
+  name: sportdb-writers
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.1
+        version: 0.4.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.1
+        version: 0.4.3
 - !ruby/object:Gem::Dependency
-  name: sportdb-writers
+  name: leagues
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.4.3
+        version: 0.2.1
 - !ruby/object:Gem::Dependency
-  name: leagues
+  name: openfootball
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -103,12 +103,7 @@ files:
 - README.md
 - Rakefile
 - bin/fbup
-- config/leagues.csv
-- config/openfootball.csv
 - lib/fbup.rb
-- lib/fbup/github.rb
-- lib/fbup/github_config.rb
-- lib/fbup/league_config.rb
 - lib/fbup/main.rb
 - lib/fbup/version.rb
 homepage: https://github.com/sportdb/sport.db

data/config/leagues.csv DELETED Viewed

@@ -1,111 +0,0 @@
-code,basename,start_season,end_season
-########
-### use a "custom" basename for "classic" leagues
-####
-##  /austria
-at.1,1-bundesliga,,
-## -- add new name - Erste Liga  => 2. Liga
-at.2,2-liga2,2018/19,
-at.2,2-liga1,,2017/18
-at.3.o,3-regionalliga-ost,,
-at.3.m,3-regionalliga-mitte,,
-at.3.w,3-regionalliga-west,,
-at.3.sbg,3-regionalliga-salzburg,,
-at.3.t,3-regionalliga-tirol,,
-at.3.v,3-regionalliga-vorarlberg,,
-at.cup,cup,,
-####
-##  /deutschland
-de.1,1-bundesliga,,
-de.2,2-bundesliga2,,
-de.3,3-liga3,,
-de.cup,cup,,
-de.super,super,,
-de.4.nord,4-regionalliga-nord,,
-de.4.nordost,4-regionalliga-nordost,,
-de.4.west,4-regionalliga-west,,
-de.4.suedwest,4-regionalliga-suedwest,,
-de.4.bayern,4-regionalliga-bayern,,
-# -- add alternate keys for de.4
-#   todo/fix - find a way to add alternate keys (WITHOUT repeating basename) !!!
-de.4.n,4-regionalliga-nord,,
-de.4.no,4-regionalliga-nordost,,
-de.4.w,4-regionalliga-west,,
-de.4.sw,4-regionalliga-suedwest,,
-################
-##  /england
-eng.2,2-championship,2004/05,
-eng.3,3-league1,2004/05,
-eng.4,4-league2,2004/05,
-eng.1,1-premierleague,1992/93,
-eng.2,2-division1,1992/93,2003/04
-eng.3,3-division2,1992/93,2003/04
-eng.4,4-division3,1992/93,2003/04
-eng.5,5-nationalleague,1992/93,
-eng.1,1-division1,1892/93,1991/92
-eng.2,2-division2,1892/93,1991/92
-eng.3,3-division3,,1991/92
-eng.3.a,3-division3-north,,
-eng.3.b,3-division3-south,,
-eng.1,1-footballleague,1888/89,1891/92
-###
-##  fix - always use fa.cup and efl.cup - why? why not?
-eng.cup,facup,,     ## FA CuP
-eng.super,super,,    ## FA Community Shield
-eng.cup.l,eflcup,,   ## EFL Cup
-eng.cup.t,efltrophy,,  ## EFL Trophy
-eng.cup.t.ii,fatrophy,,  ## FA Trophy
-## -- add alternate codes / keys
-eng.fa.cup,facup,,    ## FA Cup
-eng.efl.cup,eflcup,,  ## EFL Cup
-#######
-## /espana
-es.1,1-liga,,
-es.2,2-liga2,,
-es.3,3-liga2b,,    ## Segunda División B
-es.cup,cup,,
-es.super,supercopa,,        ## check - use only super - why? why not?
-#####
-## /italy
-it.1,1-seriea,,
-it.2,2-serieb,,
-it.3.a,3-seriec_a,,  ## North & Central West
-it.3.b,3-seriec_b,,  ## North & Central East
-it.3.c,3-seriec_c,,  ## South
-it.cup,cup,,
-it.super,super,,
-## it.cup.c    -- Italian Coppa Italia Serie C
-#####
-##  /champions-league    - uefa incl. europa & conference
-uefa.cl,      cl,,
-uefa.champs,  cl,,
-uefa.el,      el,,
-uefa.europa,  el,,
-uefa.conf,    conf,,
-uefa.con,     conf,,
-#####
-##  /club-worldcup
-world.clubs,  clubworldcup,,
-world.club,   clubworldcup,,
-##  - use world.clubs or club ??

data/config/openfootball.csv DELETED Viewed

@@ -1,159 +0,0 @@
-key,  path,  flags
-## note - flags - defaults for now are   v2 | flat
-##
-##  v2       - v2 format (football.txt)
-##  flat     -   add season to basename (no season directory)
-##                       e.g.  2023-24_at1.txt
-##  classic  -   use season directory AND league slug for basename
-##                       e.g. 2023-24/1-bundesliga.txt
-##
-##
-##  add archive flag  for using archive style names before 2000 or such - why? why not?
-at,   austria,           classic
-de,     deutschland,     classic
-eng,  england,           classic
-es,   espana,            classic
-it,   italy,             classic
-## todo/fix - add aliases WITHOUT repeating conifg - why? why not?
-uefa.cl,      champions-league,    classic
-uefa.champs,  champions-league,    classic
-uefa.el,      champions-league,    classic
-uefa.europa,  champions-league,    classic
-uefa.conf,    champions-league,    classic
-uefa.con,     champions-league,    classic
-fr,   europe/france,
-hu, europe/hungary,
-gr, europe/greece,
-pt, europe/portugal,
-ch, europe/switzerland,
-tr, europe/turkey,
-is,   europe/iceland,
-sco,  europe/scotland,
-ie,  europe/ireland,
-fi,  europe/finland,
-se,  europe/sweden,
-no,  europe/norway,
-dk,  europe/denmark,
-lu,  europe/luxembourg,
-be,  europe/belgium,
-nl,  europe/netherlands,
-cz,  europe/czech-republic,
-sk,   europe/slovakia,
-hr,  europe/croatia,
-pl,   europe/poland,
-ro,  europe/romania,
-ua,  europe/ukraine,
-ru,  europe/russia,
-al,  europe/albania,
-ad,  europe/andorra,
-by,  europe/belarus,
-ba,  europe/bosnia-herzegovina,      ## use bosnia-n-herzegovina ??
-bg,  europe/bulgaria,
-cy,  europe/cyprus,
-ee,  europe/estonia,
-lv,  europe/latvia,
-li,  europe/liechtenstein,
-lt,  europe/lithuania,
-mk,  europe/north-macedonia,
-mt,  europe/malta,
-md,  europe/moldova,
-me,  europe/montenegro,
-sm,  europe/san-marino,
-rs,  europe/serbia,
-si,  europe/slovenia,
-xk,  europe/kosovo,
-kos, europe/kosovo,
-am,  europe/armenia,
-az,  europe/azerbaijan,
-ge,  europe/georgia,
-fo,  europe/faroe-islands,
-gi,  europe/gibraltar,
-wal, europe/wales,
-nir, europe/northern-ireland,
-euro,       euro,   ## add custom flag - why? why not?
-ar, south-america/argentina,
-br, south-america/brazil,
-co, south-america/colombia,
-copa.l,  south-america/copa-libertadores,
-copa.s,  south-america/copa-libertadores,
-###
-# /world repo
-eg,         world/africa/egypt,
-ma,         world/africa/morocco,
-dz,         world/africa/algeria,
-afl,        world/africa/african-football-league,
-caf.cl,     world/africa/champions-league,
-caf.champs, world/africa/champions-league,
-cn,  world/asia/china,
-jp,  world/asia/japan,
-kz,  world/asia/kazakhstan,
-il,  world/middle-east/israel,
-sa,  world/middle-east/saudi-arabia,
-mls,  world/north-america/major-league-soccer,
-mx,   world/north-america/mexico,
-## fix/change concacaf.cl to concacaf.champs !!!
-concacaf.cl,     world/north-america/champions-league,
-concacaf.champs, world/north-america/champions-league,
-au,   world/pacific/australia,
-## use world.clubs or club ??
-world.clubs,  club-worldcup,   classic     ## use classic setup for now - why? why not?
-world.club,   club-worldcup,   classic
-world,   worldcup,      ## add custom  flag - why? why not?

data/lib/fbup/github.rb DELETED Viewed

@@ -1,115 +0,0 @@
-module Fbup   ### rename module to Up - why? why not?
-###
-## todo/fix:
-##   add -i/--interactive flag
-##     will prompt yes/no  before git operations (with consequences)!!!
-class GitHubSync
-########
-##  (auto)default to Writer.config.out_dir - why? why not?
-##
-##    note - is monotree (that is, requires openfootball/england etc.
-##                  for repo pathspecs)
-def self.root()  @root || "/sports"; end
-def self.root=( dir ) @root = dir; end
-## use root_dir (or add alias) - why? why not?
-REPOS = GitHubConfig.new
-recs = read_csv( "#{SportDb::Module::Fbup.root}/config/openfootball.csv" )
-REPOS.add( recs )
-## note: datasets of format
-##
-## DATASETS = [
-##   ['it.1',    %w[2020/21 2019/20]],
-##  ['it.2',    %w[2019/20]],
-##  ['es.1',    %w[2019/20]],
-##  ['es.2',    %w[2019/20]],
-## ]
-def self.find_repos( datasets )
-repos = []
-datasets.each do |league_key, seasons|
-  repo  = REPOS[ league_key ]
-  ## pp repo
-  if repo.nil?
-     puts "!! ERROR - no repo config/path found for league >#{league_key}<; sorry"
-     exit 1
-  end
-  repos <<  "#{repo['owner']}/#{repo['name']}"
-end
-pp repos
-repos.uniq   ## note: remove duplicates (e.g. europe or world or such)
-end
-def initialize( repos )
-    @repos = repos
-end
-def git_push_if_changes
-   message = "auto-update week #{Date.today.cweek}"  ## add /#{Date.today.cday - why? why not?
-   puts message
-   @repos.each do |pathspec|
-       _git_push_if_changes( pathspec, message: message )
-   end
-end
-def git_fast_forward_if_clean
-    @repos.each do |pathspec|
-      _git_fast_forward_if_clean( pathspec )
-    end
-end
-## todo/fix: rename to something like
-##    git_(auto_)commit_and_push_if_changes/if_dirty()
-def _git_push_if_changes( pathspec, message: )
-    path = "#{self.class.root}/#{pathspec}"
-    Gitti::GitProject.open( path ) do |proj|
-      puts ''
-      puts "###########################################"
-      puts "## trying to commit & push repo in path >#{path}<"
-      puts "Dir.getwd: #{Dir.getwd}"
-      output = proj.changes
-      if output.empty?
-        puts "no changes found; skipping commit & push"
-      else
-        proj.add( '.' )
-        proj.commit( message )
-        proj.push
-      end
-    end
-end
-def _git_fast_forward_if_clean( pathspec )
-    path = "#{self.class.root}/#{pathspec}"
-    Gitti::GitProject.open( path ) do |proj|
-      output = proj.changes
-      unless  output.empty?
-        puts "FAIL - cannot git pull (fast-forward) - working tree has changes:"
-        puts output
-        exit 1
-      end
-      proj.fast_forward
-    end
-end
-end  # class GitHub
-end  # module Fbup

data/lib/fbup/github_config.rb DELETED Viewed

@@ -1,106 +0,0 @@
-module Fbup
-class GitHubConfig
-  ## map leagues to repo+path
-  ##  e.g.   fr.1   => europe/france
-  ##         eng..1 => england
-  ##
-  ##  for other than openfootball (default)
-  ## use @
-  ##   e.g.    myorg@austria
-  ##           austria@myorg ??
-  ##
-  ##           myorg@europe/france
-  ##            europe/france@myorg
-def self.read( path )
-    recs = read_csv( path )
-    new( recs )
-end
-def initialize( recs=nil )
-    @table = {}
-    add( recs )  if recs
-end
-def add( recs )
-  recs.each do |rec|
-    path = rec['path']  ## use pathspec - why? why not?
-                        ##  or repospec or such
-    ## auto-expand to openfootball as default org if no @ specified
-    owner, path = if path.index( '@')
-                      path.split( '@', 2 )
-                  else
-                      ['openfootball', path ]
-                  end
-    name, path = path.split( '/', 2 )
-    ## openfootball@europe/france
-    ##    =>
-    ##    owner: openfootball
-    ##    name:  europe
-    ##    path:  france
-    ##
-    ## openfootball@austria
-    ##    =>
-    ##    owner: openfootball
-    ##    name:  austria
-    ##    path:  nil
-    @table[ rec['key'] ] = {  'owner' => owner, ## (required)
-                              'name'  => name,  ## (required)
-                              'path'  => path   ## extra/inner/inside/local path (optional)
-                            }
-    ## check for/add flags
-      flags = rec['flags'].split( /[ ]*[|][ ]*/ )
-      ## generte hash
-      ##    e.g.   v2 | flat   => { 'v2' => true, 'flat' => true } etc.
-      flags = flags.map { |flag| [flag, true] }.to_h
-      @table[ rec['key'] ]['flags'] = flags      if flags.size > 0
-  end
-end
-##
-## todo/fix:
-##   make key lookup more flexible
-##    auto-add more variants!!!
-##       e.g. at.1  AT1, AT or such
-##
-## find (full) record by key
-def find( key )
-  key = key.to_s.downcase
-  ## first check for 1:1 match
-  rec = @table[key]
-  if rec.nil?
-     ## try match by (country / first) code
-     ##   split by .
-     key, _ = key.split( '.' )
-     rec = @table[key]
-  end
-  rec
-end
-alias_method :[], :find  ## keep alias - why? why not?
-def find_repo( key )
-   rec = _find( key )
-   rec ? "#{rec['owner']}/#{rec['name']}" : nil
-end
-end # class GitHubConfig
-end # module Fbup

data/lib/fbup/league_config.rb DELETED Viewed

@@ -1,99 +0,0 @@
-module Fbup
-####
-### check - rename to ExtraLeagueConfig or such - why? why not?
-class LeagueConfig
-def self.find_by( code:, season: )
-    ## return league code record/item or nil
-    builtin.find_by( code: code, season: season )
-end
-#####
-## (static) helpers
-def self.builtin
-   ## get builtin league code index (build on demand)
-   @leagues ||= begin
-        leagues = LeagueConfig.new
-        ['leagues',
-        ].each do |name|
-           recs = read_csv( "#{SportDb::Module::Fbup.root}/config/#{name}.csv" )
-           leagues.add( recs )
-        end
-        leagues
-   end
-   @leagues
-end
-def self.norm( code )      ## use norm_(league)code - why? why not?
-  ## norm league code
-  ##   downcase
-  ##   and remove all non-letters/digits e.g. at.1 => at1, at 1 => at1 etc.
-  ##                                            ö.1 => ö1
-  ##   note - allow unicode letters!!!
-  ##    note - assume downcase works for unicode too e.g. Ö=>ö
-  ##           for now no need to use our own downcase - why? why not?
-  code.downcase.gsub( /[^\p{Ll}0-9]/, '' )
-end
-def initialize
-    @leagues = {}
-end
-def add( recs )
-  recs.each do |rec|
-    key = LeagueConfig.norm( rec['code'] )
-    @leagues[ key ] ||= []
-    ## note: auto-change seasons to season object or nil
-    @leagues[ key ] << {  'code'         => rec['code'],
-                          'basename'     => rec['basename'],
-                          'start_season' => rec['start_season'].empty? ? nil : Season.parse( rec['start_season'] ),
-                          'end_season'   => rec['end_season'].empty?   ? nil : Season.parse( rec['end_season'] ),
-                       }
-  end
-end
-def find_by( code:, season: )
-  raise ArgumentError, "league code as string|symbol expected"  unless code.is_a?(String) || code.is_a?(Symbol)
-  ## return league code record/item or nil
-  ## check for alt code first
-  season = Season( season )
-  key    = LeagueCodes.norm( code )
-  rec    = nil
-  recs = @leagues[ key ]
-  if recs
-    rec =  _find_by_season( recs, season )
-  end
-  rec   ## return nil if no code record/item found
-end
-def _find_by_season( recs, season )
-  recs.each do |rec|
-      start_season = rec['start_season']
-      end_season   = rec['end_season']
-      return rec  if (start_season.nil? || start_season <= season) &&
-                     (end_season.nil? || end_season >= season)
-  end
-  nil
-end
-end # class LeagueConfig
-end # module Fbup