footballdata-12xpert 0.0.1

data/lib/footballdata-12xpert/config.rb

@@ -0,0 +1,420 @@
+
+module Footballdata12xpert
+
+SOURCES_I =
+{
+  eng: [[ '2020/21', %w(E0 E1 E2 E3 EC) ],
+        [ '2019/20', %w(E0 E1 E2 E3 EC) ],
+        [ '2018/19', %w(E0 E1 E2 E3 EC) ],
+        [ '2017/18', %w(E0 E1 E2 E3 EC) ],
+        [ '2016/17', %w(E0 E1 E2 E3 EC) ],
+        [ '2015/16', %w(E0 E1 E2 E3 EC) ],
+        [ '2014/15', %w(E0 E1 E2 E3 EC) ],
+        [ '2013/14', %w(E0 E1 E2 E3 EC) ],
+        [ '2012/13', %w(E0 E1 E2 E3 EC) ],
+        [ '2011/12', %w(E0 E1 E2 E3 EC) ],
+        [ '2010/11', %w(E0 E1 E2 E3 EC) ],
+        [ '2009/10', %w(E0 E1 E2 E3 EC) ],
+        [ '2008/09', %w(E0 E1 E2 E3 EC) ],
+        [ '2007/08', %w(E0 E1 E2 E3 EC) ],
+        [ '2006/07', %w(E0 E1 E2 E3 EC) ],
+        [ '2005/06', %w(E0 E1 E2 E3 EC) ],
+        [ '2004/05', %w(E0 E1 E2 E3) ],
+        [ '2003/04', %w(E0 E1 E2 E3) ],
+        [ '2002/03', %w(E0 E1 E2 E3) ],
+        [ '2001/02', %w(E0 E1 E2 E3) ],
+        [ '2000/01', %w(E0 E1 E2 E3) ],
+        [ '1999/00', %w(E0 E1 E2 E3) ],
+        [ '1998/99', %w(E0 E1 E2 E3) ],
+        [ '1997/98', %w(E0 E1 E2 E3) ],
+        [ '1996/97', %w(E0 E1 E2 E3) ],
+        [ '1995/96', %w(E0 E1 E2 E3) ],
+        [ '1994/95', %w(E0 E1 E2 E3) ],
+        [ '1993/94', %w(E0 E1 E2 E3) ],
+  ],
+  sco: [[ '2020/21', %w(SC0 SC1 SC2 SC3) ],
+        [ '2019/20', %w(SC0 SC1 SC2 SC3) ],
+        [ '2018/19', %w(SC0 SC1 SC2 SC3) ],
+        [ '2017/18', %w(SC0 SC1 SC2 SC3) ],
+        [ '2016/17', %w(SC0 SC1 SC2 SC3) ],
+        [ '2015/16', %w(SC0 SC1 SC2 SC3) ],
+        [ '2014/15', %w(SC0 SC1 SC2 SC3) ],
+        [ '2013/14', %w(SC0 SC1 SC2 SC3) ],
+        [ '2012/13', %w(SC0 SC1 SC2 SC3) ],
+        [ '2011/12', %w(SC0 SC1 SC2 SC3) ],
+        [ '2010/11', %w(SC0 SC1 SC2 SC3) ],
+        [ '2009/10', %w(SC0 SC1 SC2 SC3) ],
+        [ '2008/09', %w(SC0 SC1 SC2 SC3) ],
+        [ '2007/08', %w(SC0 SC1 SC2 SC3) ],
+        [ '2006/07', %w(SC0 SC1 SC2 SC3) ],
+        [ '2005/06', %w(SC0 SC1 SC2 SC3) ],
+        [ '2004/05', %w(SC0 SC1 SC2 SC3) ],
+        [ '2003/04', %w(SC0 SC1 SC2 SC3) ],
+        [ '2002/03', %w(SC0 SC1 SC2 SC3) ],
+        [ '2001/02', %w(SC0 SC1 SC2 SC3) ],
+        [ '2000/01', %w(SC0 SC1 SC2 SC3) ],
+        [ '1999/00', %w(SC0 SC1 SC2 SC3) ],
+        [ '1998/99', %w(SC0 SC1 SC2 SC3) ],
+        [ '1997/98', %w(SC0 SC1 SC2 SC3) ],
+        [ '1996/97', %w(SC0 SC1) ],
+        [ '1995/96', %w(SC0 SC1) ],
+        [ '1994/95', %w(SC0 SC1) ]],
+  de:  [[ '2020/21', %w(D1 D2) ],
+        [ '2019/20', %w(D1 D2) ],
+        [ '2018/19', %w(D1 D2) ],
+        [ '2017/18', %w(D1 D2) ],
+        [ '2016/17', %w(D1 D2) ],
+        [ '2015/16', %w(D1 D2) ],
+        [ '2014/15', %w(D1 D2) ],
+        [ '2013/14', %w(D1 D2) ],
+        [ '2012/13', %w(D1 D2) ],
+        [ '2011/12', %w(D1 D2) ],
+        [ '2010/11', %w(D1 D2) ],
+        [ '2009/10', %w(D1 D2) ],
+        [ '2008/09', %w(D1 D2) ],
+        [ '2007/08', %w(D1 D2) ],
+        [ '2006/07', %w(D1 D2) ],
+        [ '2005/06', %w(D1 D2) ],
+        [ '2004/05', %w(D1 D2) ],
+        [ '2003/04', %w(D1 D2) ],
+        [ '2002/03', %w(D1 D2) ],
+        [ '2001/02', %w(D1 D2) ],
+        [ '2000/01', %w(D1 D2) ],
+        [ '1999/00', %w(D1 D2) ],
+        [ '1998/99', %w(D1 D2) ],
+        [ '1997/98', %w(D1 D2) ],
+        [ '1996/97', %w(D1 D2) ],
+        [ '1995/96', %w(D1 D2) ],
+        [ '1994/95', %w(D1 D2) ],
+        [ '1993/94', %w(D1 D2) ]],
+  it:  [[ '2020-21', %w(I1 I2) ],
+        [ '2019-20', %w(I1 I2) ],
+        [ '2018-19', %w(I1 I2) ],
+        [ '2017-18', %w(I1 I2) ],
+        [ '2016-17', %w(I1 I2) ],
+        [ '2015-16', %w(I1 I2) ],
+        [ '2014-15', %w(I1 I2) ],
+        [ '2013-14', %w(I1 I2) ],
+        [ '2012-13', %w(I1 I2) ],
+        [ '2011-12', %w(I1 I2) ],
+        [ '2010-11', %w(I1 I2) ],
+        [ '2009-10', %w(I1 I2) ],
+        [ '2008-09', %w(I1 I2) ],
+        [ '2007-08', %w(I1 I2) ],
+        [ '2006-07', %w(I1 I2) ],
+        [ '2005-06', %w(I1 I2) ],
+        [ '2004-05', %w(I1 I2) ],
+        [ '2003-04', %w(I1 I2) ],
+        [ '2002-03', %w(I1 I2) ],
+        [ '2001-02', %w(I1 I2) ],
+        [ '2000-01', %w(I1 I2) ],
+        [ '1999-00', %w(I1 I2) ],
+        [ '1998-99', %w(I1 I2) ],
+        [ '1997-98', %w(I1 I2) ],
+        [ '1996-97', %w(I1) ],
+        [ '1995-96', %w(I1) ],
+        [ '1994-95', %w(I1) ],
+        [ '1993-94', %w(I1) ]],
+  es:  [[ '2020-21', %w(SP1 SP2) ],
+        [ '2019-20', %w(SP1 SP2) ],
+        [ '2018-19', %w(SP1 SP2) ],
+        [ '2017-18', %w(SP1 SP2) ],
+        [ '2016-17', %w(SP1 SP2) ],
+        [ '2015-16', %w(SP1 SP2) ],
+        [ '2014-15', %w(SP1 SP2) ],
+        [ '2013-14', %w(SP1 SP2) ],
+        [ '2012-13', %w(SP1 SP2) ],
+        [ '2011-12', %w(SP1 SP2) ],
+        [ '2010-11', %w(SP1 SP2) ],
+        [ '2009-10', %w(SP1 SP2) ],
+        [ '2008-09', %w(SP1 SP2) ],
+        [ '2007-08', %w(SP1 SP2) ],
+        [ '2006-07', %w(SP1 SP2) ],
+        [ '2005-06', %w(SP1 SP2) ],
+        [ '2004-05', %w(SP1 SP2) ],
+        [ '2003-04', %w(SP1 SP2) ],
+        [ '2002-03', %w(SP1 SP2) ],
+        [ '2001-02', %w(SP1 SP2) ],
+        [ '2000-01', %w(SP1 SP2) ],
+        [ '1999-00', %w(SP1 SP2) ],
+        [ '1998-99', %w(SP1 SP2) ],
+        [ '1997-98', %w(SP1 SP2) ],
+        [ '1996-97', %w(SP1 SP2) ],
+        [ '1995-96', %w(SP1) ],
+        [ '1994-95', %w(SP1) ],
+        [ '1993-94', %w(SP1) ]],
+  fr:  [[ '2020-21', %w(F1 F2) ],
+        [ '2019-20', %w(F1 F2) ],
+        [ '2018-19', %w(F1 F2) ],
+        [ '2017-18', %w(F1 F2) ],
+        [ '2016-17', %w(F1 F2) ],
+        [ '2015-16', %w(F1 F2) ],
+        [ '2014-15', %w(F1 F2) ],
+        [ '2013-14', %w(F1 F2) ],
+        [ '2012-13', %w(F1 F2) ],
+        [ '2011-12', %w(F1 F2) ],
+        [ '2010-11', %w(F1 F2) ],
+        [ '2009-10', %w(F1 F2) ],
+        [ '2008-09', %w(F1 F2) ],
+        [ '2007-08', %w(F1 F2) ],
+        [ '2006-07', %w(F1 F2) ],
+        [ '2005-06', %w(F1 F2) ],
+        [ '2004-05', %w(F1 F2) ],
+        [ '2003-04', %w(F1 F2) ],
+        [ '2002-03', %w(F1 F2) ],
+        [ '2001-02', %w(F1 F2) ],
+        [ '2000-01', %w(F1 F2) ],
+        [ '1999-00', %w(F1 F2) ],
+        [ '1998-99', %w(F1 F2) ],
+        [ '1997-98', %w(F1 F2) ],
+        [ '1996-97', %w(F1 F2) ],
+        [ '1995-96', %w(F1) ],
+        [ '1994-95', %w(F1) ],
+        [ '1993-94', %w(F1) ]],
+  nl:  [[ '2020-21', %w(N1) ],
+        [ '2019-20', %w(N1) ],
+        [ '2018-19', %w(N1) ],
+        [ '2017-18', %w(N1) ],
+        [ '2016-17', %w(N1) ],
+        [ '2015-16', %w(N1) ],
+        [ '2014-15', %w(N1) ],
+        [ '2013-14', %w(N1) ],
+        [ '2012-13', %w(N1) ],
+        [ '2011-12', %w(N1) ],
+        [ '2010-11', %w(N1) ],
+        [ '2009-10', %w(N1) ],
+        [ '2008-09', %w(N1) ],
+        [ '2007-08', %w(N1) ],
+        [ '2006-07', %w(N1) ],
+        [ '2005-06', %w(N1) ],
+        [ '2004-05', %w(N1) ],
+        [ '2003-04', %w(N1) ],
+        [ '2002-03', %w(N1) ],
+        [ '2001-02', %w(N1) ],
+        [ '2000-01', %w(N1) ],
+        [ '1999-00', %w(N1) ],
+        [ '1998-99', %w(N1) ],
+        [ '1997-98', %w(N1) ],
+        [ '1996-97', %w(N1) ],
+        [ '1995-96', %w(N1) ],
+        [ '1994-95', %w(N1) ],
+        [ '1993-94', %w(N1) ]],
+  be:  [[ '2020-21', %w(B1) ],
+        [ '2019-20', %w(B1) ],
+        [ '2018-19', %w(B1) ],
+        [ '2017-18', %w(B1) ],
+        [ '2016-17', %w(B1) ],
+        [ '2015-16', %w(B1) ],
+        [ '2014-15', %w(B1) ],
+        [ '2013-14', %w(B1) ],
+        [ '2012-13', %w(B1) ],
+        [ '2011-12', %w(B1) ],
+        [ '2010-11', %w(B1) ],
+        [ '2009-10', %w(B1) ],
+        [ '2008-09', %w(B1) ],
+        [ '2007-08', %w(B1) ],
+        [ '2006-07', %w(B1) ],
+        [ '2005-06', %w(B1) ],
+        [ '2004-05', %w(B1) ],
+        [ '2003-04', %w(B1) ],
+        [ '2002-03', %w(B1) ],
+        [ '2001-02', %w(B1) ],
+        [ '2000-01', %w(B1) ],
+        [ '1999-00', %w(B1) ],
+        [ '1998-99', %w(B1) ],
+        [ '1997-98', %w(B1) ],
+        [ '1996-97', %w(B1) ],
+        [ '1995-96', %w(B1) ]],
+  pt:  [[ '2020-21', %w(P1) ],
+        [ '2019-20', %w(P1) ],
+        [ '2018-19', %w(P1) ],
+        [ '2017-18', %w(P1) ],
+        [ '2016-17', %w(P1) ],
+        [ '2015-16', %w(P1) ],
+        [ '2014-15', %w(P1) ],
+        [ '2013-14', %w(P1) ],
+        [ '2012-13', %w(P1) ],
+        [ '2011-12', %w(P1) ],
+        [ '2010-11', %w(P1) ],
+        [ '2009-10', %w(P1) ],
+        [ '2008-09', %w(P1) ],
+        [ '2007-08', %w(P1) ],
+        [ '2006-07', %w(P1) ],
+        [ '2005-06', %w(P1) ],
+        [ '2004-05', %w(P1) ],
+        [ '2003-04', %w(P1) ],
+        [ '2002-03', %w(P1) ],
+        [ '2001-02', %w(P1) ],
+        [ '2000-01', %w(P1) ],
+        [ '1999-00', %w(P1) ],
+        [ '1998-99', %w(P1) ],
+        [ '1997-98', %w(P1) ],
+        [ '1996-97', %w(P1) ],
+        [ '1995-96', %w(P1) ],
+        [ '1994-95', %w(P1) ]],
+  tr:  [[ '2020-21', %w(T1) ],
+        [ '2019-20', %w(T1) ],
+        [ '2018-19', %w(T1) ],
+        [ '2017-18', %w(T1) ],
+        [ '2016-17', %w(T1) ],
+        [ '2015-16', %w(T1) ],
+        [ '2014-15', %w(T1) ],
+        [ '2013-14', %w(T1) ],
+        [ '2012-13', %w(T1) ],
+        [ '2011-12', %w(T1) ],
+        [ '2010-11', %w(T1) ],
+        [ '2009-10', %w(T1) ],
+        [ '2008-09', %w(T1) ],
+        [ '2007-08', %w(T1) ],
+        [ '2006-07', %w(T1) ],
+        [ '2005-06', %w(T1) ],
+        [ '2004-05', %w(T1) ],
+        [ '2003-04', %w(T1) ],
+        [ '2002-03', %w(T1) ],
+        [ '2001-02', %w(T1) ],
+        [ '2000-01', %w(T1) ],
+        [ '1999-00', %w(T1) ],
+        [ '1998-99', %w(T1) ],
+        [ '1997-98', %w(T1) ],
+        [ '1996-97', %w(T1) ],
+        [ '1995-96', %w(T1) ],
+        [ '1994-95', %w(T1) ]],
+  gr:  [[ '2020-21', %w(G1) ],
+        [ '2019-20', %w(G1) ],
+        [ '2018-19', %w(G1) ],
+        [ '2017-18', %w(G1) ],
+        [ '2016-17', %w(G1) ],
+        [ '2015-16', %w(G1) ],
+        [ '2014-15', %w(G1) ],
+        [ '2013-14', %w(G1) ],
+        [ '2012-13', %w(G1) ],
+        [ '2011-12', %w(G1) ],
+        [ '2010-11', %w(G1) ],
+        [ '2009-10', %w(G1) ],
+        [ '2008-09', %w(G1) ],
+        [ '2007-08', %w(G1) ],
+        [ '2006-07', %w(G1) ],
+        [ '2005-06', %w(G1) ],
+        [ '2004-05', %w(G1) ],
+        [ '2003-04', %w(G1) ],
+        [ '2002-03', %w(G1) ],
+        [ '2001-02', %w(G1) ],
+        [ '2000-01', %w(G1) ],
+        [ '1999-00', %w(G1) ],
+        [ '1998-99', %w(G1) ],
+        [ '1997-98', %w(G1) ],
+        [ '1996-97', %w(G1) ],
+        [ '1995-96', %w(G1) ],
+        [ '1994-95', %w(G1) ]]
+}
+
+## all seasons in-one-file datasets
+SOURCES_II =
+{
+    ## https://www.football-data.co.uk/new/<code>.csv
+    ##
+    ##  check - adjust time-zone/time-offset
+    ##
+    ## - austria
+    ## - major-league-soccer
+    ## - mexico
+    ## - brazil
+    ##
+    ##  if no "national" repo, use the "world" repo
+    ##
+    ##  check for seasons format
+    ##     is a full year e.g. 2016 (and NOT 2016/17)
+    ##       e.g. bra,arg, fin, and others!!!!
+
+   ar: 'ARG',  # Argentina Football Results - Primera Division
+   at: 'AUT',  # Austria Football Results   - Bundesliga
+   br: 'BRA',  # Brazil Football Results    - Serie A
+   cn: 'CHN',  # China Football Results     - Super League
+   dk: 'DNK',  # Denmark Football Results  - Superliga
+   fi: 'FIN',  # Finland Football Results  - Veikkausliiga
+   ie: 'IRL',  # Ireland Football Results  - Premier Division
+   jp: 'JPN',  # Japan Football Results    - J-League
+   mx: 'MEX',  # Mexico Football Results   - Liga MX
+   no: 'NOR',  # Norway Football Results  - Eliteserien
+   pl: 'POL',  # Poland Football Results  - Ekstraklasa
+   ro: 'ROU',  # Romania Football Results  - Liga 1
+   ru: 'RUS',  # Russia Football Results  - Premier League
+   se: 'SWE',  # Sweden Football Results  - Allsvenskan
+   ch: 'SWZ',  # Switzerland Football Results - Super League
+   us: 'USA',  # USA Football Results  - MLS
+}
+
+## map football_data leagues to our own keys
+LEAGUES = {
+  'E0'  => 'eng.1',  # english premier league
+  'E1'  => 'eng.2',  # english championship league
+  'E2'  => 'eng.3',  # english league 1
+  'E3'  => 'eng.4',  # english league 2
+  'EC'  => 'eng.5',  # english conference
+
+  'SP1' => 'es.1',   # spanish liga 1
+  'SP2' => 'es.2',   # spanish liga 2
+
+  'F1'  => 'fr.1',   # french ligue 1
+  'F2'  => 'fr.2',   # french ligue 2
+
+  'I1'  => 'it.1',   # italian serie a
+  'I2'  => 'it.2',   # italian serie b
+
+  'D1'  => 'de.1',   # german bundesliga
+  'D2'  => 'de.2',   # german 2. bundesliga
+
+  'SC0' => 'sco.1',  # scotish Premiership  # starting w/ 2013-14 season
+  'SC1' => 'sco.2',  # scotish Championship
+  'SC2' => 'sco.3',  # scotish League One
+  'SC3' => 'sco.4',  # scotish League Two
+
+  'N1'  => 'nl.1',   # dutch eredivisie
+
+  'B1'  => 'be.1',   # belgian pro league
+
+  'P1'  => 'pt.1',   # portugese Primeira Liga
+
+  'T1'  => 'tr.1',   # turkish Süper Lig
+
+  'G1'  => 'gr.1',   # greek Superleague
+}
+
+
+# https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+##  todo/fix: add support for dst (daylight saving time!!! )
+##   uses always "winter" time for now
+TIMEZONES = {
+  mx:  -6,     ## America/Mexico_City - note: baja sur is -7, bajar norte (tijuana) is -8 !!!
+  us:  -5,     ## America/New_York
+  ar:  -3,     ## America/Argentina/Buenos_Aires
+  br:  -3,     ## America/Sao_Paulo
+
+  eng:  0,     ## Europe/London
+  sco:  0,     ## ?
+  ie:   0,     ## Europe/Dublin
+  pt:   0,     ## Europe/Lisbon
+  at:  +1,     ## Europe/Vienna
+  de:  +1,     ## Europe/Berlin
+  it:  +1,     ## Europe/Rome
+  es:  +1,     ## Europe/Madrid
+  fr:  +1,     ## Europe/Paris
+  nl:  +1,     ## Europe/Amsterdam
+  be:  +1,     ## Europe/Brussels
+  dk:  +1,     ## Europe/Copenhagen
+  no:  +1,     ## Europe/Oslo
+  se:  +1,     ## Europe/Stockholm
+  ch:  +1,     ## Europe/Zurich
+
+  fi:  +2,     ## Europe/Helsinki
+  gr:  +2,     ## Europe/Athens
+  pl:  +2,     ## Europe/Warsaw
+  ro:  +2,     ## Europe/Bucharest
+  tr:  +3,     ## Europe/Istanbul
+  ru:  +3,     ## Europe/Moscow
+
+  cn:  +8,     ## Asia/Shanghai
+  jp:  +9,     ## Asia/Tokyo
+}
+
+end # module Footballdata12xpert

