footballdata-api 0.2.0

data/lib/footballdata/prettyprint.rb

@@ -0,0 +1,189 @@
+module Footballdata
+
+
+def self.assert( cond, msg )
+  if cond
+    # do nothing
+  else
+    puts "!!! assert failed - #{msg}"
+    exit 1
+  end
+end
+
+def self.fmt_competition( rec )
+   buf = String.new
+
+   buf << "==> "
+   buf << "#{rec['competition']['name']} (#{rec['competition']['code']}) -- "
+   buf << "#{rec['area']['name']} (#{rec['area']['code']}) "
+   buf << "#{rec['competition']['type']} "
+   buf << "#{rec['season']['startDate']} - #{rec['season']['endDate']} "  
+   buf << "@ #{rec['season']['currentMatchday']}"
+   buf << "\n"
+
+   buf
+end
+
+def self.fmt_match( rec )
+   buf = String.new
+ 
+    ## -- todo - make sure / assert it's always utc - how???
+    ## utc   = ## tz_utc.strptime( m['utcDate'], '%Y-%m-%dT%H:%M:%SZ' )
+    ##  note:  DateTime.strptime  is supposed to be unaware of timezones!!!
+    ##            use to parse utc
+    utc = DateTime.strptime( rec['utcDate'], '%Y-%m-%dT%H:%M:%SZ' ).to_time.utc 
+    assert( utc.strftime( '%Y-%m-%dT%H:%M:%SZ' ) == rec['utcDate'], 'utc time mismatch' )
+
+    status = rec['status']
+     assert( %w[SCHEDULED
+                TIMED
+                FINISHED
+                POSTPONED
+                IN_PLAY
+               ].include?( status ), "unknown status - #{status}" )
+
+     buf << '%-10s' % status
+     buf << utc.strftime( '%a %b %d %Y %H:%M')
+     buf << ' '
+     # pp rec['utcDate']
+
+     team1 = rec['homeTeam']['name'] ?
+                  "#{rec['homeTeam']['name']} (#{rec['homeTeam']['tla']})" : '?'
+     team2 = rec['awayTeam']['name'] ?
+                  "#{rec['awayTeam']['name']} (#{rec['awayTeam']['tla']})" : '?'     
+     buf << '%22s' % team1
+     buf << " - "
+     buf << '%-22s' % team2
+     buf << "   "
+
+     stage = rec['stage']
+     group = rec['group']
+     
+     buf << "#{rec['matchday']} - #{stage} "
+     buf << "/ #{group}  "  if group
+     buf << "\n"
+
+     buf << "  "
+     buf << '%-20s' % rec['score']['duration']
+     buf << ' '*24
+     
+     duration = rec['score']['duration']
+     assert( %w[REGULAR
+                EXTRA_TIME
+                PENALTY_SHOOTOUT
+               ].include?( duration ), "unknown duration - #{duration}" )
+
+     score = String.new 
+
+     if duration == 'PENALTY_SHOOTOUT'
+        if rec['score']['extraTime'] 
+          ## quick & dirty hack - calc et via regulartime+extratime 
+          score << "#{rec['score']['penalties']['home']}-#{rec['score']['penalties']['away']} pen. "
+          score << "#{rec['score']['regularTime']['home']+rec['score']['extraTime']['home']}"
+          score << "-"
+          score << "#{rec['score']['regularTime']['away']+rec['score']['extraTime']['away']}"
+          score << " a.e.t. "
+          score << "(#{rec['score']['regularTime']['home']}-#{rec['score']['regularTime']['away']},"
+          score << "#{rec['score']['halfTime']['home']}-#{rec['score']['halfTime']['away']})"
+        else  ### south american-style (no extra time)
+            ## quick & dirty hacke - calc ft via fullTime-penalties
+            score << "#{rec['score']['penalties']['home']}-#{rec['score']['penalties']['away']} pen. "
+            score << "(#{rec['score']['fullTime']['home']-rec['score']['penalties']['home']}"
+            score << "-"
+            score << "#{rec['score']['fullTime']['away']-rec['score']['penalties']['away']},"
+            score << "#{rec['score']['halfTime']['home']}-#{rec['score']['halfTime']['away']})"  
+        end
+     elsif  duration == 'EXTRA_TIME'
+          score << "#{rec['score']['regularTime']['home']+rec['score']['extraTime']['home']}"
+          score << "-"
+          score << "#{rec['score']['regularTime']['away']+rec['score']['extraTime']['away']}"
+          score << " a.e.t. "
+          score << "(#{rec['score']['regularTime']['home']}-#{rec['score']['regularTime']['away']},"
+          score << "#{rec['score']['halfTime']['home']}-#{rec['score']['halfTime']['away']})"          
+     elsif  duration == 'REGULAR'
+          if rec['score']['fullTime']['home'] && rec['score']['fullTime']['away']
+            score << "#{rec['score']['fullTime']['home']}-#{rec['score']['fullTime']['away']} "
+            score << "(#{rec['score']['halfTime']['home']}-#{rec['score']['halfTime']['away']})"
+          end          
+     else
+        raise ArgumentError, "unexpected/unknown score duration #{rec['score']['duration']}"
+     end
+ 
+
+     buf << score
+     buf << "\n"
+     buf
+end
+
+
+def self.pp_matches( data )
+
+  ## track match status and score duration  
+  stats = { 'status'    => Hash.new(0),
+            'duration'  => Hash.new(0),
+            'stage'     => Hash.new(0),
+            'group'     => Hash.new(0),
+           }
+
+  first = Date.strptime( data['resultSet']['first'], '%Y-%m-%d' ) 
+  last  = Date.strptime( data['resultSet']['last'], '%Y-%m-%d' )
+
+  diff = (last - first).to_i  # note - returns rational number (e.g. 30/1)
+
+
+  print "==> #{data['competition']['name']}, "
+  print "#{first.strftime('%a %b %d %Y')} - #{last.strftime('%a %b %d %Y')}"
+  print " (#{diff}d)"
+  print "\n"
+
+  data['matches'].each do |rec|
+
+    print fmt_match( rec )
+
+    ## track stats
+    status = rec['status']
+    stats['status'][status] += 1 
+
+    stage = rec['stage']
+    stats['stage'][stage] += 1  
+
+     group = rec['group']
+     stats['group'][group] += 1  if group 
+
+     duration = rec['score']['duration']
+     stats['duration'][duration] += 1       
+  end
+
+  print "   #{data['resultSet']['played']}/#{data['resultSet']['count']} matches"
+  print "\n"
+
+  print "     status (#{stats['status'].size}): "
+  print  fmt_count( stats['status'], sort: true )
+  print "\n"
+  print "     duration (#{stats['duration'].size}): "
+  print  fmt_count( stats['duration'], sort: true )
+  print "\n"
+  print "     stage (#{stats['stage'].size}): "
+  print   fmt_count( stats['stage'] )
+  print "\n"
+  print "     group (#{stats['group'].size}): "
+  print   fmt_count( stats['group'] )
+  print "\n"
+end
+
+
+def self.fmt_count( h, sort: false )
+    pairs = h.to_a
+    if sort
+        pairs = pairs.sort do |l,r|
+                               res = r[1] <=> l[1]  ## bigger number first
+                               res = l[0] <=> r[0] if res == 0
+                               res
+                            end
+    end
+    pairs = pairs.map { |name,count| "#{name} (#{count})" }
+    pairs.join( ' · ' )                                                                 
+end
+
+
+end   # module Footballdata

data/lib/footballdata/stat.rb

@@ -0,0 +1,59 @@
+module Footballdata
+
+class Stat      ## rename to match stat or something why? why not?
+  def initialize
+    @data = {}
+  end
+
+  def [](key) @data[ key ]; end
+
+  def update( match )
+     ## keep track of some statistics
+     stat = @data[:all] ||= { stage:    Hash.new( 0 ),
+                              duration: Hash.new( 0 ),
+                              status:   Hash.new( 0 ),
+                              group:    Hash.new( 0 ),
+                              matchday: Hash.new( 0 ),
+
+                              matches:  0,
+                              goals:    0,
+                            }
+
+     stat[:stage][ match['stage'] ]   += 1
+     stat[:group][ match['group'] ]  += 1
+     stat[:status][ match['status'] ]  += 1
+     stat[:matchday][ match['matchday'] ]  += 1
+
+     score = match['score']
+
+     stat[:duration][ score['duration'] ] += 1   ## track - assert always REGULAR
+
+     stat[:matches] += 1
+     stat[:goals]   += score['fullTime']['homeTeam'].to_i  if score['fullTime']['homeTeam']
+     stat[:goals]   += score['fullTime']['awayTeam'].to_i  if score['fullTime']['awayTeam']
+
+
+     stage_key = match['stage'].downcase.to_sym  # e.g. :regular_season
+     stat = @data[ stage_key ] ||= { duration: Hash.new( 0 ),
+                                     status:   Hash.new( 0 ),
+                                     group:    Hash.new( 0 ),
+                                     matchday: Hash.new( 0 ),
+
+                                     matches:  0,
+                                     goals:    0,
+                                  }
+     stat[:group][ match['group'] ]  += 1
+     stat[:status][ match['status'] ]  += 1
+     stat[:matchday][ match['matchday'] ]  += 1
+
+     stat[:duration][ score['duration'] ] += 1   ## track - assert always REGULAR
+
+     stat[:matches] += 1
+     stat[:goals]   += score['fullTime']['homeTeam'].to_i  if score['fullTime']['homeTeam']
+     stat[:goals]   += score['fullTime']['awayTeam'].to_i  if score['fullTime']['awayTeam']
+  end
+end  # class Stat
+end  # module Footballdata
+
+
+

data/lib/footballdata/teams.rb

@@ -0,0 +1,90 @@
+
+###########
+### export teams
+
+
+module Footballdata
+
+def self.export_teams( league:, season: )
+
+    season      = Season( season )   ## cast (ensure) season class (NOT string, integer, etc.)
+    league_code = LEAGUES[league.downcase]
+
+    teams_url = Metal.competition_teams_url( league_code, 
+                                             season.start_year )
+    data_teams = Webcache.read_json( teams_url )
+
+    ## build a (reverse) team lookup by name
+    puts "#{data_teams['teams'].size} teams"
+
+
+
+    clubs = {}   ## by country
+
+    data_teams['teams'].each do |rec|
+    
+        buf = String.new  ### use for string buffer (or String.new('') - why? why not?      
+        buf << "#{rec['name']}"
+        buf << ", #{rec['founded']}"  if rec['founded']
+        if rec['venue'] 
+          buf << ", @ #{rec['venue']}"   
+          # buf << "  # #{rec['area']['name']}"
+        end
+        buf << "\n"
+
+        alt_names = String.new
+        alt_names << " | #{rec['shortName']}"  if rec['shortName'] &&
+                                                  rec['shortName'] != rec['name'] &&
+                                                  rec['shortName'] != rec['tla']
+
+        alt_names << " | #{rec['tla']}"        if rec['tla'] &&
+                                                  rec['tla'] != rec['name']
+        
+        if alt_names.size > 0
+          buf << " "
+          buf << alt_names
+          buf << "\n"
+        end
+
+        ## clean null in address (or keep nulls) - why? why not?
+        ##  e.g. null Rionegro null
+        ##       Calle 104 No. 13a - 32 Bogotá null 
+
+        buf << "  address: #{rec['address'].gsub( /\bnull\b/, '')}"
+        buf << "\n"
+        buf << "  web:     #{rec['website']}"
+        buf << "\n"
+        buf << "  colors:  #{rec['clubColors']}"
+        buf << "\n"
+
+        country = rec['area']['name'] 
+        ary = clubs[ country] ||= []
+        ary << buf
+    end
+    # puts buf
+   
+    ## pp clubs
+
+  
+    buf = String.new
+
+    if clubs.size > 1
+      clubs.each do |country, ary|
+        buf << "#  #{country} - #{ary.size} clubs\n"
+      end  
+      buf << "\n"
+    end
+
+    clubs.each do |country, ary|
+      buf << "= #{country}    # #{ary.size} clubs\n\n"
+      buf << ary.join( "\n" )
+      buf << "\n\n"
+    end
+
+    path = "#{config.convert.out_dir}/#{season.to_path}/#{league.downcase}.clubs.txt"
+    write_text( path, buf )                            
+end
+
+
+end  # module Footballdata
+ 

data/lib/footballdata/version.rb

@@ -0,0 +1,20 @@
+
+module FootballdataApi
+  MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+  MINOR = 2
+  PATCH = 0
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "footballdata-api/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+end   # module FootballdataApi
+

data/lib/footballdata.rb

@@ -0,0 +1,56 @@
+## 3rd party (our own)
+require 'season/formats'   ## add season support
+require 'webget'           ## incl. webget, webcache, webclient, etc.
+
+
+require 'cocos'   ## check if webget incl. cocos ??
+
+
+require 'tzinfo'
+
+
+module Footballdata
+  class Configuration
+    #########
+    ## nested configuration classes - use - why? why not?
+    class Convert
+        def out_dir()       @out_dir || './o'; end
+        def out_dir=(value) @out_dir = value; end
+     end
+ 
+    def convert()  @convert ||= Convert.new; end
+  end # class Configuration
+
+  ## lets you use
+  ##   Footballdata.configure do |config|
+  ##      config.convert.out_dir = './o'
+  ##   end
+  def self.configure()  yield( config ); end
+  def self.config()  @config ||= Configuration.new;  end
+end   # module Footballdata
+
+
+
+
+###
+# our own code
+require_relative 'footballdata/version'
+require_relative 'footballdata/leagues'
+require_relative 'footballdata/download'
+require_relative 'footballdata/prettyprint'
+
+require_relative 'footballdata/mods'
+require_relative 'footballdata/convert'
+require_relative 'footballdata/teams'
+
+
+require_relative 'footballdata/generator'
+
+
+
+### for processing tool
+##   (auto-)add sportdb/writer  (pulls in sportdb/catalogs and gitti)
+##  require 'sportdb/writers'
+
+
+puts FootballdataApi.banner  ## say hello

metadata

@@ -0,0 +1,155 @@
+--- !ruby/object:Gem::Specification
+name: footballdata-api
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-07-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: season-formats
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webget
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cocos
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+description: footballdata-api - get football data via Daniel Freitag's football-data.org
+  api v4
+email: gerald.bauer@gmail.com
+executables:
+- fbdat
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- bin/fbdat
+- lib/footballdata.rb
+- lib/footballdata/convert.rb
+- lib/footballdata/download.rb
+- lib/footballdata/generator.rb
+- lib/footballdata/leagues.rb
+- lib/footballdata/mods.rb
+- lib/footballdata/prettyprint.rb
+- lib/footballdata/stat.rb
+- lib/footballdata/teams.rb
+- lib/footballdata/version.rb
+homepage: https://github.com/sportdb/sport.db
+licenses:
+- Public Domain
+metadata: {}
+post_install_message:
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: footballdata-api - get football data via Daniel Freitag's football-data.org
+  api v4
+test_files: []