sports 0.1.0 → 0.2.0

data/lib/sports/structs/matchlist.rb

@@ -1,215 +0,0 @@
-
-
-module Sports
-
-
-class Matchlist  ## todo: find a better name - MatchStats, MatchFixtures, MatchSchedule, ...
-                       ## use MatchCache/Buffer/Summary/Snippet/Segment/List...
-                       ##    or MatchAnalyzer/Checker/Proofer/Query - why? why not?
-  attr_reader :matches    # count of matches
-              ## :name,
-              ## :goals,     # count of (total) goals - use total_goals - why? why not?
-              ## :teams, -- has its own reader
-              ## :rounds     # note: use if all teams have same match count
- ## add last_updated/updated or something - why? why not?
-
-  def initialize( matches )
-    @matches = matches
-  end
-
-
-  def usage
-    @usage ||= build_usage( @matches )
-    @usage
-  end
-
-  def team_usage() usage.team_usage; end
-
-  def teams
-    @team_names ||= team_usage.keys.sort
-    @team_names
-  end
-
-  def goals() usage.goals; end
-
-  ## note: start_date and end_date might be nil / optional missing!!!!
-  def start_date?() usage.start_date?; end
-  def end_date?()   usage.end_date?; end
-
-  def start_date()  usage.start_date; end
-  def end_date()    usage.end_date; end
-
-  def has_dates?()  usage.has_dates?; end
-  def dates_str()   usage.dates_str; end
-  def days()        usage.days; end
-
-
-  def rounds() usage.rounds; end
-
-  ## todo: add has_rounds? alias for rounds? too
-  ## return true if all match_played in team_usage are the same
-  ##  e.g. assumes league with matchday rounds
-  def rounds?() usage.rounds?; end
-
-  def match_counts() usage.match_counts; end
-  def match_counts_str() usage.match_counts_str; end
-
-
-
-  def stage_usage
-    @stage_usage ||= build_stage_usage( @matches )
-    @stage_usage
-  end
-
-  def stages() stage_usage.keys; end  ## note: returns empty array for stages for now - why? why not?
-
-
-############################
-#  matchlist helpers
-private
-  class StatLine
-     attr_reader :team_usage,
-                 :matches,
-                 :goals,
-                 :rounds,   ## keep rounds - why? why not?
-                 :start_date,
-                 :end_date
-
-     def teams() @team_usage.keys.sort; end   ## (auto-)sort here always - why? why not?
-
-     def start_date?() @start_date.nil? == false; end
-     def end_date?()   @end_date.nil? == false; end
-
-     def has_dates?()  @start_date && @end_date; end
-     def dates_str
-       ## note: start_date/end_date might be optional/missing
-       if has_dates?
-         "#{start_date.strftime( '%a %d %b %Y' )} - #{end_date.strftime( '%a %d %b %Y' )}"
-       else
-         "??? - ???"
-       end
-     end
-
-    def days() end_date.jd - start_date.jd; end
-
-
-    def rounds
-      rounds?   ## note: use rounds? to calculate (cache) rounds
-      @rounds   ## note: return number of rounds or nil (for uneven matches played by teams)
-    end
-
-    ## todo: add has_rounds? alias for rounds? too
-    def rounds?
-       ## return true if all match_played in team_usage are the same
-       ##  e.g. assumes league with matchday rounds
-       if @has_rounds.nil?    ## check/todo: if undefined attribute is nil by default??
-          ## check/calc rounds
-          ##  note: values => matches_played by team
-          if match_counts.size == 1
-            @rounds = match_counts[0][0]
-          else
-            @rounds = nil
-          end
-          @has_rounds = @rounds ? true : false
-       end
-       @has_rounds
-    end
-
-
-    def build_match_counts   ## use/rename to matches_played - why? why not?
-      counts = Hash.new(0)
-      team_usage.values.each do |count|
-        counts[count] += 1
-      end
-
-      ## sort (descending) highest usage value first (in returned array)
-      ##  e.g. [[32,8],[31,2]]  ## 32 matches by 8 teams, 31 matches by 2 teams etc.
-      counts.sort_by {|count, usage| -count }
-    end
-
-    def match_counts
-      # match counts / nos played per team
-      @match_counts ||= build_match_counts
-      @match_counts
-    end
-
-    def match_counts_str
-      ## pretty print / formatted match_counts
-      buf = String.new('')
-      match_counts.each_with_index do |rec,i|
-        buf << ' '  if i > 0   ## add (space) separator
-        buf << "#{rec[0]}×#{rec[1]}"
-      end
-      buf
-    end
-
-
-
-     def initialize
-        @matches    = 0
-        @goals      = 0
-
-        @start_date = nil
-        @end_date   = nil
-
-        @team_usage = Hash.new(0)
-
-        @match_counts = nil
-     end
-
-
-     def update( match )
-        @matches += 1    ## match counter
-
-        if match.score1 && match.score2
-          @goals += match.score1
-          @goals += match.score2
-
-          ## todo: add after extra time? if knock out (k.o.) - why? why not?
-          ##   make it a flag/opt?
-        end
-
-        @team_usage[ match.team1 ] += 1
-        @team_usage[ match.team2 ] += 1
-
-        if match.date
-          ## return / store date as string as is - why? why not?
-          date = Date.strptime( match.date, '%Y-%m-%d' )
-
-          @start_date = date  if @start_date.nil? || date < @start_date
-          @end_date   = date  if @end_date.nil?   || date > @end_date
-        end
-     end
-  end  # class StatLine
-
-
-  ## collect total usage stats (for all matches)
-  def build_usage( matches )
-    stat = StatLine.new
-    matches.each do |match|
-      stat.update( match )
-    end
-    stat
-  end
-
-  ## collect usage stats by stage (e.g. regular / playoff / etc.)
-  def build_stage_usage( matches )
-    stages = {}
-
-    matches.each do |match|
-       stage_key = if match.stage.nil?
-                     'Regular'  ## note: assume Regular stage if not defined (AND not explicit unknown)
-                   else
-                     match.stage
-                   end
-
-        stages[ stage_key ] ||= StatLine.new
-        stages[ stage_key ].update( match )
-    end
-
-    stages
-  end
-
-end  # class Matchlist
-
-end # module Sports

