sportdb-formats 1.1.0 → 1.1.5

data/lib/sportdb/formats/structs/round.rb

@@ -1,25 +0,0 @@
-module SportDb
-  module Import
-
-    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 Import
-end # module SportDb
-

data/lib/sportdb/formats/structs/season.rb

@@ -1,123 +0,0 @@
-# encoding: utf-8
-
-
-module SportDb
-  module Import
-
-
-class Season
-  ##
-  ##  todo: add (optional) start_date and end_date - why? why not?
-  ##        add next
-
-
-  attr_reader :start_year,
-              :end_year
-
-  def year?()  @end_year.nil?; end  ## single-year season e.g. 2011 if no end_year present
-
-
-  def initialize( str )   ## assume only string / line gets passed in for now
-    @start_year, @end_year = parse( str )
-  end
-
-
-  YYYY_YYYY_RE  = %r{^      ## e.g. 2011-2012 or 2011/2012
-                    (\d{4})
-                      [/-]
-                    (\d{4})
-                   $
-                  }x
-  YYYY_YY_RE  = %r{^       ## e.g. 2011-12 or 2011/12
-                    (\d{4})
-                      [/-]
-                    (\d{2})
-                   $
-                  }x
-  YYYY_Y_RE  = %r{^       ## e.g. 2011-2 or 2011/2
-                  (\d{4})
-                    [/-]
-                  (\d{1})
-                 $
-                }x
-  YYYY_RE     = %r{^       ## e.g. 2011
-                    (\d{4})
-                   $
-                  }x
-
-  def parse( str )
-    if str =~ YYYY_YYYY_RE    ## e.g. 2011/2012
-      [$1.to_i, $2.to_i]
-    elsif str =~ YYYY_YY_RE   ## e.g. 2011/12
-      fst = $1.to_i
-      snd = $2.to_i
-      snd_exp = '%02d' % [(fst+1) % 100]    ## double check: e.g 00 == 00, 01==01 etc.
-      raise ArgumentError.new( "[Season#parse] invalid year in season >>#{str}<<; expected #{snd_exp} but got #{$2}")   if snd_exp != $2
-      [fst, fst+1]
-    elsif str =~ YYYY_Y_RE    ## e.g. 2011/2
-      fst = $1.to_i
-      snd = $2.to_i
-      snd_exp = '%d' % [(fst+1) % 10]      ## double check: e.g 0 == 0, 1==1 etc.
-      raise ArgumentError.new( "[Season#parse] invalid year in season >>#{str}<<; expected #{snd_exp} but got #{$2}")   if snd_exp != $2
-      [fst, fst+1]
-    elsif str =~ YYYY_RE      ## e.g. 2011
-      [$1.to_i]
-    else
-      raise ArgumentError.new( "[Season#parse] unkown season format >>#{str}<<; sorry cannot parse")
-    end
-  end
-
-
-
-  def prev
-    if year?
-      Season.new( "#{@start_year-1}" )
-    else
-      Season.new( "#{@start_year-1}/#{@start_year}" )
-    end
-  end
-
-  def key
-    if year?
-      '%d' % @start_year
-    else
-      '%d/%02d' % [@start_year, @end_year % 100]
-    end
-  end
-  alias_method :to_key, :key
-  alias_method :to_s,   :key
-
-  alias_method :name,   :key
-  alias_method :title,  :key
-
-
-  def path( format: nil )
-    ##  todo: find better names for formats - why? why not?:
-    ##    long | archive | decade(?)   =>   1980s/1988-89, 2010s/2017-18, ...
-    ##    short | std(?)   =>   1988-89, 2017-18, ...
-
-    ## convert season name to "standard" season name for directory
-
-    if ['l', 'long', 'archive' ].include?( format.to_s )   ## note: allow passing in of symbol to e.g. 'long' or :long
-      if year?   ## e.g. 2000s/2001
-        "%3d0s/%4d" % [@start_year / 10, @start_year]
-      else       ## e.g. 2000s/2001-02
-        "%3d0s/%4d-%02d" % [@start_year / 10, @start_year, @end_year % 100]
-      end
-    else  ## default 'short' format / fallback
-      if year?   ## e.g. 2001
-        "%4d" % @start_year
-      else       ## e.g. 2001-02
-        "%4d-%02d" % [@start_year, @end_year % 100]
-      end
-    end
-  end # method path
-  alias_method :directory, :path   ## keep "legacy" directory alias - why? why not?
-  alias_method :to_path,   :path
-
-
-end # class Season
-
-
-end  # module Import
-end  # module SportDb

data/lib/sportdb/formats/structs/standings.rb

@@ -1,268 +0,0 @@
-# encoding: utf-8
-
-##########
-# todo/fix:
-##   reuse standings helper/calculator from sportdb
-##   do NOT duplicate
-
-
-module SportDb
-  module Import
-
-
-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( 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
-  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
-
-
-  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_str
-
-    ##  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 Import
-end # module SportDb

data/lib/sportdb/formats/structs/team.rb

@@ -1,150 +0,0 @@
-# encoding: utf-8
-
-module SportDb
-  module Import
-
-
-##
-##  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 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 Import
-end   # module SportDb