data/lib/footballdata-12xpert/convert.rb

@@ -0,0 +1,206 @@
+
+## todo/fix: move CsvMatchWriter to its own file!!!!!
+class CsvMatchWriter
+
+  def self.write( path, matches )
+
+    ## for convenience - make sure parent folders/directories exist
+    FileUtils.mkdir_p( File.dirname( path) )  unless Dir.exist?( File.dirname( path ))
+
+
+    out = File.new( path, 'w:utf-8' )
+
+    headers = [
+      'Date',
+      'Team 1',
+      'FT',
+      'HT',
+      'Team 2'
+    ]
+
+    out << headers.join(',')   ## e.g. Date,Team 1,FT,HT,Team 2
+    out << "\n"
+
+
+    matches.each_with_index do |match,i|
+
+      if i < 2
+         puts "[#{i}]:" + match.inspect
+      end
+
+      ## note: skip empty match rows
+      ##   todo/fix:   fix "upstream" in match parser!!!!!
+      next if match.team1.blank? && match.team2.blank?
+
+
+      values = []
+
+      ## note:
+      ##   as a convention add all auto-calculated values in ()
+      ##  e.g. weekday e.g. (Fri), weeknumber (22), matches played (2), etc.
+
+      ## for easier double-checking of rounds and dates
+      ##  (auto-)add weekday and weeknumber
+      ##  todo/fix: weeknumber - use +1  (do NOT start with 0 - why? why not)
+      if match.date
+        ## todo/fix: add time if present? why? why not?
+        ## note: assumes string for now e.g. 2018-11-22
+        date = Date.strptime( match.date, '%Y-%m-%d' )
+
+        date_buf = ''
+        date_buf << date.strftime( '%a %b %-d %Y' )
+        ## date_buf << " (W#{date.cweek})"  ## use week number (iso-standard week starting on monday)
+
+        values << date_buf   ## print weekday e.g. Fri, Sat, etc.
+      else
+        values << '?'
+      end
+
+
+
+      values << match.team1
+
+      if match.score1 && match.score2
+        values << "#{match.score1}-#{match.score2}"
+      else
+        # no (or incomplete) full time score; add empty
+        values << '?'
+      end
+
+      if match.score1i && match.score2i
+        values << "#{match.score1i}-#{match.score2i}"
+      else
+        # no (or incomplete) half time score; add empty
+        values << '?'
+      end
+
+      values << match.team2
+
+      out << values.join( ',' )
+      out << "\n"
+    end
+
+    out.close
+  end
+end # class CsvMatchWriter
+
+
+module Footballdata12xpert
+
+##
+## todo/fix: add fix_date converter to CsvReader !!!!!
+
+def self.convert( *country_keys, start: nil )
+  ## note: always downcase and symbolize keys (thus, allow strings too for now)
+  country_keys = country_keys.map {|key| key.downcase.to_sym }
+
+  SOURCES_I.each do |country_key, country_sources|
+    if country_keys.empty? || country_keys.include?( country_key )
+      convert_season_by_season( country_key,
+                                country_sources,
+                                  start: start )
+    else
+      ## skipping country
+    end
+  end
+
+  SOURCES_II.each do |country_key, country_basename|
+    if country_keys.empty? || country_keys.include?( country_key )
+      convert_all_seasons( country_key,
+                           country_basename,
+                             start: start )
+    else
+      ## skipping country
+    end
+  end
+end  ## method convert
+
+
+###
+# private helpers / machinery
+
+def self.convert_season_by_season( country_key, sources, start: nil )
+
+  start = Season.parse( start )   if start  ## convert to season obj
+
+
+  out_dir = './o'
+
+
+  sources.each do |rec|
+    season     = Season.parse( rec[0] )   ## note: dirname is season e.g. 2011-12 etc.
+    basenames  = rec[1]   ## e.g. E1,E2,etc.
+
+    if start && season < start
+      puts "skipping #{season} before #{start}"
+      next
+    end
+
+    basenames.each do |basename|
+      url = season_by_season_url( basename, season )
+
+      ## hack: find a better/easier helper method - why? why not?
+      in_path = "#{Webcache.root}/#{Webcache::DiskCache.new.url_to_path( url )}"
+      puts " url: >#{url}<, in_path: >#{in_path}<"
+
+      league_key = LEAGUES[basename]
+      league_basename = league_key   ## e.g.: eng.1, fr.1, fr.2 etc.
+
+      out_path = "#{out_dir}/#{season.to_path}/#{league_basename}.csv"
+
+      puts "out_path: #{out_path}"
+
+      matches = SportDb::CsvMatchParser.read( in_path )
+      puts "#{matches.size} matches"
+      exit 1   if matches.size == 0   ## make sure parse works (don't ignore empty reads)
+
+
+      CsvMatchWriter.write( out_path, matches )
+    end
+  end
+end # method convert_season_by_season
+
+
+
+def self.convert_all_seasons( country_key, basename, start: nil )
+
+  start = Season.parse( start )   if start  ## convert to season obj
+
+  out_dir = './o'
+
+  url = all_seasons_url( basename )
+
+  ## hack: find a better/easier helper method - why? why not?
+  in_path = "#{Webcache.root}/#{Webcache::DiskCache.new.url_to_path( url )}"
+  puts " url: >#{url}<, in_path: >#{in_path}<"
+
+  col  = 'Season'
+  season_keys = SportDb::CsvMatchParser.find_seasons( in_path, col: col )
+  pp season_keys
+
+  ## todo/check: make sure timezones entry for country_key exists!!! what results with nil/24.0 ??
+  fix_date_converter = ->(row) { fix_date( row, TIMEZONES[country_key]/24.0 ) }
+
+  season_keys.each do |season_key|
+    season = Season.parse( season_key )
+    if start && season < start
+      puts "skipping #{season} before #{start}"
+      next
+    end
+
+    matches = SportDb::CsvMatchParser.read( in_path, filters: { col => season_key },
+                                                     converters: fix_date_converter )
+
+    pp matches[0..2]
+    pp matches.size
+
+    ## note: assume (always) first level league for now
+    league_basename = "#{country_key}.1"    ## e.g.: ar.1, at.1, mx.1, us.1, etc.
+
+    out_path = "#{out_dir}/#{season.to_path}/#{league_basename}.csv"
+
+    CsvMatchWriter.write( out_path, matches )
+  end
+end
+
+end # module Footballdata12xpert