openliga 0.0.1

data/lib/openliga/convert-score.rb

@@ -0,0 +1,172 @@
+module Openliga
+
+
+
+def self.build_score( h )
+   ht  = nil
+   ft  = nil
+   et  = nil
+   pen = nil
+
+   maybe_ft = nil
+   maybe_et = nil
+
+   h.each do |result|
+       ## note - assume extra time for both options now
+       ##   assert ft is nil - why? why not?
+
+     ### resultName check - why? why not?
+     ###    are legacy or not?
+
+        ###
+        ##  todo - check copa america
+        ##            if extra time excluded on penalties???
+
+        case result['resultTypeKind']
+        when  'HalfTime'
+          ## result['resultName'] == 'Halbzeitergebnis' ||
+          ## result['resultName'] == 'Halbzeit'
+            ## desc = >Ergebnis nach Ende der ersten Halbzeit
+            ht = [
+                result['pointsTeam1'],
+                result['pointsTeam2'],
+           ]
+        ##
+        ##  note if resultName is Endergebnis this might actually
+        ##   be   after penalty shootout or extra time!!!
+        ##    check if      "resultName": "nach 90 Minuten"
+        ##    is present too!!
+        when 'After90Minutes'
+          ##    result['resultName'] == 'Endergebnis' ##  ||
+          ##  result['resultName'] == 'nach Nachspielzeit'   ## !!!!
+          ## desc => Ergebnis nach Ende der offiziellen Spielzeit
+         ft = [
+              result['pointsTeam1'],
+              result['pointsTeam2'],
+         ]
+        when 'AfterExtraTime'
+           ##   result['resultName'] == 'Verlängerung' ||
+           ##   result['resultName'] == 'nach Verlängerung'
+           ## desc: Ergebnis nach Verlängerung
+           et = [
+            result['pointsTeam1'],
+            result['pointsTeam2'],
+           ]
+        when 'AfterPenalties'
+            ##   result['resultName'] == 'Elfmeterschießen'  ||
+            ##   result['resultName'] == 'nach Elfmeterschießen'
+           ## desc: Ergebnis nach Elfmeterschießen
+            pen = [
+                result['pointsTeam1'],
+                result['pointsTeam2'],
+           ]
+        when 'Unknown'
+          ### note:
+          ##   for now resultName: "nach 90 Minutes"  overwrites
+          ##          first After90Minutes!!! (assuming this is kind of Endergebnis really incl. extra-time or penalty shootout)
+          if result['resultName'] == 'nach 90 Minuten'
+            puts "!! warn - weirdo Unknown/nach 90 Minuten result found"
+            ft = [
+              result['pointsTeam1'],
+              result['pointsTeam2'],
+            ]
+          elsif result['resultName'] == 'Endergebnis'
+            puts "!! warn - weirdo Unknown/Endergebnis result found"
+            maybe_ft = [
+              result['pointsTeam1'],
+              result['pointsTeam2'],
+            ]
+          elsif result['resultName'] == 'Nachspielzeit'
+            puts "!! warn - weirdo Unknown/Nachspielzeit result found"
+            maybe_et = [
+              result['pointsTeam1'],
+              result['pointsTeam2'],
+            ]
+          else
+            puts "!! ERROR - unknown <Unknown> result type:"
+            pp result
+            exit 1
+          end
+        else
+            puts "!! ERROR - unknown result type:"
+            pp result
+            exit 1
+        end
+   end
+
+## note -   DFB Pokal 2025/2026
+###   requires hack
+##       if     Nachspielzeit  (et) present
+##      only accept if different from ft  or pen is present!!!
+
+    if maybe_et
+      if pen || maybe_et != ft
+        et = maybe_et
+      else
+         puts "!! WARN - ignoring et (Unknown/Nachspielzeit) result in:"
+         pp h
+      end
+    end
+
+    if maybe_ft
+       if ft.nil?
+          ft = maybe_ft
+       else
+         puts "!! WARN - ignoring ft (Unknown/Endergebnis) result in:"
+         pp h
+       end
+    end
+
+   Score.new( ht: ht, ft: ft, et: et, pen: pen )
+end
+
+
+end  ## module Openliga
+
+
+
+=begin
+   "matchResults": [
+      {
+        "resultID": 110926,
+        "resultName": "Halbzeitergebnis",
+        "pointsTeam1": 3,
+        "pointsTeam2": 0,
+        "resultOrderID": 1,
+        "resultTypeID": 1,
+        "resultDescription": "Ergebnis zur Halbzeitpause"
+      },
+      {
+        "resultID": 110927,
+        "resultName": "Endergebnis",
+        "pointsTeam1": 5,
+        "pointsTeam2": 1,
+        "resultOrderID": 2,
+        "resultTypeID": 2,
+        "resultDescription": "Ergebnis nach Ende der offiziellen Spielzeit"
+      }
+
+{"resultID"=>127243,
+ "resultName"=>"Halbzeit",
+ "pointsTeam1"=>0,
+ "pointsTeam2"=>10,
+ "resultOrderID"=>1,
+ "resultTypeID"=>1,
+ "resultTypeKind"=>"HalfTime",
+ "resultDescription"=>"Ergebnis nach Ende der ersten Halbzeit"}
+
+
+or
+!! ERROR - unknown result type:
+{"resultID"=>118424,
+ "resultName"=>"Nachspielzeit",
+ "pointsTeam1"=>1,
+ "pointsTeam2"=>2,
+ "resultOrderID"=>3,
+ "resultTypeID"=>3,
+ "resultTypeKind"=>"Unknown",
+ "resultDescription"=>"Ergebnis nach Nachspielzeit"}
+
+
+  DFB Pokal 2025/2026
+=end

data/lib/openliga/convert.rb

@@ -0,0 +1,68 @@
+module Openliga
+
+def self.convert( league:, season: )
+
+    season = Season( season )   ## cast (ensure) season class (NOT string, integer, etc.)
+
+
+    info = (LEAGUES[ league.downcase ]||{})[ season.to_key ]
+    if info.nil?
+       puts "!! ERROR - no openliga info found for #{league} #{season}"
+       exit 1
+    end
+    pp info
+
+
+    data           = Webcache.read_json( Metal.matches_url( info.shortcut, info.season ))
+    puts "  #{data.size} match(es)"
+
+    ## data_teams     = Webcache.read_json( Metal.teams_url(   LEAGUES[league.downcase], season.start_year ))
+    ## puts "  #{data_teams.size} team(s)"
+
+
+    body = _convert( data )
+
+###
+###  auto-add header
+  header =<<TXT
+###
+#  converted from openligadb.de json to Football.TXT
+#    for source, see https://api.openligadb.de/getmatchdata/#{info.shortcut}/#{info.season}
+
+= #{info.name}
+
+TXT
+
+  header + body
+end
+
+
+
+def self._convert( data )
+
+  recs = []
+
+  matches = data
+  matches.each do |h|
+      m =  build_match( h )
+
+      ## note - if match is broken e.g. has no team1 or team2
+      ##          than skip for now
+
+      if m.team1.nil? || m.team2.nil?
+         puts "!! warn - skipping match with team missing:"
+         pp h
+      else
+        recs << m
+      end
+  end
+
+  ## pp recs
+
+  pp_matches( recs )
+end  # method self._convert
+
+
+
+
+end # module Openliga

data/lib/openliga/convert_helpers.rb

@@ -0,0 +1,73 @@
+module Openliga
+
+
+def self._clean( str )
+  ## note - accept nil
+  ##   turn blank strings e.g "" or "  " into nil
+  ##    remove leading and trailing spaces
+   return nil if str.nil?
+
+    str = str.strip
+    if str.empty?
+       nil
+    else
+      str
+    end
+end
+
+=begin
+@ Sportpark Ronhof | Thomas Sommer, Fürth
+@ Sportforum "Sojus 31", Zwickau
+@ "Allianz Arena, München
+
+  or add into protected_name token - why? why not?
+e.g.
+@ ‹Sportpark Ronhof | Thomas Sommer›, Fürth
+@ ‹Sportforum "Sojus 31"›, Zwickau
+@ ‹"Allianz Arena›, München       -- really better FIX typo
+=end
+
+def self._clean_geo( str )
+   return nil if str.nil?
+
+   str = str.gsub( %r{["|]}, '' )       ## remove "|
+   str = str.gsub( %r{[ ]{2,}}, ' ' )   ## squish spaces (maybe move "upstream" to clean)
+
+   _clean( str )
+end
+
+
+def self._clean_name( str ) ## player name
+  ## e.g.
+  ##  Poulsen, Yussuf   =>  Poulsen Yussuf
+  ##  Günther-Schmidt, Julian
+  ##  Hercher, Philipp
+  ##    maybe auto-turn around later - why? why not?
+  ##
+  ##  E. N‘Dicka   =>   E. N'Dicka
+
+
+   return nil if str.nil?
+
+   ## move asciify "upstream" - why? why not?
+   str = str.gsub( /[‘]/, "'" )   ## asciify "smart/unicode" quotes
+
+
+   ## str = str.gsub( /[,]/, '' )       ## remove ","  -- todo - add a warn(ing) on replace
+   ## tr = str.sub(  'Poulsen, Yussuf', 'Yussuf Poulsen' )
+   ##
+   ##  turn "Poulsen, Yussuf" into "Yussuf Poulsen"
+   if str.include?(',')
+       last_name, first_name = str.split( ',', 2 )
+       str   = "#{first_name} #{last_name}"
+   end
+
+
+   str = str.gsub( /[ ]{2,}/, ' ' )   ## squish spaces (maybe move "upstream" to clean)
+
+   _clean( str )
+end
+
+
+
+end   ## module Openliga

data/lib/openliga/download.rb

@@ -0,0 +1,81 @@
+module Openliga
+
+
+def self.download( league:, season: )
+
+    season = Season( season )   ## cast (ensure) season class (NOT string, integer, etc.)
+
+    info = (LEAGUES[ league.downcase ]||{})[ season.to_key ]
+    if info.nil?
+       puts "!! ERROR - no openliga info found for #{league} #{season}"
+       exit 1
+    end
+    pp info
+
+
+    Metal.matches( info.shortcut, info.season )
+    Metal.teams(   info.shortcut, info.season )
+
+    true   ## return true on success (instead of latest response json data/payload)
+end
+
+
+##################
+##  plumbing metal "helpers"
+
+class Metal
+
+  BASE_URL = 'https://api.openligadb.de'
+
+
+  ### api call - /getavailableleagues
+  def self.leagues
+    get( "#{BASE_URL}/getavailableleagues" )
+  end
+
+  ## api call - /getavailableteams/{code}/{year}
+  def self.teams( code, year )
+    get( teams_url( code, year ) )
+  end
+  def self.teams_url( code, year )
+    "#{BASE_URL}/getavailableteams/#{code}/#{year}"
+  end
+
+  ## api call - /getmatchdata/{code}/{year}
+  def self.matches( code, year )
+    get( matches_url( code, year ) )
+  end
+  def self.matches_url( code, year )
+    "#{BASE_URL}/getmatchdata/#{code}/#{year}"
+  end
+
+  ## api call - /getgoalgetters/{code}/{year}
+  def self.goalgetters( code, year )
+    get( "#{BASE_URL}/getgoalgetters/#{code}/#{year}" )
+  end
+
+
+
+
+
+
+  def self.get( url )
+    headers = {}
+    headers['User-Agent']   = 'ruby'
+    headers['Accept']       = '*/*'
+
+    ## note: add format: 'json' for pretty printing json (before) save in cache
+    response = Webget.call( url, headers: headers )
+
+    exit 1  if response.status.nok?   # e.g. HTTP status code != 200
+
+
+    data = response.json
+    ## for debugging print pretty printed json first 400 chars
+    puts data.pretty_inspect[0..400]
+
+
+    data     ## note - return json data response (on success)
+  end
+end  # class Metal
+end # module Footballdata

data/lib/openliga/leagues.rb

@@ -0,0 +1,45 @@
+module Openliga
+
+
+  def self.config_dir()  "#{File.dirname(File.dirname(__dir__))}/config";  end
+
+
+  ## code, season,  league_name, league_season, league_shortcut
+  ##
+  ##  "leagueName": "Champions League 2026/2027",
+  ##  "leagueShortcut": "ucl",
+  ##  "leagueSeason": 2026,
+  ##
+  ## from https://api.openligadb.de
+  ##   Name	Description
+  ##  leagueShortcut  - string - der Shortcut der Liga, z.B. 'bl1' für die erste Bundesliga
+  ##  leagueSeason  - integer($int32) - die Saison der Liga, z.B. 2019 für die Saison 2019/2020
+
+
+
+
+
+  League = Struct.new( :name, :season, :shortcut)
+
+
+  LEAGUES = begin
+    leagues = {}
+    ['leagues_de.csv',
+     'leagues_more.csv'].each do |name|
+       path = "#{config_dir}/#{name}"
+       rows = read_csv( path )
+       ## pp rows
+       rows.each do |row|
+          seasons = leagues[row['code']] ||= {}
+          ## note - normalize season!!
+          season = Season.parse( row['season'] )
+          seasons[ season.to_key ] = League.new( name:     row['league_name'],
+                                                 season:   row['league_season'].to_i(10),
+                                                 shortcut: row['league_shortcut'] )
+      end
+    end
+    leagues
+end
+
+
+end   #  module Openliga

data/lib/openliga/models.rb

@@ -0,0 +1,153 @@
+module Openliga
+
+
+Match = Struct.new( :team1,
+                    :team2,
+                    :date,    # assumes Date class
+                    :time,    # assumes String class (00:00)
+                    :timezone,   ## use tz ?
+             ###       :datetime_utc,
+                    :score,
+                    :goals,
+                    :round,    ## is stage/round/group
+                    :city,
+                    :ground,   ## use stadium (or venue?)
+                    :att,     ## attendance (numberOfViewers)
+                    :finished    ### todo/check - use status (is really only END or false)
+                  ) do
+end
+
+
+
+
+Goal = Struct.new(  :team,  ## expect 1|2 or nil
+                    :name,
+                    :score,   ## expect array e.g. [0,1]
+                    :m, :stoppage,
+                   :pen, :og,
+                   :comment ) do
+
+   def pen?()  @pen == true; end
+   def og?()   @og  == true; end
+
+
+   ## print goal as single line
+   ##   e.g.
+   ##    (0-1 Yorbe Vertessen 37'
+   ##     0-2 Yorbe Vertessen 48')
+
+   def calc_stoppage( m )
+      if    m >= 120  then   [120, m%120]
+      elsif m >= 105  then   [105, m%105]
+      elsif m >= 90   then   [90, m%90]
+      else                   [45, m%45]    ## assume 45
+      end
+   end
+
+
+
+   def to_s
+      buf = String.new
+
+      ## score required !!!
+      buf << "#{score[0]}-#{score[1]}  "  ## note - use double (two) space for now!!
+      buf <<  (name ? name : 'N.N.')      ## note - if no name use N.N. for now!!
+      if m
+         if stoppage
+            _m,_stoppage = calc_stoppage(m)
+            puts "!! INFO - auto-calc stoppage  #{m}+  =>  #{_m}+#{_stoppage}"
+            buf << " #{_m}+#{_stoppage}'"
+         else
+          buf << " #{m}'"
+         end
+      end
+
+      buf << " (og)"   if og
+      buf << " (p)"    if pen
+
+      buf
+   end
+
+end
+
+
+
+######
+##  todo/fix - reuse a "generic" score (and/or result) class
+
+class Score
+  ##
+  ## for generic add add reported (score) too
+  ##    use if score line undefined/unknown
+
+  attr_reader :ht, :ft, :et, :pen
+
+  def initialize( ht: [], ft:[], et: [], pen: [])
+    @ht, @ft, @et, @pen = ht, ft, et, pen
+
+    ##  ( ..., extra_time: nil)
+    ## extra_time flag - e.g.  copa america has penalty shootouts
+    ##                             BUT no extra time (only in final)
+    ##
+    ##  add a reg (90min) flag too -
+    ## @extra_time  = extra_time
+  end
+
+
+  def pen?()   @pen.is_a?( Array ) && @pen.size == 2; end
+  def et?()    @et.is_a?( Array ) && @et.size == 2; end
+  def ft?()    @ft.is_a?( Array ) && @ft.size == 2; end
+  def ht?()    @ht.is_a?( Array ) && @ht.size == 2; end
+
+
+  def pretty_print( q )
+      q.group(1, "<Score", ">") do
+         q.text( " ht: #{@ht}")  if ht?
+         q.text( " ft: #{@ft}")  if ft?
+         q.text( " et: #{@et}")  if et?
+         q.text( " pen: #{@pen}")  if pen?
+      end
+  end
+
+
+
+  def to_s
+    buf = String.new
+    if pen?
+        if et?
+          buf << "#{@et[0]}-#{@et[1]} aet"
+          if ft?
+            buf << " (#{@ft[0]}-#{@ft[1]}"
+            buf << ", #{@ht[0]}-#{@ht[1]}"  if ht?
+            buf << ")"
+          end
+        elsif ft?
+          ###  pen without et e.g. in copa
+          ##          use  2-2 (1-1), 5-3 pen. or such
+          buf << " "  unless buf.empty?
+          buf << "#{@ft[0]}-#{@ft[1]}"
+          buf << " (#{@ht[0]}-#{@ht[1]})"  if ht?
+        end
+        buf << ", "   unless buf.empty?
+        buf << "#{@pen[0]}-#{@pen[1]} pen"
+    elsif et?
+        buf << "#{@et[0]}-#{@et[1]} aet"
+        if ft?
+            buf << " (#{@ft[0]}-#{@ft[1]}"
+            buf << ", #{@ht[0]}-#{@ht[1]}"  if ht?
+            buf << ")"
+          end
+    elsif ft?
+       buf << "#{@ft[0]}-#{@ft[1]}"
+       buf << " (#{@ht[0]}-#{@ht[1]})"  if ht?
+    else
+       ## note - return empty string on no score for now
+    end
+
+    buf
+  end
+end  # class Score
+
+
+
+end ## module Openliga