fifadat 2026.9.23 → 2026.9.30

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d19213e5956ee6aaf3b22b96239fb452d2e3f1209ffe084bb87fda84583e6b4
-  data.tar.gz: d7a67da62d2988d9d5339ac46f2d87363cbead3837a55efab62f40afbf21e4fb
+  metadata.gz: 7785bb2b01f91bf0eca6a9d47ec73e0a7a6b98c6d11c23dc150843a3e2d4502d
+  data.tar.gz: c7d838da7303b761ec6b5fcd0d46459e17df1d9513ebb4c418724f22d2846622
 SHA512:
-  metadata.gz: 0d499453ba6e7484508714ba66e1b22dd7fafb18f8d91a0bb78c55de469b8e568adb6335d7fd40dbf6ee054835e9cd401b9a627da5b2a1b40f69eeccdbdd3de5
-  data.tar.gz: ee280e1f231c66d1d494f6f07ee13be39f9b0d66a64e3bb46bcdaa0b6d583e506389461c4ab9ea4204da0b6a80f83c9c79845459543127bb79b4273280d4def2
+  metadata.gz: 2076c18eb49a0b5a22fddf58ac082eb81cf83cd1c47cba048278b22f77bae6fb4c6e3c268f5069fc943b800f13ed3be0c5301f03f9cb23a53ef1d2a62e9a55ae
+  data.tar.gz: 12554947e6f9105fb1c965bfa56c7d9685287bd60119661928ff2e9a356c5d9d2ef9dfdbf361d7bbe61f40948c50845845190b13e96446399f6a26ee3531b6fb

data/CHANGELOG.md

@@ -1,5 +1,5 @@
 
-### 2026.9.23
+### 2026.9.30
 ### 0.0.1 / 2026-07-22
 
 * Everything is new. First release.

data/Manifest.txt

@@ -63,6 +63,11 @@ config/seasons/za.csv
 lib/fifadat.rb
 lib/fifadat/api.rb
 lib/fifadat/config.rb
+lib/fifadat/helper.rb
 lib/fifadat/json.rb
+lib/fifadat/pp/ppdebug.rb
+lib/fifadat/pp/ppmatch.rb
+lib/fifadat/pp/ppstats.rb
 lib/fifadat/prepare.rb
+lib/fifadat/types.rb
 lib/fifadat/version.rb

data/lib/fifadat/api.rb

@@ -74,11 +74,19 @@ class Metal
 
 
 
+
    def self.squads_url( idSeason:, idCompetition: )
       ## API_ROOT/teams/squads/all/108/278491
       "#{BASE_URL}/teams/squads/all/#{idCompetition}/#{idSeason}"
    end
 
+   def self.teams_url( idSeason: )
+     ## /competitions/teams/{season}
+     #  Teams participating in a competition/season
+      "#{BASE_URL}/competitions/teams/#{idSeason}" +
+         "?language=en"
+   end
+
    def self.matches_url( idSeason: )
        ## note - may add  &idCompetition=17
 
@@ -101,10 +109,61 @@ class Metal
       "#{BASE_URL}/live/football/#{idCompetition}/#{idSeason}/#{idStage}/#{idMatch}?language=en"
    end
 
+=begin
    def self.timeline_url( idCompetition:, idSeason:,
                                idStage:, idMatch: )
       #API_ROOT/timelines/108/278491/278493/300424860?language=en-GB
+
       "#{BASE_URL}/timelines/#{idCompetition}/#{idSeason}/#{idStage}/#{idMatch}?language=en"
    end
