fifadat 0.0.1 → 2026.9.23

data/lib/fifadat/pp/convert.rb

@@ -1,163 +0,0 @@
-
-
-
-def convert( slug:, season:,
-                indir: '.',
-                outdir: './tmp' )
-
-    season = Season(season)
-
-    ## fix - change data to top or ??? - why? why not?
-    data = {}
-
-    ## add slug & seasons (add name to be done!!)
-    data[:meta] = { slug:      slug,
-                    season:    season.to_s,
-                    generated: Time.now.to_s,
-                  }
-
-
-   matches =  read_json_v2( "#{indir}/#{slug}/#{season.to_path}_matches.json" )
-   matches = matches['Results']  ## only use results (match) array
-
-   ## pp matches
-   puts "  #{matches.size} match(es) in season #{season}"
-
-
-  ## read in stages
-  ##   incl.  SequenceOrder, StageLevel (optional)
-  stages = Stages.read( "#{indir}/#{slug}/misc/#{season.to_path}_stages.json" )
-
-
-  stages.add_matches( matches )
-  data[:stages] = stages.as_json
-
-
-   teams = Teams.new
-   teams.add_matches( matches )
-   data[:teams] = teams.as_json
-
-
-   stadiums = Stadiums.new
-   stadiums.add_matches( matches )
-   data[:stadiums] = stadiums.as_json
-
-
-   ## for match-by-match live reports
-   report_dir = "#{indir}/#{slug}/matches/#{season.to_path}"
-   timeline_dir = "#{indir}/#{slug}/timelines/#{season.to_path}"
-
-
-   recs = []
-   matches.each_with_index do |m, i|
-
-       ## add/track id too - why? why not?
-       ##  rec[:id]  = m['IdMatch']
-
-
-        ## add/fill-up match basic
-       rec = _build_match( m )
-
-
-   ### get match (live) details
-   ###
-   ##   check if match report exits
-   ##    optional for now!!
-
-      live = _read_report( m, report_dir: report_dir )
-
-
-      ## if live.nil?
-      ##   puts "warn no match report for #{_report_basename(m)}"
-      ## end
-
-   if live
-      ## check for timeline
-      timeline = _read_timeline( m, timeline_dir: timeline_dir )
-      ## reuse generated output from report
-        report = _build_report( live, timeline )
-
-        ## try  update of score via goals from (match) report
-        score_more =  _build_report_score( live, timeline )
-        if score_more
-           rec[:score] = rec[:score].merge( score_more )
-        end
-
-
-
-        goals1 = report[:goals1]
-        goals2 = report[:goals2]
-
-
-       if goals1.empty? && goals2.empty?
-          ## skip if no goals
-       else
-         rec[:goals1] = goals1
-         rec[:goals2] = goals2
-
-
-
-       end
-
-
-       #########
-       ##  add penalties
-         penalties = report[:penalties]
-          rec[:penalties] = penalties   if penalties && !penalties.empty?
-
-
-      sentoff1 =  (report[:red1]||[]) + (report[:yellowred1]||[])
-      sentoff2 =  (report[:red2]||[]) + (report[:yellowred2]||[])
-
-      ## sort by minute
-      sentoff1 = sentoff1.sort { |l,r|  l[:minute] <=> r[:minute] }
-      sentoff2 = sentoff2.sort { |l,r|  l[:minute] <=> r[:minute] }
-
-     rec[:sentoff1] = sentoff1    unless sentoff1.empty?
-     rec[:sentoff2] = sentoff2    unless sentoff2.empty?
- end
-
-
-
-=begin
-   "Officials":
-     [{"IdCountry": "BRA",
-       "OfficialId": "361561",
-       "NameShort": [{"Locale": "en-GB", "Description": "Wilton SAMPAIO"}],
-       "Name": [{"Locale": "en-GB", "Description": "Wilton SAMPAIO"}],
-       "OfficialType": 1,
-       "TypeLocalized": [{"Locale": "en-GB", "Description": "Referee"}]},
-      {"IdCountry": "PAR",
-       "OfficialId": "416159",
-       "NameShort":
-        [{"Locale": "en-GB", "Description": "Juan Gabriel BENITEZ"}],
-       "Name": [{"Locale": "en-GB", "Description": "Juan Gabriel Benítez"}],
-       "OfficialType": 4,
-       "TypeLocalized":
-        [{"Locale": "en-GB", "Description": "Fourth official"}]}],
-=end
-
-###
-##  add referees
-    officials = build_officials( m['Officials'], id: false )
-
-    if officials.empty?
-       ## puts "!! WARN no refs / officials found"
-    else
-         rec[:referees] = officials
-    end
-
-
-
-
-      recs << rec
-   end
-   data[:matches] = recs
-
-
-    outpath =  "#{outdir}/#{season.to_path}/#{slug}.json"
-    write_json( outpath, data)
-    puts "  written to >#{outpath}<"
-
-    true
-end

data/lib/fifadat/pp/goals-calc_score.rb

@@ -1,58 +0,0 @@
-
-
-def _build_score_from_goals( m )
-   ##
-   ## 5 periods - 3 (1ST_HALF), 5 (2ND_HALF),
-   ##             7 (EXTRA_TIME_1ST_HALF), 9 (EXTRA_TIME_2ND_HALF),
-   ##             11 (PENALTY_SHOOTOUT) possibly
-   ##
-   goals = {
-      count: 0,
-      score: [0,0],
-      ht:   { score: [0,0], minutes: [] },
-      ft:   { score: [0,0], minutes: [] },
-      et:   { score: [0,0], minutes: [] },
-      p:    { score: [0,0], minutes: [] },
-   }
-
-   ## note - quick fix
-   ##            add  period 2  for USA v Belgium (PKO) - worldcup
-
-   ## note - i is 0|1  -  array index for team
-   [m['HomeTeam']['Goals'],
-    m['AwayTeam']['Goals']].each_with_index do |recs,i|
-      recs.each do |h|
-
-        h = errata_autofix_goal( h )
-
-        period = h['Period']
-        ## include penalty shootout (11) - why? why not?
-        assert(  [3,5,7,9,11].include?(period),
-                  "goal in period 3/5/7/9/11 expected; got #{h.pretty_inspect} in match #{m.pretty_inspect}" )
-
-        minute = h['Minute']
-        key =  case period
-               when 3    then  :ht
-               when 5    then  :ft
-               when 7, 9 then  :et
-               when 11   then  :p
-               else
-                raise ArgumentError,
-                  "goal in period 3/5/7/9/11 expected; got #{h.pretty_inspect}"
-               end
-
-        goals[:count] += 1
-        goals[:score][i] += 1   unless key == :p
-        goals[key][:score][i] += 1
-      end
-   end
-
-   ## use/calc cummulative score  (BUT not for penalties)
-   goals[:ft][:score][0] += goals[:ht][:score][0]
-   goals[:ft][:score][1] += goals[:ht][:score][1]
-
-   goals[:et][:score][0] += goals[:ft][:score][0]
-   goals[:et][:score][1] += goals[:ft][:score][1]
-
-   goals
-end

data/lib/fifadat/pp/goals.rb

@@ -1,89 +0,0 @@
-
-
-
-
-def build_goal( h, players: )
-
-    ## split into minute
-    ##  and offset (stoppage/injury time)
-    ##  e.g. 90'+11'
-
-     h = errata_autofix_goal( h )
-
-     minute_str = h['Minute']
-
-     period = h['Period']
-
-     ##   note - penalty shootout gets excluded upstream!!
-     ##  include penalty shootout (11) - why? why not?
-     ## assert(  [3,5,7,9].include?(period),
-     ##             "goal in period 3/5/7/9 expected; got #{h.pretty_inspect}" )
-
-    ##  quick fix:
-    ## check for weird minute 0 e.g.
-    ##   Germany-Austria 1934
-    if minute_str == "0'"
-       h['Minute'] = "1'"
-    end
-
-    if minute_str.nil? || minute_str.empty?
-           puts "!! minute in goal is nil or empty:"
-           pp h
-           exit 1
-    end
-
-    minute = _build_minute( h )
-
-
-    rec = {}
-
-      idPlayer = h['IdPlayer']
-
-      if idPlayer.nil?
-         puts "!! no idPlayer for goal!"
-         pp h
-          ##exit 1
-          ## use 'N.N.'
-
-          rec[ :name ] = 'N.N.'
-
-      else
-        player = players.find!( idPlayer )
-        rec[ :name ] = player[ :name ]
-      end
-
-     rec[ :minute] = minute
-
-
-      ## check for goal type (og) or (p)
-      ##  1 -  "penalty"
-      ##  2 -  "regular"
-      ##  3 -  "own goal"
-
-      type =  h['Type']
-      rec[ :pen ] = true  if type == 1
-      rec[ :og ]  = true  if type == 3
-
-      rec
-end
-
-
-
-
-def build_goals( recs, players:,  penalties: false )
-
-    ## note - filter out penalties (from shoot-out)!!
-    ##    min > 120  (e.g. 121, etc.)
-    ##  note - use period (more reliable)
-    ##   period 11 is PENALTY_SHOOTOUT!!
-    if penalties == false
-       recs = recs.select { |rec| rec['Period'] != 11 }
-    end
-
-
-    recs = recs.map  { |h| build_goal( h, players: players ) }
-
-    ## note - sort by minutes; goals may not be sorted
-    recs = recs.sort { |l,r| l[:minute] <=> r[:minute] }
-    recs
-end

data/lib/fifadat/pp/helper-date.rb

@@ -1,13 +0,0 @@
-
-
-def _fmt_date_local(  date_utc, date_local )
-
-  ## note:  returns Rational (e.g. 3/1 or 1/4 etc.) use to_f/to_i to convert
-  diff_in_hours = ((date_local - date_utc) * 24).to_f
-  diff_in_days  =  date_local.jd - date_utc.jd
-  ## pp [diff_in_hours, diff_in_days]
-
-
-  ## use   20:30 UTC+1  or 20:30 UTC-3
-  "#{date_local.strftime( '%Y-%m-%d %H:%M' )} UTC%+d" % diff_in_hours
-end

data/lib/fifadat/pp/helper-minute.rb

@@ -1,81 +0,0 @@
-
-
-##
-## note - check if m(inute) might be unknown e.g. '??' or such
-##
-##  offset (aka stoppage/injury/added time)
-
-Minute  = Struct.new( :m, :offset, :period) do
-    def as_json(*) to_s; end
-
-    ## note - format minute WITHOUT minute marker/quote (')
-    def to_s
-        buf =  String.new
-        buf << "#{m}"
-        buf << "+#{offset}"      if offset
-        buf
-    end
-
-    ##  add compare (for sort)
-    def <=>( other )
-         res = self.m           <=> other.m
-         res = (self.offset||0) <=> (other.offset||0)   if res == 0
-         res
-    end
-end  ## struct (class) Minute
-
-
-
-def _build_minute( h )
-
-    ## split into minute
-    ##  and offset (stoppage/injury/added time)
-    ##  e.g. 90'+11'
-
-     minute_str = h['Minute']
-          if minute_str.nil? || minute_str.empty?
-              puts "!! minute is nil or empty:"
-              pp h
-              exit 1
-          end
-
-     minute, offset  = _parse_minute( minute_str )
-
-     Minute.new( m:      minute,
-                 offset: offset,
-                 period: h['Period'] )
-end
-
-
- MINUTE_RE = %r{  \A
-                       (?<minute>\d{1,3}) '
-                        (  \+
-                          (?<offset>\d{1,2}) '
-                        )?
-                   \z
-                 }x
-
-
-def _parse_minute( str )
-
-    ## support weirdo  120'+-30'  -- remove minuts
-    str = str.gsub( '-', '' )
-
-    m = MINUTE_RE.match( str )
-    raise ArgumentError, "unknown goal minute format in #{str.inspect}"  if m.nil?
-
-    minute = m[:minute].to_i(10)
-    offset = m[:offset] ? m[:offset].to_i(10) : nil
-
-    [minute,offset]
-end
-
-def _fmt_minute( minute, offset )
-     ## pp [minute,offset]
-
-     buf = String.new
-     buf << "#{minute}"
-     buf << "+#{offset}"   if offset
-     buf << "'"
-     buf
-end

data/lib/fifadat/pp/helper-score.rb

@@ -1,139 +0,0 @@
-
-#
-# add quick fix for club world cup?!
-#      elsif  resultType == 1  ||  ## assume 1 - regular (90 mins+stoppage/injury time)
-#              resultType == 4  ||
-#        m['IdMatch'] == '400019191'  ##  fix for pachuca vs salzburg !!!
-#   has resultType == 0!!!
-
-
-def _parse_score( m )
-   h = { }
-
-   m = errata_autofix_score( m )
-
-
-  resultType  = m['ResultType']
-
-  score =  if m['HomeTeam'] && m['AwayTeam']  ## assume inside (match) report
-             [m['HomeTeam']['Score'], m['AwayTeam']['Score']].compact
-          else   ## assume (seasons) matches list
-            ## note - report has no "inline/flat" HomeTeamScore/AwayTeamScore
-             [m['HomeTeamScore'], m['AwayTeamScore']].compact
-          end
-
-
-   ## is score after extra-time or not?
-   ##    note - CANNOT tell for resultType 2!!!
-
-   if score.empty?
-       ## do nothing
-   else
-     if [1,4].include?( resultType )
-        ##  1 - regular - 90min
-        ##  4 - regular - 90min (on aggregate)
-        h[:ft] = score
-     elsif [3,5,8].include?( resultType )
-         ## 3 - aet (for sure)
-         ## 5 - aet [on aggregate] (for sure)
-         ## 8 -  golden goal in extra time  (aet/gg)
-         ##   fix/fix/fix  - add gold_goal flag for 8!!!
-        h[:et] = score   ## assume after extra-time !!!
-     elsif resultType == 2
-         ### note - 2 win on pens
-         ## 2 - win on pens  (with or WITHOUT aet!!)
-
-        ## check for competition for now
-        ##    incl. south american
-        if false   ## add some competitions here
-           h[:ft] = score
-        else
-           h[:et] = score
-        end
-     else
-        h[:score] = score
-     end
-    end
-
-
-    penScore = [m['HomeTeamPenaltyScore'],  m['AwayTeamPenaltyScore']].compact
-    aggScore = [m['AggregateHomeTeamScore'],m['AggregateAwayTeamScore']].compact
-
-
-    ## note - worldcup has penScore [0,0] for all matches, for example!!!
-     if penScore.empty? || penScore == [0,0]
-     else
-        h[:p] = penScore
-     end
-
-     h[:agg] = aggScore   if !aggScore.empty?
-     h
-end
-
-
-
-def _fmt_score( m )
-
-   m = errata_autofix_score( m )
-
-  ## m = (full) match hash incl.  IdMatch, etc.
-  ##  returns string e.g.  4-4  or 4-3 a.e.t etc
-
-  resultType  = m['ResultType']
-
-  # resultType
-  #            0 =>  no result / not played yet
-  #            1 => regular (90 mins)
-  #            2 => aet (120 mins), win on pens
-  #            3 => aet (120 mins)
-  #            8 =>  same as 3?  -aet with golden goal/silver goal in 1998 FRA-PAR
-
-  score = if resultType == 2   ## aet, win on pens
-             "#{m['HomeTeamScore']}-#{m['AwayTeamScore']}" +
-             " a.e.t., #{m['HomeTeamPenaltyScore']}-#{m['AwayTeamPenaltyScore']} pen."
-           elsif resultType == 3 || resultType == 8  ## aet
-             "#{m['HomeTeamScore']}-#{m['AwayTeamScore']} a.e.t."
-           elsif  resultType == 1  ||  ## assume 1 - regular (90 mins+stoppage/injury time)
-                  resultType == 4
-              "#{m['HomeTeamScore']}-#{m['AwayTeamScore']}"
-           elsif  resultType == 0
-               ##  double check if score present
-               ##   e.g. pachuca vs salzburg in cwc 2025??
-               raise ArgumentError,
-                  " resultType == 0 but score present idMatch #{m['IdMatch']} #{m['HomeTeamScore']}-#{m['AwayTeamScore']}"  if m['HomeTeamScore'] &&
-                                                                                                                               m['AwayTeamScore']
-              ""
-           else
-              raise ArgumentError, "unknown/unexpected result type #{resultType}"
-           end
-
-  score
-end
-
-
-
-
-__END__
-
-  score = if resultType == 2   ## aet, win on pens
-             { et: [m['HomeTeamScore'],m['AwayTeamScore']],
-               p:  [m['HomeTeamPenaltyScore'],m['AwayTeamPenaltyScore']] }
-           elsif resultType == 3 || resultType == 8  ## aet
-             { et: [m['HomeTeamScore'], m['AwayTeamScore']] }
-           elsif  resultType == 1  ||  ## assume 1 - regular (90 mins+stoppage/injury time)
-                  resultType == 4  ||
-                  m['IdMatch'] == '400019191'  ##  fix for pachuca vs salzburg !!!
-             { ft: [m['HomeTeamScore'],m['AwayTeamScore']] }
-           elsif  resultType == 12
-               ## fix/fix/fix - check for score too
-                nil
-           elsif  resultType == 0
-              ##  pachuca vs salzburg in cwc 2025??
-               ##  double check if score present
-               raise ArgumentError,
-                  " resultType == 0 but score present idMatch #{m['IdMatch']} #{m['HomeTeamScore']}-#{m['AwayTeamScore']}"  if m['HomeTeamScore'] &&
-                                                                                                                               m['AwayTeamScore']
-              nil
-           else
-              raise ArgumentError, "unknown/unexpected result type #{resultType}"
-           end

data/lib/fifadat/pp/norm.rb

@@ -1,34 +0,0 @@
-
-
-ALPHA_RE = %r{ \A
-                   \p{L}
-                   [\p{L} '.-]*
-               \z
-              }ix
-
-##
-##  J. HARTING               - note: include .
-##   Jose BUSTAMANTE-NAVA    - note: include -
-##   Yannick N'Djeng         - note: include '
-##    Ismail JAKOBS  Ismail JAKOBS
-
-def is_alpha?( name )  ## use is_alpha_name? or is_unialpha? or such??
-    ALPHA_RE.match( name ) ? true : false
-end
-
-
-def pp_alpha( name )
-  ##
-##  note:  e is decomposed   !!!!  - will break lexer!!!
-##   e (101)
-##   ́  (769)
-##   vs
-##     é (233)
-
-  buf = String.new
-  buf << ">#{name}< => "
-  name.each_char do |char|
-      buf << "#{char} (#{char.ord}) | "
-  end
-  buf
-end

data/lib/fifadat/pp/officials.rb

@@ -1,86 +0,0 @@
-
-=begin
-  "Officials":
-     [{"IdCountry": "URU",
-       "OfficialId": "61038",
-       "NameShort": [{"Locale": "en-GB", "Description": "Domingo LOMBARDI"}],
-       "Name": [{"Locale": "en-GB", "Description": "Domingo LOMBARDI"}],
-       "OfficialType": 1,
-       "TypeLocalized": [{"Locale": "en-GB", "Description": "Referee"}]},
-      {"IdCountry": "BEL",
-       "OfficialId": "60664",
-       "NameShort": [{"Locale": "en-GB", "Description": "Henry CRISTOPHE"}],
-       "Name": [{"Locale": "en-GB", "Description": "Henry CRISTOPHE"}],
-       "OfficialType": 2,
-       "TypeLocalized":
-        [{"Locale": "en-GB", "Description": "Assistant Referee 1"}]},
-      {"IdCountry": "BRA",
-       "OfficialId": "61289",
-       "NameShort": [{"Locale": "en-GB", "Description": "Gilberto REGO"}],
-       "Name": [{"Locale": "en-GB", "Description": "Gilberto REGO"}],
-       "OfficialType": 3,
-       "TypeLocalized":
-        [{"Locale": "en-GB", "Description": "Assistant Referee 2"}]}],
-
-=end
-
-
-  TYPE_OFFICIAL = {
-    1 => 'Referee',
-    2 => 'Assistant Referee 1',
-    3 => 'Assistant Referee 2',
-  }
-
-def build_official( h, id: )
-    name = desc( h['Name'] )
-
-    ## fix - use norm_official
-    ## name = norm_official( name )
-
-    idCountry = h['IdCountry']
-    type      = h['OfficialType']
-
-
-    assert( is_alpha?(name), "official name alpha expected; got #{pp_alpha(name)}" )
-
-
-
-    assert( [1,2,3,4,5,6,7,8,9,10].include?( type ), "official type 1/2/3/4/5/6/7/8/9/10 expected; got #{type}" )
-
-    rec = {}
-    rec[:id] = h['OfficialId']   if id
-
-    rec.merge!( name:      name,
-                country:   idCountry,
-                type:      type )
-
-    rec
-   end
-
-
-def build_officials( recs, id: false )  ## use referees?
-    recs = recs.map  { |h| build_official( h, id: id ) }
-
-    ## skip fourth official (4) for now
-    recs = recs.select { |h|  [1,2,3].include?( h[:type] ) }
-
-    ## sort by type 1/2/3
-    ##  1 - referee
-    ##  2 - assistant referee 1
-    ##  3 - assistant referee 2
-    ##  4 - fourth official
-    ##  5 - video assistant referee (var)
-    ##  6 - reserve referee
-    ##  7 - offside var
-    ##  8 - assistant var
-    ##  9 - support var
-    ## 10 - reserve assistant referee
-
-
-    recs = recs.sort { |l,r|  l[:type] <=> r[:type] }
-
-    ## change type to literal string
-    recs = recs.map { |h| h[:type]=TYPE_OFFICIAL[h[:type]]; h }
-
-    recs
-end