football-timezones 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f628a9691af73e5ab5f28f1be1cd09bae28ecf6e064e7efc4cb91867c182bf0a
+  data.tar.gz: 6273d92f3482d84bf785b6c161e4b71cf84172802c3ad40ffe3119f45c7f5fdf
+SHA512:
+  metadata.gz: 6424048a8a71b877fe32a3ed0278b79391f04cfea1836e09750a64aadc246f6a2df5e57560e0ff3e502b78b26a286843636b18520f346c7add1afe85bfe6e9fe
+  data.tar.gz: 9091b37b0f6ef280c1927b32299886318f401fbaa0c9c90da2a70d0542351ab67190e2bc9ea5f946de7557c03d279cf2983eb9cd8a75ba2e70ab0062e4c4ba68

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+### 0.0.1 / 2024-09-11
+
+* Everything is new. First release.
+

data/Manifest.txt

@@ -0,0 +1,12 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+config/timezones_africa.csv
+config/timezones_america.csv
+config/timezones_asia.csv
+config/timezones_europe.csv
+config/timezones_world.csv
+lib/football-timezones.rb
+lib/football-timezones/version.rb
+lib/football/timezones.rb

data/README.md

@@ -0,0 +1,25 @@
+#  football-timezones - time & timezone helpers for football (league) data
+
+
+* home  :: [github.com/sportdb/sport.db](https://github.com/sportdb/sport.db)
+* bugs  :: [github.com/sportdb/sport.db/issues](https://github.com/sportdb/sport.db/issues)
+* gem   :: [rubygems.org/gems/football-timezones](https://rubygems.org/gems/football-timezones)
+* rdoc  :: [rubydoc.info/gems/football-timezones](http://rubydoc.info/gems/football-timezones)
+
+
+
+## Usage
+
+...
+
+
+## License
+
+The `football-timezones` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+
+## Questions? Comments?
+
+Yes, you can. More than welcome.
+See [Help & Support »](https://github.com/openfootball/help)

data/Rakefile

@@ -0,0 +1,32 @@
+require 'hoe'
+require './lib/football-timezones/version.rb'
+
+Hoe.spec 'football-timezones' do
+
+  self.version = SportDb::Module::Timezones::VERSION
+
+  self.summary = "football-timezones - time & timezone helpers for football (league) data"
+  self.description = summary
+
+  self.urls = { home: 'https://github.com/sportdb/sport.db' }
+
+  self.author = 'Gerald Bauer'
+  self.email  = 'gerald.bauer@gmail.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['tzinfo'],
+    ['season-formats'],
+    ['cocos'],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+   required_ruby_version: '>= 3.1.0'
+  }
+
+end

data/config/timezones_africa.csv

@@ -0,0 +1,4 @@
+key,   zone
+
+eg,   Africa/Cairo  # +3  (gmt+3)
+

data/config/timezones_america.csv

@@ -0,0 +1,29 @@
+key,   zone
+
+
+us,     America/New_York     # (gmt-5) new york
+ca,     America/Toronto
+
+mx,     America/Mexico_City
+
+
+cr,    America/Costa_Rica     # gmt-6
+gt,    America/Guatemala      # gmt-6
+hn,    America/Tegucigalpa    # gmt-6
+sv,    America/El_Salvador    # gmt-6
+ni,    America/Managua       # gmt-6
+
+uy,    America/Montevideo     #   gmt-3
+pe,    America/Lima           #  gmt-5
+ec,    America/Guayaquil      #  gmt-5
+co,    America/Bogota
+bo,    America/La_Paz         #  gmt-4
+cl,    America/Santiago      #  gmt-4
+
+br,    America/Sao_Paulo               # gmt-3  - change to -3?
+ar,    America/Argentina/Buenos_Aires  # gmt-3  - change to -3?
+
+
+concacaf.cl,    America/Mexico_City     ### use mx time
+copa.l,         America/Sao_Paulo       ### use brazil time
+

data/config/timezones_asia.csv

@@ -0,0 +1,9 @@
+key,   zone
+
+jp,   Asia/Tokyo      # +9  (gmt+9)
+kr,   Asia/Seoul
+cn,   Asia/Shanghai   # +7  (gmt+7)
+
+
+
+

data/config/timezones_europe.csv

@@ -0,0 +1,47 @@
+key,   zone
+
+eng,    Europe/London
+sco,    Europe/London     ## check if entry or Edingburgh or such exits
+ie,     Europe/Dublin
+
+es,     Europe/Madrid
+de,     Europe/Berlin
+fr,     Europe/Paris
+it,     Europe/Rome
+
+pt,     Europe/Lisbon
+
+
+
+
+fi,      Europe/Helsinki      # +2
+gr,      Europe/Athens
+ro,      Europe/Bucharest
+ua,     Europe/Kyiv
+
+
+ru,     Europe/Moscow
+tr,     Europe/Istanbul     # +3 turkey time/moscow time
+
+at,     Europe/Vienna
+ch,     Europe/Zurich
+hu,     Europe/Budapest
+cz,    Europe/Prague
+sk,    Europe/Bratislava     # link to Prague !!!
+pl,   Europe/Warsaw
+be,  Europe/Brussels
+lu,  Europe/Luxembourg      # link to Brussels !!!
+nl,  Europe/Amsterdam       # link to Brussels !!!
+
+
+dk,   Europe/Berlin     ## check if country-specific available
+se,   Europe/Berlin     ## check if country-specific available
+hr,   Europe/Belgrade   ## check if country-specific available
+
+
+
+## for champs default for not to cet (central european time) - why? why not?
+uefa.cl,  Europe/Paris
+uefa.el,  Europe/Paris
+euro,     Europe/Paris
+

data/config/timezones_world.csv

@@ -0,0 +1,4 @@
+key,   zone
+
+
+##  world+2022,    add quatar here

data/lib/football/timezones.rb

@@ -0,0 +1,6 @@
+# note: allow require 'football/timezones' too
+#        (in addition to require 'football-timezones')
+
+require_relative '../football-timezones'
+
+

data/lib/football-timezones/version.rb

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

data/lib/football-timezones.rb

@@ -0,0 +1,167 @@
+require 'cocos'
+require 'season/formats'   ## add season support
+
+
+require 'tzinfo'
+
+
+## our own code
+require_relative 'football-timezones/version'
+
+
+####
+### 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
+   zone.local_time( d.year, d.month, d.day, d.hour, d.min, d.sec )
+  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 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 )
+      @zone.local_time( year, month, mday, hour, min, sec )
+   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: )
+   @zones ||= begin
+                zones = {}
+                ['timezones_america',
+                 'timezones_asia',
+                 'timezones_europe',
+                 'timezones_world',].each do |name|
+                     recs = read_csv( "#{SportDb::Module::Timezones.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
+                        zones[ rec['key']] = zone
+                     end
+                 end
+                 zones
+              end
+
+   ## lookup first try by league+season
+   league_code = league.to_s.downcase
+   season      = Season( season )
+
+   ##  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
+
+   if zone.nil?  ## still not found; report error
+      puts "!! ERROR: no timezone found for #{league} #{season}"
+      exit 1
+   end
+
+   zone
+end
+end #  module TimezoneHelper
+
+
+
+
+####
+### note - make find_zone! public/global by default - why? why not?
+module Kernel
+   include TimezoneHelper
+end
+
+
+puts SportDb::Module::Timezones.banner   ## say hello

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification
+name: football-timezones
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-09-11 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.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+description: football-timezones - time & timezone helpers for football (league) data
+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/timezones_africa.csv
+- config/timezones_america.csv
+- config/timezones_asia.csv
+- config/timezones_europe.csv
+- config/timezones_world.csv
+- lib/football-timezones.rb
+- lib/football-timezones/version.rb
+- lib/football/timezones.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.4.10
+signing_key:
+specification_version: 4
+summary: football-timezones - time & timezone helpers for football (league) data
+test_files: []