+=end
+
+   def self.timeline_url( idMatch: )
+      #API_ROOT/timelines/108/278491/278493/300424860?language=en-GB
+
+      ##
+      ## todo/check
+      ##   only use idMatch ??
+      ## e.g. GET https://api.fifa.com/api/v3/timelines/{matchId}?language=en
+
+      "#{BASE_URL}/timelines/#{idMatch}?language=en"
+   end
+
+#############
+## more support urls
+
+    # get_team
+    #   Get a national team or club by its idTeam: name, abbreviation, country,
+    #     home city, and stadium.
+    #     Surfaces idStadium so you can chain to get_stadium.
+   def self.team_url( idTeam: )        ## note - singular (NOT plural)
+      "#{BASE_URL}/teams/#{idTeam}?language=en"
+   end
+
+
+   ## note - singular (NOT plural)
+   #   Squad/player information
+   def self.squad_url( idTeam:, idCompetition:, idSeason: )
+      "#{BASE_URL}/teams/#{idTeam}/squad?idCompetition=#{idCompetition}&idSeason=#{idSeason}&language=en"
+   end
+
+
+#  list_countries
+# List FIFA countries and member associations (reference data),
+#  each with its idCountry
+
+   def self.countries_url
+      "#{BASE_URL}/countries?count=500&language=en"
+   end
+
+#  list_confederations
+#   List the six FIFA confederations
+#    (UEFA, CONMEBOL, CONCACAF, CAF, AFC, OFC), each with its idConfederation
+
+   def self.confederations_url
+      "#{BASE_URL}/confederations?language=en"
+   end
+
+
 end  ## class Metal
 end # class Fifa

data/lib/fifadat/helper.rb

@@ -0,0 +1,52 @@
+
+
+def assert( test, msg )
+    if test
+    else
+        puts "!! ASSERT FAILED - #{msg}"
+        exit 1
+    end
+end
+
+### fix - change/rename to datetime!!!
+def parse_date( date_str )
+    date = DateTime.strptime( date_str, '%Y-%m-%dT%H:%M:%S%z' )
+
+    assert( date_str == date.strftime('%Y-%m-%dT%H:%M:%SZ'),
+              "date parse expected #{date_str} - got #{date.inspect}" )
+    date
+end
+
+
+def parse_date_utc( str )
+    date = DateTime.strptime( str, '%Y-%m-%dT%H:%M:%S%z' )
+
+    ## note: check for seconds is 00
+    ##    AND   timezone  is Z (zulu)  (shortkey for utc!)
+    ##  e.g. hard code   ":00Z" in strftime!!!
+
+    str_exp = date.strftime('%Y-%m-%dT%H:%M:00Z')
+    assert( str == str_exp,
+              "date parse expected #{str_exp} - got #{str} #{date.inspect}" )
+    date
+end
+
+
+
+=begin
+- [ ] add desc json samples here
+
+=end
+
+
+
+def desc( data )   ## get description
+    return nil if data.nil? || (data.is_a?(Array) && data.empty?)
+
+    row = data[0]   ## assume first entry is en-GB
+    locale = row['Locale']
+    assert( locale == 'en-GB' || locale == 'en-gb',
+              "locale en-GB expected in data[0] - got #{data}")
+
+    row['Description']
+end

data/lib/fifadat/pp/ppdebug.rb

@@ -0,0 +1,69 @@
+
+
+
+def pp_debug( data )
+
+   errors = []
+
+
+   matches = data['Results']  ## only use results (match) array
+
+   ## get SeasonName from first match
+   m = matches[0]
+   competitionName = desc( m['CompetitionName'])
+   seasonName      = desc( m['SeasonName'])
+
+
+   ## pp data
+   puts "  #{matches.size} match(es) in  #{competitionName} / #{seasonName}"
+
+
+   buf = String.new
+
+matches.each_with_index do |m, i|
+
+
+## todo -- log match details
+##          if matchstatus   not 0,1
+##      or result type       not 0,1,2,3,4,5  !!!
+
+
+   buf << "==> [#{i+1}/#{matches.size}]  "
+   buf << pp_match(m)
+
+
+   idMatch =  m['IdMatch']
+
+   matchStatus = m['MatchStatus']
+   resultType  = m['ResultType']
+
+  ## add aggregate score too
+  score        = [m['HomeTeamScore'],        m['AwayTeamScore']].compact
+  penScore = [m['HomeTeamPenaltyScore'], m['AwayTeamPenaltyScore']].compact
+  aggScore = [m['AggregateHomeTeamScore'],m['AggregateAwayTeamScore']].compact
+
+
+  if resultType == 0 && !score.empty?
+       ##  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']}"
+
+     msg = " resultType == 0 but score present idMatch #{idMatch} #{score.inspect}"
+     errors << msg
+  end
+
+   if ![0,1,9].include?(matchStatus)
+      msg =  "matchStatus 0-END,1-SCHED,9-AWD expected; got #{matchStatus} in: #{m.pretty_inspect}"
+      errors << msg
+   end
+
+  if ![0,1,2,3,4,5,8,12].include?(resultType)
+     msg = "resultType 0,1,2,3,4,5,8,12 expected; got #{resultType} in: #{m.pretty_inspect}"
+     errors << msg
+  end
+end
+
+
+   [buf, errors]
+end