data/lib/sports/structs/round.rb

@@ -1,23 +0,0 @@
-module Sports
-
-  class Round
-      attr_reader   :name, :start_date, :end_date, :knockout
-      attr_accessor :num   # note: make read & writable - why? why not?
-
-      def initialize( name:,
-                      num: nil,
-                      start_date: nil,
-                      end_date: nil,
-                      knockout: false,
-                      auto: true )
-        @name       = name
-        @num        = num
-        @start_date = start_date
-        @end_date   = end_date
-        @knockout   = knockout
-        @auto       = auto        # auto-created (inline reference/header without proper definition before)
-      end
-  end  # class Round
-
-end # module Sports
-

data/lib/sports/structs/standings.rb

@@ -1,271 +0,0 @@
-##########
-# todo/fix:
-##   reuse standings helper/calculator from sportdb
-##   do NOT duplicate
-
-
-module Sports
-
-
-class Standings
-
-  class StandingsLine     ## nested class StandinsLine - todo/fix: change to Line - why? why not?
-    attr_accessor  :rank, :team,
-                   :played, :won, :lost, :drawn,                      ## -- total
-                   :goals_for, :goals_against, :pts,
-                   :home_played, :home_won, :home_lost, :home_drawn,  ## -- home
-                   :home_goals_for, :home_goals_against, :home_pts,
-                   :away_played, :away_won, :away_lost, :away_drawn,  ## -- away
-                   :away_goals_for, :away_goals_against, :away_pts
-
-     alias_method :team_name, :team     ## note: team for now always a string
-     alias_method :pos,       :rank     ##  rename back to use pos instead of rank - why? why not?
-
-
-    def initialize( team )
-      @rank = nil # use 0? why? why not?
-      ## change rank back to pos - why? why not?
-      @team = team
-      @played = @home_played = @away_played = 0
-      @won    = @home_won    = @away_won    = 0
-      @lost   = @home_lost   = @away_lost   = 0
-      @drawn  = @home_drawn  = @away_drawn  = 0
-      @goals_for     = @home_goals_for     = @away_goals_for     = 0
-      @goals_against = @home_goals_against = @away_goals_against = 0
-      @pts    = @home_pts    = @away_pts    = 0
-    end
-  end # (nested) class StandingsLine
-
-
-  def initialize( match_or_matches=nil, opts={} )
-    ## fix:
-    # passing in e.g. pts for win (3? 2? etc.)
-    # default to 3 for now
-
-    ## lets you pass in 2 as an alterantive, for example
-    @pts_won = opts[:pts_won] || 3
-
-    @lines = {}   # StandingsLines cached by team name/key
-
-    ## add init and update all-in-one convenience shortcut
-    update( match_or_matches )  if match_or_matches
-  end
-
-
-  def update( match_or_matches )
-    ## convenience - update all matches at once
-    ## todo/check:  check for ActiveRecord_Associations_CollectionProxy and than use to_a (to "force" array) - why? why not?
-    matches = if match_or_matches.is_a?(Array)
-                match_or_matches
-              else
-                [match_or_matches]
-              end
-
-    matches.each_with_index do |match,i| # note: index(i) starts w/ zero (0)
-      update_match( match )
-    end
-    self  # note: return self to allow chaining
-  end
-
-
-  ## note: add a convenience shortcut
-  ##  to_a  will sort and add rank (1,2,3) to standing lines
-  def each( &block ) to_a.each( &block ); end
-
-  def to_a
-    ## return lines; sort and add rank
-    ## note: will update rank!!!! (side effect)
-
-    #############################
-    ### calc ranking position (rank)
-    ## fix/allow same rank e.g. all 1 or more than one team 3rd etc.
-
-    # build array from hash
-    ary = []
-    @lines.each do |k,v|
-      ary << v
-    end
-
-    ary.sort! do |l,r|
-      ## note: reverse order (thus, change l,r to r,l)
-      value = r.pts <=> l.pts
-      if value == 0 # same pts try goal diff
-        value = (r.goals_for-r.goals_against) <=> (l.goals_for-l.goals_against)
-        if value == 0 # same goal diff too; try assume more goals better for now
-          value = r.goals_for <=> l.goals_for
-        end
-      end
-      value
-    end
-
-    ## update rank using ordered array
-    ary.each_with_index do |line,i|
-      line.rank = i+1 ## add ranking (e.g. 1,2,3 etc.) - note: i starts w/ zero (0)
-    end
-
-    ary
-  end  # to_a
-
-
-
-  #####
-  ###
-  ## fix: move build to StandingsPart/Report   !!!!
-  def build( source: nil )   ## build / pretty print standings table in string buffer
-    ## keep pretty printer in struct - why? why not?
-
-
-    ## add standings table in markdown to buffer (buf)
-
-    ## todo: use different styles/formats (simple/ etc  ???)
-
-  ## simple table (only totals - no home/away)
-  ##       standings.to_a.each do |l|
-  ##         buf << '%2d. '  % l.rank
-  ##         buf << '%-28s  ' % l.team
-  ##         buf << '%2d '     % l.played
-  ##         buf << '%3d '     % l.won
-  ##         buf << '%3d '     % l.drawn
-  ##         buf << '%3d '     % l.lost
-  ##         buf << '%3d:%-3d ' % [l.goals_for,l.goals_against]
-  ##         buf << '%3d'       % l.pts
-  ##         buf << "\n"
-  ##       end
-
-    buf = ''
-    buf << "\n"
-    buf << "```\n"
-    buf << "                                        - Home -          - Away -            - Total -\n"
-    buf << "                                 Pld   W  D  L   F:A     W  D  L   F:A      F:A   +/-  Pts\n"
-
-    to_a.each do |l|
-      buf << '%2d. '  % l.rank
-      buf << '%-28s  ' % l.team
-      buf << '%2d  '     % l.played
-
-      buf << '%2d '      % l.home_won
-      buf << '%2d '      % l.home_drawn
-      buf << '%2d '      % l.home_lost
-      buf << '%3d:%-3d  ' % [l.home_goals_for,l.home_goals_against]
-
-      buf << '%2d '       % l.away_won
-      buf << '%2d '       % l.away_drawn
-      buf << '%2d '       % l.away_lost
-      buf << '%3d:%-3d  ' % [l.away_goals_for,l.away_goals_against]
-
-      buf << '%3d:%-3d ' % [l.goals_for,l.goals_against]
-
-      goals_diff = l.goals_for-l.goals_against
-      if goals_diff > 0
-        buf << '%3s  '  %  "+#{goals_diff}"
-      elsif goals_diff < 0
-        buf << '%3s  '  %  "#{goals_diff}"
-      else ## assume 0
-        buf << '     '
-      end
-
-      buf << '%3d'       % l.pts
-      buf << "\n"
-    end
-
-    buf << "```\n"
-    buf << "\n"
-
-    ## optinal: add data source if known / present
-    ##   assume (relative) markdown link for now in README.md
-    if source
-      buf << "(Source: [`#{source}`](#{source}))\n"
-      buf << "\n"
-    end
-
-    buf
-  end
-
-
-private
-  def update_match( m )   ## add a match
-
-    ## note: always use team as string for now
-    ##   for now allow passing in of string OR struct - why? why not?
-    ##   todo/fix:  change to m.team1_name and m.team2_name - why? why not?
-    team1 = m.team1.is_a?( String ) ? m.team1 : m.team1.name
-    team2 = m.team2.is_a?( String ) ? m.team2 : m.team2.name
-
-    score = m.score.to_s
-
-    ##  puts "   #{team1} - #{team2} #{score}"
-
-    unless m.over?
-      puts " !!!! skipping match - not yet over (date in the future) => #{m.date}"
-      return
-    end
-
-    unless m.complete?
-      puts "!!! [calc_standings] skipping match #{team1} - #{team2} w/ past date #{m.date} - scores incomplete => #{score}"
-      return
-    end
-
-
-
-    line1 = @lines[ team1 ] || StandingsLine.new( team1 )
-    line2 = @lines[ team2 ] || StandingsLine.new( team2 )
-
-    line1.played      += 1
-    line1.home_played += 1
-
-    line2.played      += 1
-    line2.away_played += 1
-
-    if m.winner == 1
-      line1.won      += 1
-      line1.home_won += 1
-
-      line2.lost      += 1
-      line2.away_lost += 1
-
-      line1.pts      += @pts_won
-      line1.home_pts += @pts_won
-    elsif m.winner == 2
-      line1.lost      += 1
-      line1.home_lost += 1
-
-      line2.won       += 1
-      line2.away_won  += 1
-
-      line2.pts      += @pts_won
-      line2.away_pts += @pts_won
-    else ## assume drawn/tie (that is, 0)
-      line1.drawn      += 1
-      line1.home_drawn += 1
-
-      line2.drawn      += 1
-      line2.away_drawn += 1
-
-      line1.pts      += 1
-      line1.home_pts += 1
-      line2.pts      += 1
-      line2.away_pts += 1
-    end
-
-    if m.score1 && m.score2
-      line1.goals_for      += m.score1
-      line1.home_goals_for += m.score1
-      line1.goals_against      += m.score2
-      line1.home_goals_against += m.score2
-
-      line2.goals_for      += m.score2
-      line2.away_goals_for += m.score2
-      line2.goals_against      += m.score1
-      line2.away_goals_against += m.score1
-    else
-      puts "*** warn: [standings] skipping match with missing scores: #{m.inspect}"
-    end
-
-    @lines[ team1 ] = line1
-    @lines[ team2 ] = line2
-  end  # method update_match
-
-end  # class Standings
-
-
-end # module Sports

