leagues 0.1.0

data/lib/leagues/timezones.rb

@@ -0,0 +1,195 @@
+####
+### check - nest CET class inside UTC e.g. UTC::CET - why? why not?
+##     make UTC and CET into a module (not class) - why? why not?
+
+module CET   ## central european time helpers
+  def self.now()  zone.now; end
+  def self.today() now.to_date; end
+  def self.strptime( str, format )
+
+    ### fix - change to Time.strptime - why? why not?
+    ##       (simply) ignore offset; double check that hours, minutes
+    ##        get parsed as is (without applying offset)
+
+    d = DateTime.strptime( str, format )
+      ## remove assert check - why? why not?
+      if d.zone != '+00:00'    ### use d.offset != Ration(0,1)  - why? why not?
+        puts "!! ASSERT - CET parse date; DateTime returns offset != +0:00"
+        pp d.zone
+        pp d
+        exit 1
+     end
+
+  ###  2006-03-26 02:00:00
+  ##  raise exception
+  ##    is an invalid local time. (TZInfo::PeriodNotFound)
+    ## quick fix add +1
+  ##  2012-03-25 02:00:00
+  ##   is an invalid local time. (TZInfo::PeriodNotFound)
+
+     if ['2018-03-25 02:00',
+         '2012-03-25 02:00',
+         '2006-03-26 02:00',
+        ].include?( d.strftime( '%Y-%m-%d %H:%M' ))
+       puts "!! hack - fix CET date #{d} - add +1 hour"
+       pp d
+       zone.local_time( d.year, d.month, d.day, d.hour+1, d.min, d.sec )
+     else
+       zone.local_time( d.year, d.month, d.day, d.hour, d.min, d.sec )
+     end
+  end
+  def self.zone() @zone ||= UTC.find_zone( 'Europe/Vienna' ); end
+end  # class CET
+
+
+
+module UTC
+  def self.now()  Time.now.utc; end
+  def self.today() now.to_date; end
+
+  ## -- 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
+  ## quick hack -
+  ##     use to_time.getutc instead of utc ???
+  def self.strptime( str, format )
+      d = DateTime.strptime( str, format )
+      ## remove assert check - why? why not?
+      if d.zone != '+00:00'    ### use d.offset != Ration(0,1)  - why? why not?
+         puts "!! ASSERT - UTC parse date; DateTime returns offset != +0:00"
+         pp d.zone
+         pp d
+         exit 1
+      end
+      ## note - ignores offset if any !!!!
+      ##    todo/check - report warn if offset different from 0:00 (0/1) - why? why not?
+      Time.utc( d.year, d.month, d.day, d.hour, d.min, d.sec )
+  end
+
+  def self.find_zone( name )
+     zone = TZInfo::Timezone.get( name )
+     ## wrap tzinfo timezone in our own - for adding more (auto)checks etc.
+     zone ? Timezone.new( zone ) : nil
+  end
+
+class Timezone   ## nested inside UTC
+   ## todo/fix
+   ##  cache timezone - why? why not?
+   def initialize( zone )
+     @zone = zone
+   end
+
+   def name() @zone.name; end
+   def dst?() @zone.dst?; end
+
+
+   def to_local( time )
+      ## assert time is Time (not Date or DateTIme)
+      ##  and assert utc!!!
+      assert( time.is_a?( Time ),  "time #{time} is NOT of class Time; got #{time.class.name}" )
+      assert( time.utc?,           "time #{time} is NOT utc; utc? returns #{time.utc?}" )
+      local = @zone.to_local( time )
+      local
+   end
+
+   def local_time( year, month=1, mday=1, hour=0, min=0, sec=0 )
+    ## add auto-fix for ambigious time (dst vs non-dst)
+    ##    always select first for now (that is, dst)
+      @zone.local_time( year, month, mday, hour, min, sec ) {|time| time.first }
+   end
+
+   def now() @zone.now; end
+
+
+
+
+   def assert( cond, msg )
+    if cond
+      # do nothing
+    else
+      puts "!!! assert failed - #{msg}"
+      exit 1
+    end
+  end
+end  # class Timezone
+end   # module UTC
+
+
+
+
+module TimezoneHelper
+
+def find_zone!( league:, season: )
+  zone = find_zone( league: league, season: season )
+  if zone.nil?  ## still not found; report error
+    puts "!! ERROR: no timezone found for #{league} #{season}"
+    exit 1
+  end
+  zone
+end
+
+
+def find_zone( league:, season: )
+   ## note: do NOT pass in league struct! pass in key (string)
+   raise ArgumentError, "league code as string|symbol expected"  unless league.is_a?(String) || league.is_a?(Symbol)
+
+   @zones ||= begin
+                zones = {}
+                ['timezones_africa',
+                 'timezones_america',
+                 'timezones_asia',
+                 'timezones_europe',
+                 'timezones_middle_east',
+                 'timezones_pacific',
+                 'timezones_world',].each do |name|
+                     recs = read_csv( "#{SportDb::Module::Leagues.root}/config/#{name}.csv" )
+                     recs.each do |rec|
+                        zone = UTC.find_zone( rec['zone'] )
+                        if zone.nil?
+                          ## raise ArgumentError - invalid zone
+                          puts "!! ERROR - cannot find timezone in timezone db:"
+                          pp rec
+                          exit 1
+                        end
+                        ##  todo/fix - rename key to (league) code
+                        zones[ rec['key']] = zone
+                     end
+                 end
+                 zones
+              end
+
+
+   ###
+   ##  map code here - why? why not?
+   ##   or (always) require canoncial code???
+   season      = Season( season )
+   league_info = LeagueCodes.find_by( code: league, season: season )
+
+   league_code = if league_info
+                    ## lookup first try by league+season
+                    league_info['code']   ## use canonical name
+                 else
+                    ## fallback; no league found
+                    ##    or report error in the future - why? why not?
+                    league.to_s.downcase
+                 end
+
+
+   ##  e.g. world+2022, etc.
+   key = "#{league_code}+#{season}"
+   zone = @zones[key]
+
+   ## try league e.g. eng.1 etc.
+   zone = @zones[league_code]  if zone.nil?
+
+   ## try first code only (country code )
+   if zone.nil?
+     code, _  = league_code.split( '.', 2 )
+     zone = @zones[code]
+   end
+
+   zone
+end
+end #  module TimezoneHelper
+

