football-sources 0.0.1 → 0.1.1

data/lib/football-sources/worldfootball/leagues/europe--central.rb

@@ -1,127 +0,0 @@
-
-module Worldfootball
-
-
-LEAGUES_EUROPE.merge!({
-
-#  /2-bundesliga-{season}/
-#  /2-bundesliga-2013-2014/
-#  /dfb-pokal-2019-2020/
-
-  'de.1'   => { pages: 'bundesliga' },
-  'de.2'   => { pages: '2-bundesliga' },
-  'de.3'   => { pages: '3-liga' },
-  'de.cup' => { pages: 'dfb-pokal' },
-
-
-
-## note: use aut-2-liga !!! starting 2019-2018 !!!
-##       use aut-erste-liga !!! before e.g. 2010-2011 etc.
-#
-#  /aut-erste-liga-{season}/
-#  /aut-bundesliga-2010-2011/
-#  /aut-erste-liga-2010-2011/
-#  /aut-oefb-cup-2019-2020/
-
-=begin
-  2019/2020 Qualifikationsgruppe -- >/alle_spiele/aut-bundesliga-2019-2020-qualifikationsgruppe/<
-  2019/2020 Playoff              -- >/alle_spiele/aut-bundesliga-2019-2020-playoff/<
-  2019/2020 Meistergruppe        -- >/alle_spiele/aut-bundesliga-2019-2020-meistergruppe/<
-  2019/2020                      -- >/alle_spiele/aut-bundesliga-2019-2020/<
-  2018/2019 Qualifikationsgruppe -- >/alle_spiele/aut-bundesliga-2018-2019-qualifikationsgruppe/<
-  2018/2019 Playoff              -- >/alle_spiele/aut-bundesliga-2018-2019-playoff/<
-  2018/2019 Meistergruppe        -- >/alle_spiele/aut-bundesliga-2018-2019-meistergruppe/<
-=end
-
-  'at.1' => {
-    pages: {
-      'aut-bundesliga-{season}'                      => 'Grunddurchgang',                  # 1
-      'aut-bundesliga-{season}-meistergruppe'        => 'Finaldurchgang - Meister',        # 2
-      'aut-bundesliga-{season}-qualifikationsgruppe' => 'Finaldurchgang - Qualifikation',  # 3
-      'aut-bundesliga-{season}-playoff'              => 'Europa League Play-off',          # 4
-    },
-    season: ->( season ) {
-                  case season
-                  when Season('2020/21') then [1]
-                  when Season('2018/19')..Season('2019/20') then [1,2,3,4]
-                  else  1   ## use simple format for the rest; note: index NOT wrapped in array
-                  end
-    },
-   },
-  'at.2'   => {
-    pages: ['aut-2-liga',
-            'aut-erste-liga'],
-    season: ->(season) { season.start_year >= 2019 ? 1 : 2 }
-  },
-  # /aut-regionalliga-ost-2020-2021/
-  'at.3.o' => { pages: 'aut-regionalliga-ost' },
-  'at.cup' => { pages: 'aut-oefb-cup' },
-
-
-  # /sui-super-league-2019-2020/
-  # /sui-challenge-league-2019-2020/
-
-  'ch.1'   => { pages: 'sui-super-league' },
-  'ch.2'   => { pages: 'sui-challenge-league' },
-
-  # /hun-nb-i-2020-2021/
-  'hu.1'   => { pages: 'hun-nb-i' },
-
-  # /cze-1-fotbalova-liga-2020-2021/
-  'cz.1' => {
-     pages: {
-      'cze-1-fotbalova-liga-{season}'          => 'Regular Season',           # 1
-     },
-     season: ->( season ) {
-      case season
-      when Season('2020/21') then [1]     # just getting started
-      end
-     }
-    },
-
-
-  # /pol-ekstraklasa-2020-2021/
-  # /pol-ekstraklasa-2019-2020-playoffs/
-  # /pol-ekstraklasa-2019-2020-abstieg/
-  #
-  # championship round (top eight teams) and
-  # relegation round (bottom eight teams)
-  'pl.1' => {
-     pages: {
-      'pol-ekstraklasa-{season}'          => 'Regular Season',           # 1
-      'pol-ekstraklasa-{season}-playoffs' => 'Playoffs - Championship',  # 2
-      'pol-ekstraklasa-{season}-abstieg'  => 'Playoffs - Relegation',    # 3
-     },
-     season: ->( season ) {
-      case season
-      when Season('2020/21') then [1]     # just getting started
-      when Season('2019/20') then [1,2,3]
-      when Season('2018/19') then [1,2,3]
-      end
-     }
-    },
-
-  # /svk-super-liga-2020-2021/
-  # /svk-super-liga-2019-2020-meisterschaft/
-  # /svk-super-liga-2019-2020-abstieg/
-  # /svk-super-liga-2019-2020-europa-league/
-  'sk.1' => {
-    pages: {
-      'svk-super-liga-{season}'               => 'Regular Season',           # 1
-      'svk-super-liga-{season}-meisterschaft' => 'Playoffs - Championship',  # 2
-      'svk-super-liga-{season}-abstieg'       => 'Playoffs - Relegation',    # 3
-      'svk-super-liga-{season}-europa-league' => 'Europa League Finals',     # 4
-   },
-   season: ->( season ) {
-    case season
-    when Season('2020/21') then [1]  # getting started
-    when Season('2019/20') then [1,2,3,4]
-    when Season('2018/19') then [1,2,3]    # note: no europa league finals / playoffs
-    end
-   }
-  },
-
-
-})
-
-end