data/lib/sports/structs/team.rb

@@ -1,147 +0,0 @@
-
-module Sports
-
-##
-##  todo/fix:  remove self.create in structs!!!  use just new!!!
-
-class Team
-  ##  todo: use just names for alt_names - why? why not?
-  attr_accessor :key, :name, :alt_names,
-                :code,    ## code == abbreviation e.g. ARS etc.
-                :year, :year_end,   ## todo/fix: change year to start_year and year_end to end_year (like in season)!!!
-                :country
-
-
-  def names
-    ## todo/check: add alt_names_auto too? - why? why not?
-    [@name] + @alt_names
-  end   ## all names
-
-  def key
-    ## note: auto-generate key "on-the-fly" if missing for now - why? why not?
-    ## note: quick hack - auto-generate key, that is, remove all non-ascii chars and downcase
-    @key || @name.downcase.gsub( /[^a-z]/, '' )
-  end
-
-
-  ## special import only attribs
-  attr_accessor :alt_names_auto    ## auto-generated alt names
-  attr_accessor :wikipedia   # wikipedia page name (for english (en))
-
-
-  def historic?()  @year_end ? true : false; end
-  alias_method  :past?, :historic?
-
-  def wikipedia?()  @wikipedia; end
-  def wikipedia_url
-    if @wikipedia
-      ##  note: replace spaces with underscore (-)
-      ##  e.g. Club Brugge KV => Club_Brugge_KV
-      ##  todo/check/fix:
-      ##    check if "plain" dash (-) needs to get replaced with typographic dash??
-      "https://en.wikipedia.org/wiki/#{@wikipedia.gsub(' ','_')}"
-    else
-      nil
-    end
-  end
-
-
-  def initialize( **kwargs )
-    @alt_names      = []
-    @alt_names_auto = []
-
-    update( kwargs )  unless kwargs.empty?
-  end
-
-  def update( **kwargs )
-    @key         = kwargs[:key]        if kwargs.has_key? :key
-    @name        = kwargs[:name]       if kwargs.has_key? :name
-    @code        = kwargs[:code]       if kwargs.has_key? :code
-    @alt_names   = kwargs[:alt_names]  if kwargs.has_key? :alt_names
-    self   ## note - MUST return self for chaining
-  end
-
-
-
-  ##############################
-  ## helper methods for import only??
-  ## check for duplicates
-  include SportDb::NameHelper
-
-  def duplicates?
-    names = [name] + alt_names + alt_names_auto
-    names = names.map { |name| normalize( sanitize(name) ) }
-
-    names.size != names.uniq.size
-  end
-
-  def duplicates
-    names = [name] + alt_names + alt_names_auto
-
-    ## calculate (count) frequency and select if greater than one
-    names.reduce( {} ) do |h,name|
-       norm = normalize( sanitize(name) )
-       h[norm] ||= []
-       h[norm] << name; h
-    end.select { |norm,names| names.size > 1 }
-  end
-
-
-  def add_variants( name_or_names )
-    names = name_or_names.is_a?(Array) ? name_or_names : [name_or_names]
-    names.each do |name|
-      name = sanitize( name )
-      self.alt_names_auto += variants( name )
-    end
-  end
-end   # class Team
-
-
-
-class NationalTeam < Team
-  def initialize( **kwargs )
-    super
-  end
-
-  def update( **kwargs )
-    super
-    self   ## note - MUST return self for chaining
-  end
-
-end  # class NationalTeam
-
-
-########
-# more attribs - todo/fix - also add "upstream" to struct & model!!!!!
-#   district, geos, year_end, country, etc.
-
-class Club < Team
-  attr_accessor  :ground
-
-  attr_accessor :a, :b
-  def a?()  @a == nil; end  ## is a (1st) team / club (i)?            if a is NOT set
-  def b?()  @a != nil; end  ## is b (2nd/reserve/jr) team / club (ii) if a is     set
-
-  ## note: delegate/forward all geo attributes for team b for now (to team a) - keep - why? why not?
-  attr_writer  :city, :district, :geos
-  def city()      @a == nil ?  @city     : @a.city;     end
-  def district()  @a == nil ?  @district : @a.district; end
-  def country()   @a == nil ?  @country  : @a.country;  end
-  def geos()      @a == nil ?  @geos     : @a.geos;     end
-
-
-  def initialize( **kwargs )
-    super
-  end
-
-  def update( **kwargs )
-    super
-    @city        = kwargs[:city]       if kwargs.has_key? :city
-    ## todo/fix:  use city struct - why? why not?
-    ## todo/fix: add country too  or report unused keywords / attributes - why? why not?
-
-    self   ## note - MUST return self for chaining
-  end
-end # class Club
-
-end   # module Sports