data/lib/leagues/version.rb

@@ -0,0 +1,24 @@
+
+module SportDb
+module Module
+  module Leagues
+    MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+    MINOR = 1
+    PATCH = 0
+    VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+    def self.version
+      VERSION
+    end
+
+    def self.banner
+      "leagues/#{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 Leagues
+end # module Module
+end # module SportDb

data/lib/leagues.rb

@@ -0,0 +1,63 @@
+require 'cocos'
+require 'season/formats'   ## add season support
+
+
+require 'tzinfo'
+
+
+
+
+## our own code
+require_relative 'leagues/version'
+require_relative 'leagues/league_codes'  
+
+require_relative 'leagues/leagueset'
+
+require_relative 'leagues/timezones'
+
+
+###
+## note - make LeagueCodes "global" by default for now - why? why not?
+LeagueCodes = SportDb::LeagueCodes
+Leagueset   = SportDb::Leagueset
+#### add alias - why? why not?
+LeagueSet = Leagueset    
+
+
+
+module LeaguesetHelper
+  ###
+  ### note - make read_leagueset & friends public/global by default - why? why not?
+  def read_leagueset( path )       Leagueset.read( path ); end
+  def parse_leagueset( txt )       Leagueset.parse( txt ); end
+  def parse_leagueset_args( args ) Leagueset.parse_args( args ); end
+end
+
+
+
+module FileHelper
+  def find_file( filename, path: )
+    path.each do |src_dir|
+      path = "#{src_dir}/#{filename}"
+      return path   if File.exist?( path )
+    end
+
+    ##  fix - raise file not found error!!!
+    nil  ## not found - raise filenot found error - why? why not?
+  end
+end
+
+
+
+####
+### note - make find_zone! public/global by default - why? why not?
+module Kernel
+   include FileHelper
+   include LeaguesetHelper
+   include TimezoneHelper
+end
+
+
+
+
+puts SportDb::Module::Leagues.banner   ## say hello

metadata

@@ -0,0 +1,142 @@
+--- !ruby/object:Gem::Specification
+name: leagues
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-04-01 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: 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.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.2'
+description: leagues - football leagues & timezone helpers
+email: gerald.bauer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- config/codes_alt.csv
+- config/leagues.csv
+- config/leagues_more.csv
+- config/timezones_africa.csv
+- config/timezones_america.csv
+- config/timezones_asia.csv
+- config/timezones_europe.csv
+- config/timezones_middle_east.csv
+- config/timezones_pacific.csv
+- config/timezones_world.csv
+- lib/leagues.rb
+- lib/leagues/league_codes.rb
+- lib/leagues/leagueset.rb
+- lib/leagues/timezones.rb
+- lib/leagues/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: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: leagues - football leagues & timezone helpers
+test_files: []