data/lib/football-sources/worldfootball/leagues/europe--eastern.rb

@@ -1,82 +0,0 @@
-
-module Worldfootball
-
-LEAGUES_EUROPE.merge!({
-
-  # /rou-liga-1-2019-2020
-  # /rou-liga-1-2019-2020-championship
-  # /rou-liga-1-2019-2020-relegation
-  # ..
-  # /rom-liga-1-2015-2016
-  # /rom-liga-1-2015-2016-championship
-  # /rou-liga-1-2015-2016-relegation
-
-
-  'ro.1' => {
-    pages: {
-     'rou-liga-1-{season}'               => 'Regular Season',
-     'rou-liga-1-{season}-championship'  => 'Playoffs - Championship',
-     'rou-liga-1-{season}-relegation'    => 'Playoffs - Relegation',
-     ## note: change of country code from rou to rom in slug in 2015/16!!!
-     'rom-liga-1-{season}'               => 'Regular Season',
-     'rom-liga-1-{season}-championship'  => 'Playoffs - Championship',
-     'rom-liga-1-{season}-relegation'    => 'Playoffs - Relegation',
-    },
-    season: ->( season ) {
-     case season
-     when Season('2020/21') then [1]  # just getting started
-     when Season('2016/17')..Season('2019/20') then [1,2,3]
-     when Season('2015/16') then [4,5,3]  # handle special case with weird mixed slugs
-     when Season('2010/11')..Season('2014/15') then 4   ## use simple format for the rest; note: index NOT wrapped in array
-     end
-    }
-  },
-
-  #   rus-premier-liga-2020-2021
-  #   ..
-  #   rus-premier-liga-2012-2013
-  #
-  #   rus-premier-liga-2011-2012
-  #   rus-premier-liga-2011-2012-meisterschaft
-  #   rus-premier-liga-2011-2012-relegation
-  #
-  #   rus-premier-liga-2010
-  'ru.1'  => {
-    pages: {
-     'rus-premier-liga-{season}'                => 'Regular Season',
-     'rus-premier-liga-{season}-meisterschaft'  => 'Playoffs - Championship',
-     'rus-premier-liga-{season}-relegation'     => 'Playoffs - Relegation',
-    },
-    season: ->( season ) {
-     case season
-     when Season('2012/13')..Season('2020/21') then 1   ## use simple format for the rest; note: index NOT wrapped in array
-     when Season('2011/12') then [1,2,3]
-     when Season('2004')..Season('2010') then 1         ## use simple format for the rest; note: index NOT wrapped in array
-     end
-    }
-  },
-  'ru.2'  => { pages: 'rus-1-division' },
-
-  # /ukr-premyer-liga-2019-2020/
-  # /ukr-premyer-liga-2019-2020-meisterschaft/
-  # /ukr-premyer-liga-2019-2020-abstieg/
-  # /ukr-premyer-liga-2019-2020-playoffs-el/
-  'ua.1'  => {
-    pages: {
-     'ukr-premyer-liga-{season}'               => 'Regular Season',
-     'ukr-premyer-liga-{season}-meisterschaft' => 'Playoffs - Championship',
-     'ukr-premyer-liga-{season}-abstieg'       => 'Playoffs - Relegation',
-     'ukr-premyer-liga-{season}-playoffs-el'   => 'Europa League Finals',
-   },
-   season: ->( season ) {
-    case season
-    when Season('2019/20') then [1,2,3,4]
-    when Season('2018/19') then [1,2,3]    # note: no europa league finals / playoffs
-    end
-   }
-  },
-
-})
-
-end
-