data/lib/fifadat/pp/ppmatch.rb

@@ -0,0 +1,78 @@
+
+
+## todo/check:
+##    use: fomat:  full/fuller, short/long or such - why? why not?
+def pp_match( m, season: false )
+
+   competitionName = desc( m['CompetitionName'])
+   seasonName      = desc( m['SeasonName'])
+
+
+  idCompetition = m['IdCompetition']
+  idSeason      = m['IdSeason']
+  idStage       = m['IdStage']
+  idMatch       = m['IdMatch']
+
+   stageName   = desc( m['StageName'] )
+   groupName   = desc( m['GroupName'] )  # optional
+   matchDay    = m['MatchDay']           # optional
+
+   matchNumber = m['MatchNumber']        # optional
+
+   team1 = m['Home'] ? { name:    desc( m['Home']['TeamName'] ),
+                        abbrev:  m['Home']['Abbreviation'],
+                        country: m['Home']['IdCountry'],
+                       }
+                    :  { name: '?',  abbrev: '?',  country: '?'  }
+
+   team2 = m['Away'] ? { name:    desc( m['Away']['TeamName'] ),
+                        abbrev:  m['Away']['Abbreviation'],
+                        country: m['Away']['IdCountry'],
+                       }
+                     : { name: '?', abbrev: '?', country: '?' }
+
+
+  matchStatus  = m['MatchStatus']
+  resultType  = m['ResultType']
+
+  ## add aggregate score too
+  score        = [m['HomeTeamScore'],        m['AwayTeamScore']].compact
+  penScore = [m['HomeTeamPenaltyScore'], m['AwayTeamPenaltyScore']].compact
+  aggScore = [m['AggregateHomeTeamScore'],m['AggregateAwayTeamScore']].compact
+
+
+
+   buf = String.new
+
+
+   if season
+     ## beautify
+     ##   possible rm competitionName from season
+
+     seasonNameAlt = seasonName.sub( competitionName, '').gsub( /[ ]{2,}/,' ').strip
+    buf << "== #{competitionName}"
+    buf << " | #{seasonNameAlt}"
+    buf << "\n"
+   end
+
+
+   buf << "#{matchStatus}-#{MATCH_STATUS[matchStatus]||'??'}  "
+   buf << "  ▪ #{stageName}"
+   buf <<  ", #{groupName}"    if groupName
+   buf << " - #{matchDay}"     if matchDay
+   buf << " (#{matchNumber})"  if matchNumber
+
+   buf <<  "   #{team1[:name]} | #{team1[:abbrev]} (#{team1[:country]})"
+   buf <<  " v "
+   buf <<  "#{team2[:name]} | #{team2[:abbrev]} (#{team2[:country]})  "
+   buf << "\n"
+
+   buf <<  "  "
+   buf <<  " (#{resultType}-#{RESULT_TYPE[resultType]||'??'})"
+   buf <<  "  score: #{score.inspect}"   unless score.empty?
+   buf <<  " pen: #{penScore.inspect}"   unless penScore.empty?
+   buf <<  " agg: #{aggScore.inspect}"   unless aggScore.empty?
+   buf <<  "\n"
+
+   buf
+end

data/lib/fifadat/pp/ppstats.rb

