fifadat 0.0.1

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

@@ -0,0 +1,81 @@
+
+
+##
+## 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

@@ -0,0 +1,139 @@
+
+#
+# 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

@@ -0,0 +1,34 @@
+
+
+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

@@ -0,0 +1,86 @@
+
+=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

data/lib/fifadat/pp/penalties.rb

@@ -0,0 +1,132 @@
+
+=begin
+{"EventId": "120171",
+    "IdTeam": "43942",
+    "IdPlayer": "95982",
+    "Timestamp": "2022-11-14T10:47:50.8028496Z",
+    "MatchMinute": "120'",
+    "Period": 11,
+    "HomeGoals": 2,
+    "AwayGoals": 2,
+    "Type": 60,
+    "Qualifiers": [],
+    "TypeLocalized": [{"Locale": "en-GB", "Description": "Penalty missed"}],
+    "HomePenaltyGoals": 4,
+    "AwayPenaltyGoals": 3,
+    "EventDescription":
+     [{"Locale": "en-GB",
+       "Description":
+        "David BATTY (England) misses from the penalty spot!"}]}],
+ "Properties": {},
+ "IsUpdateable": null}
+=end
+
+
+def build_penalty( h, players:,
+                      team1_id:, team2_id: )
+
+    ## note - do NOT care about minutes in penalty shootout
+    ##   check for period == 11 (penalty shotout!!)
+    ##    period = h['Period']
+
+
+     ##########
+     ##  0 - goal   (when penalty awared used before)
+     ## 41 - penalty goal
+     ## 46 - penalty missed
+     ##   Dragan STOJKOVIC (Yugoslavia) rattles the crossbar from the spot!
+     ## 51 - penalty missed
+     ##    JULIO CESAR (Brazil) hits the post from the spot!
+     ## 60 - penalty missed
+     ##    COMAN (France) sees his penalty saved by the goalkeeper.
+     ##    Maxime BOSSIS (France) misses from the penalty spot! and many more
+     ## 65 - penalty missed
+     ##      TCHOUAMENI (France) misses from the penalty spot!
+
+     type = h['Type']    ## (timeline) event type
+
+     assert( [0,41,46,51,60,65].include?(type),
+             "event type 0/41/46/51/60/65 expected; got #{type}")
+
+
+     team =   if h['IdTeam'] == team1_id
+                   1
+              elsif h['IdTeam'] == team2_id
+                   2
+              else
+                 assert( false, "team1/2_id #{team1_id/team2_id} expected; got #{h.pretty_inspect}")
+              end
+
+    rec = { team:    team,     ## 1|2
+            score:   [h['HomePenaltyGoals'],
+                      h['AwayPenaltyGoals']],
+            scored:   [0,41].include?( type ) ? true : false,
+          }
+
+     idPlayer = h['IdPlayer']
+
+
+=begin
+  -- try IdSubPlayer - why? why not?
+     IdSubPlayer is goalkeeper!!!
+    ## what is SubPlayer/SubTeam in event??
+!! no idPlayer for penaltyl!
+{"EventId"=>"17807200001266",
+ "IdTeam"=>"1884426",
+ "IdSubPlayer"=>"408948",
+ "IdSubTeam"=>"1897032",
+=end
+
+      if idPlayer.nil?
+         puts "!! no idPlayer for penalty!"
+         pp h
+          ##exit 1
+          ## use 'N.N.'
+
+          rec[ :name ] = 'N.N.'
+
+      else
+        rec[ :name ] = players.find!( idPlayer )[:name]
+      end
+
+       rec[:meta] = {  type: type,
+                       desc: desc(h['EventDescription'])  ## add event desc too - why? why not?
+                    }
+     rec
+end
+
+
+
+
+def build_penalties( recs, players:,
+                           team1_id:, team2_id: )
+     ################
+     ## type:
+     ##  check for "old/legacy" format used where?
+     ##        not using period 11 ???
+     ##   incl. weirdo format with
+     ##    6 -  penalty awarded
+     ##     0 - goal or 60 - penalty missed!
+     ##
+     ##  2 - yellow card
+     ##  3 - red card
+     ##  7 - start time
+     ##  8 - end time
+
+     recs = recs.select do |h|
+                              if h['Period'] == 11   ## penalty shoot-out
+                                assert( [0,2,3,6,7,8,41,46,51,60,65].include?( h['Type'] ),
+                                   "expected event type 2/3/7/8/41/46/51/60/65 for pens; got #{h.pretty_inspect}"
+                                 )
+                                [0,41,46,51,60,65].include?( h['Type'] ) ? true : false
+                              else
+                                 false
+                              end
+                        end
+
+
+    recs = recs.map { |h| build_penalty( h, players: players,
+                                            team1_id: team1_id,
+                                            team2_id: team2_id ) }
+    recs
+end