data/lib/football-sources/worldfootball/leagues/europe--northern.rb

@@ -1,57 +0,0 @@
-
-module Worldfootball
-
-LEAGUES_EUROPE.merge!({
-  # e.g. /isl-urvalsdeild-2020/
-  'is.1'  => { pages: 'isl-urvalsdeild' },
-
-  # e.g. /swe-allsvenskan-2020/
-  #      /swe-superettan-2020/
-  'se.1'  => { pages: 'swe-allsvenskan' },
-  'se.2'  => { pages: 'swe-superettan' },
-
-  # e.g. /nor-eliteserien-2020/
-  'no.1'  => { pages: 'nor-eliteserien' },
-
-  # e.g. /fin-veikkausliiga-2019/
-  #      /fin-veikkausliiga-2019-meisterschaft/
-  #      /fin-veikkausliiga-2019-abstieg/
-  #      /fin-veikkausliiga-2019-playoff-el/
-  'fi.1' => {
-    pages: {
-      'fin-veikkausliiga-{season}'               => 'Regular Season',
-      'fin-veikkausliiga-{season}-meisterschaft' => 'Playoffs - Championship',
-      'fin-veikkausliiga-{season}-abstieg'       => 'Playoffs - Challenger',
-      'fin-veikkausliiga-{season}-playoff-el'    => 'Europa League Finals',
-    },
-    season: ->( season ) {
-     case season
-     when Season('2020') then [1]    # just getting started
-     when Season('2019') then [1,2,3,4]
-     end
-    }
-  },
-
-  # /den-superliga-2020-2021/
-  # /den-superliga-2019-2020-meisterschaft/
-  # /den-superliga-2019-2020-abstieg/
-  # /den-superliga-2019-2020-europa-league/
-  'dk.1'  => {
-    pages: {
-      'den-superliga-{season}'               => 'Regular Season',
-      'den-superliga-{season}-meisterschaft' => 'Playoffs - Championship',
-      'den-superliga-{season}-abstieg'       => 'Playoffs - Relegation',
-      'den-superliga-{season}-europa-league' => 'Europa League Finals',
-   },
-   season: ->( season ) {
-     case season
-     when Season('2020/21') then [1]     # just getting started
-     when Season('2019/20') then [1,2,3,4]
-     when Season('2018/19') then [1,2,3,4]
-     end
-   }
-  },
-
-})
-
-end

data/lib/football-sources/worldfootball/leagues/europe--southern.rb

@@ -1,86 +0,0 @@
-
-module Worldfootball
-
-LEAGUES_EUROPE.merge!({
-
-  # /ita-serie-a-2019-2020/
-  # /ita-serie-b-2020-2021/
-  'it.1' =>  { pages: 'ita-serie-a' },
-  'it.2' =>  { pages: 'ita-serie-b' },
-
-  # /por-primeira-liga-2019-2020/
-  # por-primeira-liga-2020-2021
-  # por-primeira-liga-2019-2020
-  # por-primeira-liga-2018-2019
-  # por-primeira-liga-2017-2018
-  # por-primeira-liga-2016-2017
-  # por-primeira-liga-2015-2016
-  # por-primeira-liga-2014-2015
-  # por-primeira-liga-2013-2014
-  # por-liga-zon-sagres-2012-2013
-  # por-liga-zon-sagres-2011-2012
-  # por-liga-sagres-2010-2011
-  # ...
-  # /por-segunda-liga-2019-2020/
-  # note: Sponsorship names for seasons
-  #  2002–2005: SuperLiga GalpEnergia
-  #  2005–2006: Liga betandwin.com
-  #  2006–2008: BWINLIGA
-  #  2008–2010: Liga Sagres
-  #  2010–2014: Liga ZON Sagres
-  #  2014–2020: Liga NOS
-  'pt.1' =>  {
-    pages: ['por-primeira-liga',
-            'por-liga-zon-sagres',
-            'por-liga-sagres'
-           ],
-    season: ->( season ) {
-            case season
-            when Season('2013/14')..Season('2020/21') then 1
-            when Season('2011/12')..Season('2012/13') then 2
-            when Season('2010/11')                    then 3
-            end
-    },
-   },
-  'pt.2' =>  { pages: 'por-segunda-liga' },
-
-  # /esp-primera-division-2019-2020/
-  'es.1'  => { pages: 'esp-primera-division' },
-  'es.2'  => { pages: 'esp-segunda-division' },
-
-  # /tur-sueperlig-2020-2021/
-  'tr.1'  => { pages: 'tur-sueperlig' },
-  'tr.2'  => { pages: 'tur-1-lig' },
-
-
-  # /gre-super-league-2020-2021/
-  'gr.1'  => {
-    pages: {
-      ## note: change from superleague to super-league !!!
-      'gre-super-league'                             => 'Regular Season',
-      'gre-super-league-{season}-meisterschaft'      => 'Playoffs - Championship',
-      'gre-super-league-{season}-abstieg'            => 'Playoffs - Relegation',
-      'gre-superleague'                              => 'Regular Season',
-      'gre-superleague-{end_year}-playoffs'          => 'Playoffs',
-      'gre-superleague-{end_year}-spiel-um-platz-6'  => 'Match 6th Place',
-    },
-    season: ->( season ) {
-            case season
-            when Season('2020/21') then [1]    ## just getting started
-            when Season('2019/20') then [4,2,3]
-            when Season('2017/18')..Season('2018/19') then 4
-            when Season('2013/14')..Season('2016/17') then [4,5]
-            when Season('2012/13')                    then [4,5,6]
-            when Season('2010/11')..Season('2011/12') then [4,5]
-            end
-    },
-  },
-
-
-  ## todo/check: add europe southeastern or balkans - why? why not?
-  # e.g. /cro-1-hnl-2020-2021/
-  'hr.1' => { pages: 'cro-1-hnl' },
-
-})
-
-end

data/lib/football-sources/worldfootball/leagues/europe--western.rb

@@ -1,38 +0,0 @@
-
-module Worldfootball
-
-LEAGUES_EUROPE.merge!({
-  'fr.1'  => { pages: 'fra-ligue-1' },
-  'fr.2'  => { pages: 'fra-ligue-2' },
-
-  # e.g. /lux-nationaldivision-2020-2021/
-  'lu.1' => { pages: 'lux-nationaldivision' },
-
-  # e.g. /ned-eredivisie-2020-2021/
-  'nl.1' => { pages: 'ned-eredivisie' },
-  # Championship play-offs
-  # Europa League play-offs (Group A + Group B / Finals )
-
-  # e.g. /bel-eerste-klasse-a-2020-2021/
-  #      /bel-europa-league-playoffs-2018-2019-playoff/
-  #       - Halbfinale
-  #       - Finale
-  'be.1' => {
-    pages: {
-      'bel-eerste-klasse-a-{season}'                => 'Regular Season',
-      'bel-eerste-klasse-a-{season}-playoff-i'      => 'Playoffs - Championship',
-      'bel-europa-league-playoffs-{season}'         => 'Playoffs - Europa League',           ## note: missing groups (A & B)
-      'bel-europa-league-playoffs-{season}-playoff' => 'Playoffs - Europa League - Finals',
-    },
-    season: ->( season ) {
-      case season
-      when Season('2020/21') then [1]     # just getting started
-      when Season('2019/20') then [1]     # covid-19 - no championship & europa
-      when Season('2018/19') then [1,2,3,4]
-      end
-    }
-  },
-
-})
-
-end

data/lib/football-sources/worldfootball/leagues/europe.rb

@@ -1,13 +0,0 @@
-
-module Worldfootball
-  LEAGUES_EUROPE = {}
-end
-
-
-require_relative 'europe--western'
-require_relative 'europe--british_isles'
-require_relative 'europe--northern'
-require_relative 'europe--central'
-require_relative 'europe--eastern'
-require_relative 'europe--southern'
-

data/lib/football-sources/worldfootball/leagues/north_america.rb

@@ -1,44 +0,0 @@
-module Worldfootball
-
-LEAGUES_NORTH_AMERICA = {
-
-# todo/fix: adjust date/time by -6 or 7 hours!!!
-#   /can-canadian-championship-2020/
-#     - Qual. 1. Runde
-#     - Qual. 2. Runde
-#     - Qual. 3. Runde
-#   todo/fix: check for leagues - premier league? championship? soccer league?
-#  'ca.1' => { slug: 'can-canadian-championship' },
-
-
-
-# todo/fix: adjust date/time by -7 hours!!!
-##  e.g. 25.07.2020	02:30  => 24.07.2020 19.30
-#        11.01.2020	04:00  => 10.01.2020 21.00
-#
-# e.g. /mex-primera-division-2020-2021-apertura/
-#      /mex-primera-division-2019-2020-clausura/
-#      /mex-primera-division-2019-2020-apertura-playoffs/
-#        - Viertelfinale
-#        - Halbfinale
-#        - Finale
-#      /mex-primera-division-2018-2019-clausura-playoffs/
-'mx.1' => {
-  pages: {
-    'mex-primera-division-{season}-apertura'          => 'Apertura',            # 1
-    'mex-primera-division-{season}-apertura-playoffs' => 'Apertura - Liguilla', # 2
-    'mex-primera-division-{season}-clausura'          => 'Clausura',            # 3
-    'mex-primera-division-{season}-clausura-playoffs' => 'Clausura - Liguilla', # 4
- },
- season: ->( season ) {
-  case season
-  when Season('2020/21') then [1]        # just getting started
-  when Season('2019/20') then [1,2,3]    # covid-19 - no liguilla
-  when Season('2010/11')..Season('2018/19') then [1,2,3,4]
-  end
- }
-},
-}
-
-end # module Worldfootball
-

data/lib/football-sources/worldfootball/leagues/pacific.rb

@@ -1,21 +0,0 @@
-module Worldfootball
-
-LEAGUES_PACIFIC = {
-
-  # /nzl-nz-football-championship-2019-2020/
-  # /nzl-nz-football-championship-2018-2019-playoffs/
-  'nz.1' => {
-    pages: {
-      'nzl-nz-football-championship-{season}'          => 'Regular Season', # 1
-      'nzl-nz-football-championship-{season}-playoffs' => 'Playoff Finals', # 2
-     },
-     season: ->( season ) {
-      case season
-      when Season('2019/20') then [1]    ## covid-19 - no playoffs/finals
-      when Season('2018/19') then [1,2]
-      end
-     }
-  },
-}
-
-end # module Worldfootball

data/lib/football-sources/worldfootball/leagues/south_america.rb

@@ -1,11 +0,0 @@
-module Worldfootball
-
-  LEAGUES_SOUTH_AMERICA = {
-
-    # todo/fix: adjust date/time by -6 or 7 hours!!!
-    # /bra-serie-a-2020/
-    'br.1' => { pages: 'bra-serie-a' },
-  }
-
-end # module Worldfootball
-

data/lib/football-sources/worldfootball/leagues.rb