@@ -0,0 +1,97 @@
+
+
+
+class Counter
+  def initialize( types )
+    @types = types
+    @counter = Hash.new(0)
+  end
+
+  def [](key)        @counter[key]; end
+  def []=(key,value) @counter[key]=value; end
+
+  def pretty_print(q)
+      q.group(1, "{", "}") do
+## sort by keys
+            pairs = @counter.sort_by { |key,_| key }
+            pairs.each_with_index do |(key,count),i|
+                 q.breakable(', ')   if i != 0
+                 q.text( "#{key}-#{(@types[key]||'??')}=>#{count}")
+            end
+      end
+  end
+
+end ## class Counter
+
+
+
+def mk_stats
+ stats = {
+            ## match stats
+              'MatchStatus' => Counter.new( MATCH_STATUS ),
+              'ResultType'  => Counter.new( RESULT_TYPE ),
+              'TimeDefined' => Hash.new(0),
+
+              'MatchDay'    => Hash.new(0),
+              'MatchNumber' => Hash.new(0),
+              'Leg'         => Hash.new(0),
+              'IsHomeMatch' => Hash.new(0),
+
+              'Attendance'  => Hash.new(0),
+              'Weather'     => Hash.new(0),
+
+              ## add stage & group
+              ##  add agg score and pen score!!
+
+
+            ## team stats
+           ##   'TeamType'     => Hash.new(0),
+           ##   'AgeType'      =>  Hash.new(0),
+           ##   'FootballType' => Hash.new(0),
+            }
+
+      stats
+end
+
+
+
+def collect_stats( data, stats: )
+
+    ## use results (match) array
+   data['Results'].each_with_index do |m, i|
+
+
+     ##
+     ## check usage
+     stats[ 'MatchStatus' ][m['MatchStatus']] +=1
+     stats[ 'ResultType'][m['ResultType']]    +=1
+
+     stats[ 'TimeDefined'][m['TimeDefined']] +=1
+
+
+     stats[ 'MatchDay'][!m['MatchDay'].nil?] +=1
+     stats[ 'MatchNumber'][!m['MatchNumber'].nil?] +=1
+
+     stats[ 'Leg'][m['Leg']] +=1
+     stats[ 'IsHomeMatch'][m['IsHomeMatch']] +=1
+
+     stats[ 'Attendance'][!m['MatchDay'].nil?] +=1
+     stats[ 'Weather'][!m['Weather'].nil?] +=1
+
+=begin
+    if m['Home']
+      stats[ 'TeamType'][m['Home']['TeamType']] +=1
+      stats[ 'AgeType'][m['Home']['AgeType']] +=1
+      stats[ 'FootballType'][m['Home']['FootballType']] +=1
+    end
+    if m['Away']
+      stats[ 'TeamType'][m['Away']['TeamType']] +=1
+      stats[ 'AgeType'][m['Away']['AgeType']] +=1
+      stats[ 'FootballType'][m['Away']['FootballType']] +=1
+    end
+=end
+
+   end
+
+   stats
+end

data/lib/fifadat/prepare.rb