@@ -1,200 +0,0 @@
-
-
-require_relative 'leagues/europe'
-require_relative 'leagues/north_america'
-require_relative 'leagues/south_america'
-require_relative 'leagues/pacific'
-require_relative 'leagues/asia'
-
-
-module Worldfootball
-
-LEAGUES = [LEAGUES_EUROPE,
-           LEAGUES_NORTH_AMERICA,
-           LEAGUES_SOUTH_AMERICA,
-           LEAGUES_PACIFIC,
-           LEAGUES_ASIA].reduce({}) { |mem,h| mem.merge!( h ); mem }
-
-
-class League
-    def initialize( key, data )
-      @key  = key
-      ## @data = data
-
-      @pages       = data[:pages]
-      @season_proc = data[:season] || ->(season) { nil }
-    end
-
-    def key()   @key; end
-
-    def pages( season: )
-      ## note: return for no stages / simple case - just a string
-      ##   and for the stages case ALWAYS an array (even if it has only one page (with stage))
-
-      if @pages.is_a?( String )
-        # assume always "simple/regular" format w/o stages
-        slug = @pages
-        { slug: fill_slug( slug, season: season ) }
-      else
-         ## check for league format / stages
-         ##   return array (of strings) or nil (for no stages - "simple" format)
-         indices = @season_proc.call( season )
-         if indices.nil?
-           puts "!! ERROR - no configuration found for season >#{season}< for league >#{@key}< found; sorry"
-           exit 1
-         elsif indices.is_a?( Integer )  ## single number - single/regular format w/o stage
-          # note: starting with 0 (always use idx-1) !!!
-           slug = if @pages.is_a?( Array )
-                    @pages[indices-1]
-                  else ## assume hash (and key is page slug)
-                    @pages.keys[indices-1]
-                  end
-           { slug: fill_slug( slug, season: season ) }
-         else  ## assume regular case - array of integers
-           recs = []
-           indices.each do |idx|
-              slug = key = @pages.keys[idx-1]
-              recs << { slug:  fill_slug( slug, season: season ),
-                        stage: @pages[key] }  ## note: include mapping for page to stage name!!
-           end
-           recs
-        end
-      end
-    end # pages
-
-
-    ######
-    # helper method
-    def fill_slug( slug, season: )
-      ## note: fill-in/check for place holders too
-      slug = if slug.index( '{season}' )
-               slug.sub( '{season}', season.to_path( :long ) )  ## e.g. 2010-2011
-             elsif slug.index( '{end_year}' )
-               slug.sub( '{end_year}', season.end_year.to_s )   ## e.g. 2011
-             else
-               ## assume convenience fallback - append regular season
-               "#{slug}-#{season.to_path( :long )}"
-            end
-
-      puts "  slug=>#{slug}<"
-
-      slug
-    end
-  end # class League
-
-
-
-  def self.find_league( key )  ## league info lookup
-    data = LEAGUES[ key ]
-    if data.nil?
-      puts "!! ERROR - no league found for >#{key}<; add to leagues tables"
-      exit 1
-    end
-    League.new( key, data )   ## use a convenience wrapper for now
-  end
-
-
-
-### "reverse" lookup by page - returns league AND season
-##  note: "blind" season template para - might be season or start_year etc.
-##   e.g.  {season} or {start_year} becomes {}
-
-PAGE_VAR_RE = /{
-                [^}]+
-               }/x
-
-
-def self.norm_slug( slug )
-    ## assume convenience fallback - append regular season
-    slug.index( '{' ) ? slug : "#{slug}-{season}"
-end
-
-PAGES ||=
- LEAGUES.reduce( {} ) do |pages, (key, data)|
-                                     if data[:pages].is_a?( String )
-                                       slug = data[:pages]
-                                       slug = Worldfootball.norm_slug( slug )
-                                       pages[ slug.sub( PAGE_VAR_RE, '{}') ] = { league: key, slug: slug }
-                                     elsif data[:pages].is_a?( Array )
-                                       data[:pages].each do |slug|
-                                        slug = Worldfootball.norm_slug( slug )
-                                         pages[ slug.sub( PAGE_VAR_RE, '{}') ] = { league: key, slug: slug }
-                                       end
-                                        ## elsif data[:pages].nil?
-                                        ## todo/fix: missing pages!!!
-                                     else ## assume hash
-                                      ## add stage to pages too - why? why not?
-                                       data[:pages].each do |slug, stage|
-                                         slug = Worldfootball.norm_slug( slug )
-                                         pages[ slug.sub( PAGE_VAR_RE, '{}') ] = { league: key, slug: slug, stage: stage }
-                                       end
-                                     end
-                                     pages
-                                    end
-
-# e.g. 2000 or 2000-2001
-SEASON_RE = /[0-9]{4}
-              (?:
-                -[0-9]{4}
-              )?
-            /x
-
-
-  def self.find_page!( slug )
-    page = find_page( slug )
-    if page.nil?
-      puts "!! ERROR: no mapping for page >#{slug}< found; sorry"
-
-      season_str = nil
-      norm = slug.sub( SEASON_RE ) do |match|  ## replace season with var placeholder {}
-                season_str = match   ## keep reference to season str
-                '{}'  ## replace with {}
-              end
-
-      puts "   season:      >#{season_str}<"
-      puts "   slug (norm): >#{norm}<"
-      puts
-      ## pp PAGES
-      exit 1
-    end
-    page
-  end
-
-
-
-  def self.find_page( slug )
-    ## return league key and season
-    season_str = nil
-    norm = slug.sub( SEASON_RE ) do |match|  ## replace season with var placeholder {}
-              season_str = match   ## keep reference to season str
-              '{}'  ## replace with {}
-            end
-
-    if season_str.nil?
-      puts "!! ERROR: no season found in page slug >#{slug}<; sorry"
-      exit 1
-    end
-
-    rec = PAGES[ norm ]
-    return nil  if rec.nil?
-
-
-    league_key = rec[:league]
-    slug_tmpl  = rec[:slug]
-    season = if slug_tmpl.index( '{start_year}' )
-               ## todo/check - season_str must be year (e.g. 2020 or such and NOT 2020-2021)
-               Season( "#{season_str.to_i}-#{season_str.to_i+1}" )
-             elsif slug_tmpl.index( '{end_year}' )
-               ## todo/check - season_str must be year (e.g. 2020 or such and NOT 2020-2021)
-               Season( "#{season_str.to_i-1}-#{season_str.to_i}" )
-             else  ## assume "regular" seasson - pass through as is
-               Season( season_str )
-             end
-
-    ## return hash table / record
-    { league: league_key,
-      season: season.key }
-  end
-
-
-end # module Worldfootball