@@ -22,6 +22,9 @@ def prepare( name:,
     fetch_json_if( Fifa::Metal.matches_url( idSeason: idSeason ),
                 "#{outdir}/#{name}/#{season.to_path}_matches.json", force: force )
 
+    fetch_json_if( Fifa::Metal.teams_url( idSeason: idSeason ),
+               "#{outdir}/#{name}/misc/#{season.to_path}_teams.json", force: force )
+
     fetch_json_if( Fifa::Metal.stages_url( idSeason: idSeason ),
                "#{outdir}/#{name}/misc/#{season.to_path}_stages.json", force: force )
 
@@ -45,7 +48,8 @@ def prepare_reports( name:,
      matches = data['Results']
 
 
-    puts "  #{matches.size} match(es) in season #{season}"
+    puts "==> prepare reports - #{matches.size} match(es) in #{name} #{season}"
+
 
 
     matches.each_with_index do |m, i|
@@ -54,8 +58,6 @@ def prepare_reports( name:,
       idStage       = m['IdStage']
       idMatch       = m['IdMatch']
 
-      stageName   = desc( m['StageName'] )
-
 
       ## note - skip if teams not yet know
       ##  e.g. Home & Away is null
@@ -66,14 +68,34 @@ def prepare_reports( name:,
       ##  e.g. MatchStatus = 1  -- future
       ##       ResultType  = 0  -- not played yet
 
+    ##      if not yet played!!!
+   #         1-scheduled and
+   #         2-live
+   #         7-postponed !!!! (too)
+   #    return empty score!!!
+      if m['MatchStatus'] == 1 ||
+         m['MatchStatus'] == 2 ||
+         m['MatchStatus'] == 7
+           ## skip scheduled/live matches (not yet played)
+           next
+      end
+
+
+
+
       if m['Home'].nil? || m['Away'].nil?
          puts "[#{i+1}/#{matches.size}]  ??  ??, #{stageName}  (SKIPPED - TO BE DONE)"
          next
       end
 
 
-      dateTime       = parse_date( m['Date'] )    ## utc
-      localDateTime  = parse_date( m['LocalDate'] )
+      ### note - date is always utc without timezone even if local!!
+      ##         local is utc (plus/minus offset)!!!
+      ##  e.g.
+      ##     "Date":      "2026-08-02T15:00:00Z",
+      ##     "LocalDate": "2026-08-02T17:00:00Z",
+      dateTime       = parse_date_utc( m['Date'] )         ## utc
+      localDateTime  = parse_date_utc( m['LocalDate'] )
 
 
       ## pp m['Home']
@@ -84,8 +106,21 @@ def prepare_reports( name:,
       teamName2   = desc( m['Away']['TeamName'] )
       teamCode2   = m['Away']['Abbreviation']
 
+      stageName   = desc( m['StageName'] )
+      ##  "MatchDay": null,
+      matchday    = m['MatchDay'] || '∅'
+      groupName   = desc( m['GroupName'] )
+
+      print "[#{i+1}/#{matches.size}]  "
+      print   MATCH_STATUS[m['MatchStatus']]||"???-#{m['MatchStatus']}"
+      print  "/"
+      print   RESULT_TYPE[m['ResultType']]||"???-#{m['ResultType']}"
+      print "  #{teamName1} (#{teamCode1}) v #{teamName2} (#{teamCode2})"
+      print " | #{stageName} - #{matchday}"
+      print ", #{groupName}"     if groupName
+      print " | #{localDateTime}"
+      print "\n"
 
-      puts "[#{i+1}/#{matches.size}]  #{teamName1} #{teamName2}, #{stageName}, #{localDateTime}"
 
 
       outpath = "#{outdir}/#{name}/matches/#{season.to_path}/#{localDateTime.strftime('%Y-%m-%d')}_#{teamCode1}-#{teamCode2}__#{idMatch}.json"
@@ -93,7 +128,7 @@ def prepare_reports( name:,
       url = Fifa::Metal.live_url( idCompetition: idCompetition,
                                   idSeason:      idSeason,
                                   idStage:       idStage,
-                                 idMatch:       idMatch )
+                                  idMatch:       idMatch )
 
       fetch_json_if( url, outpath, force: force )
 
@@ -101,15 +136,16 @@ def prepare_reports( name:,
       ###
       ##   add timeline (only)  if score incl. penalty shoot-out
       resultType = m['ResultType']
-      if resultType == 2 ## (aet??) win on pens
+      if resultType == 2      ## WIN_ON_PENS
 
         ## download timeline
         outpath = "#{outdir}/#{name}/timelines/#{season.to_path}/#{localDateTime.strftime('%Y-%m-%d')}_#{teamCode1}-#{teamCode2}__#{idMatch}.json"
 
-        url = Fifa::Metal.timeline_url( idCompetition: idCompetition,
-                                idSeason:      idSeason,
-                                idStage:       idStage,
-                                idMatch:       idMatch )
+#        url = Fifa::Metal.timeline_url( idCompetition: idCompetition,
+#                                idSeason:      idSeason,
+#                                idStage:       idStage,
+#                                idMatch:       idMatch )
+        url = Fifa::Metal.timeline_url( idMatch:idMatch )
 
        fetch_json_if( url, outpath, force: force )
     end

data/lib/fifadat/types.rb

@@ -0,0 +1,202 @@
+
+##
+## help - yes, you can.
+##    if you have any more info about the fifa types,
+##    please tell and help fill-in the details.
+
+
+
+MATCH_STATUS = {
+  0 => 'END',     # finished
+  1 => 'SCHEDULED',   # scheduled  (with or without time - see timed flag)
+  2 => 'LIVE',
+
+  ## ???
+
+  7 => 'POSTPONED',  # postponed  - use PPD ??
+
+  9 => 'AWD',    #  awarded !!!
+                 #    check if 9/0   is possibly cancelled/annulled/walkover (if no score)
+                 #             9/12 (AWD 3-0 or such)
+
+}
+
+
+##
+## "MatchStatus"=>9,  cancelled!!!!
+##
+##  "ResultType"=>12,
+##  21:30  CD Independiente Medellín (COL) v CR Flamengo (BRA)        [cancelled]
+##
+
+##
+## Result: Al Duhail awarded a 3–0 walkover victory.
+## Reason: Auckland City FC withdrew from the tournament
+## due to strict COVID-19 pandemic quarantine and isolation measures
+##  enforced by New Zealand authorities.
+
+##
+## check 2  is only win on pens!!!
+##   might be WITHOUT extra time e.g. copa liber.
+##  [28/142]  0-FIN    3rd Round   Sporting Cristal | SCL (PER) v Carabobo FC | CRB (VEN)
+##                 (2-AET_WIN_ON_PENS)  score: [1, 2] pen: [3, 2] agg: [2, 2]
+##   and others!!!
+##
+##   how to check if  extra time was played?? (use period??)
+
+  # 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
+
+
+
+RESULT_TYPE = {
+  0 => 'NO',
+  1 => 'REGULAR',
+  ## note - cannot tell if
+  ##          win on penalties
+  ##    is  after extra-time!!!
+  ##      used many times in copa libertadores
+  ##       check gold cup too
+  ##   change to WIN_ON_PENS only - why? why not?
+  2 => 'WIN_ON_PENS',    ## AET_WIN_ON_PENS or REG_WIN_ON_PENS or AGG_WIN_ON_PENS !!!!!!
+  3 => 'AET',
+  ##
+  ## note - agg - used for 1st & 2nd leg
+  4 => 'REGULAR/AGG',  ##  aggregate (1st/2nd leg) - regular
+  5 => 'AET/AGG',      ##   aggregate  - after extra-time
+  ## e.g.
+  ## 2nd Leg Feb 25, 2026 Juventus 3–2 (AET) Galatasaray
+  ##
+  8 => 'AET/GG',   ## after extra-time/golden goal !!!
+
+  12 => 'AWD',  ## AWARDED  or ???
+}
+
+
+GOAL_TYPE = {
+     1 => 'PENALTY',
+     2 => 'REGULAR',
+     3 => 'OWN_GOAL',
+}
+
+
+## use PERIOD only - why? why not?
+PERIOD_TYPE = {
+  3   => '1ST_HALF',            ##   "MatchMinute": "0'",  "1'",  "45'+2'",
+  4   => 'HALF',                ##   "MatchMinute": "46'", "90'+2'",
+  5   => '2ND_HALF',            ##  "MatchMinute": "91'",  "105'+2'",
+  6   => 'EXTRA_TIME',          ## or end of regular time??
+  7   => 'EXTRA_TIME_1ST_HALF', ##   "MatchMinute": "106'", "120'+2'",
+  8   => 'EXTRA_TIME_HALF',
+  9   => 'EXTRA_TIME_2ND_HALF',
+  10  => 'END',                 ## or use MATCH_END ???
+                                ## (generic incl. optional extra time and/or penalty shootout)
+  11  => 'PENALTY_SHOOTOUT',    ##   "MatchMinute": "120'",  "121'",  "122'",  "123'",
+                                ##     "MatchMinute": "127'", "130'",
+}
+
+=begin
+"MatchMinute": "1'",
+    "Period": 0,  !!!!
+ "MatchMinute": "91'",
+   "Period": 0,   !!!
+=end
+
+
+EVENT_TYPE = {
+  0  => 'Goal!',          ## e.g.  DI MARÍA (Argentina) scores!!
+  1  =>  'Assist',        ## e.g. Assisted by MAC ALLISTER.
+  2  => 'Yellow card',      ## e.g. FERNÁNDEZ (Argentina) is booked by the referee.
+  3  =>  'Red card',         ## e.g. Zinedine ZIDANE (France) is sent off
+
+  5 =>  'Substitution',    ## e.g. ACUÑA (in) comes off the bench to replace DI MARÍA (out) (Argentina)
+  6 => 'Penalty Awarded',
+  7 =>  'Start Time',      ## e.g. The referee signals the start of the first period.
+  8 =>  'End Time',        ## e.g. 'The referee brings the first period to an end.
+
+  12 => 'Attempt at Goal',
+
+  15 => 'Offside',
+  16 => 'Corner',
+  18 => 'Foul',
+  19 =>  'Coin Toss',
+
+  23 => 'Dropped Ball',
+  24 => 'Throw In',
+  25 => 'Clearance',
+  26 => 'Match end',
+  27 => 'Aerial Duel',
+
+  41 => 'Penalty Goal',
+  46 => 'Penalty missed',  ## David TREZEGUET (France) 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.
+  65 => 'Penalty missed',  ## TCHOUAMENI (France) misses from the penalty spot!
+                           ## Michel PLATINI (France) misses from the penalty spot!
+
+}
+
+
+
+__END__
+
+
+
+ TeamType
+            0 => club
+            1 => nati(onal) team
+ AgeType
+    0 =>  ??
+    1 =>   U17     U-17 World Cup / U17 National Team Friendlies
+                    MLS Generation Cup U17
+    2 =>   U18     U18 National Team Friendlies
+                       U18 Premier League Cup
+    3 =>   U19     U19 Championship Qualification
+    4 =>   U20     U-20 World Cup / CONMEBOL U20
+
+    5 =>  ??        Olympic Football Tournament / Olympics Intercontinental Play-offs /
+                    AFC U23 Asian Cup
+
+   10 =>   U15     U15 National Team Friendlies
+                   MLS Generation Cup U15
+   11 =>   U16     U16 National Team Friendlies
+   12 =>   U21     U21 Championship / Tournoi Maurice Revello /
+                      U21 National Team Friendlies
+                      Premier League 2
+
+   14 =>   ?? U23     U23 National Team Friendlies /  Asian Games
+
+ FootballType
+            0 => "classic"
+            1 =>  Futsal
+            2 => Beach Soccer
+  Gender
+            1 => m
+            2 => f
+
+
+note - matchStatus  for 12-AWD should also be 9-AWD!!!
+
+resultType 12
+  The Clausura 2022 match between Querétaro and Atlas on March 5, 2022,
+  was officially suspended in the 62nd minute
+   and later recorded as a 3–0 victory for Atlas
+       : Atlas was leading 1–0 at the time of suspension.
+           Forfeit Victory: Atlas was officially awarded a 3–0 walkover win.
+
+
+             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
+
+              4 =>    aggregate  leg 1/2 ?? e.g.
+                    "AggregateHomeTeamScore": 2,
+                    "AggregateAwayTeamScore": 4,
+=end

data/lib/fifadat/version.rb

@@ -2,7 +2,7 @@
 module Fifadat    ## use FifaApi or such - why? why not
   MAJOR = 2026    ## todo: namespace inside version or something - why? why not??
   MINOR = 9
-  PATCH = 23
+  PATCH = 30
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/lib/fifadat.rb

@@ -18,8 +18,11 @@ require_relative 'fifadat/json'    ## read_json_v2, fetch_json, fetch_json_if, e
 ##  our own code
 require_relative 'fifadat/version'
 
-require_relative 'fifadat/config'  ## base
-require_relative 'fifadat/api'  ## base
+require_relative 'fifadat/helper'
+require_relative 'fifadat/config'
+require_relative 'fifadat/api'
+require_relative 'fifadat/types'
+
 require_relative 'fifadat/prepare'   ## "all-in-one" prepare (download cache) helpers etc.
 
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fifadat
 version: !ruby/object:Gem::Version
-  version: 2026.9.23
+  version: 2026.9.30
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-09-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cocos
@@ -160,8 +160,13 @@ files:
 - lib/fifadat.rb
 - lib/fifadat/api.rb
 - lib/fifadat/config.rb
+- lib/fifadat/helper.rb
 - lib/fifadat/json.rb
+- lib/fifadat/pp/ppdebug.rb
+- lib/fifadat/pp/ppmatch.rb
+- lib/fifadat/pp/ppstats.rb
 - lib/fifadat/prepare.rb
+- lib/fifadat/types.rb
 - lib/fifadat/version.rb
 homepage: https://github.com/sportdb/sport.db
 licenses: