fbtxt-pp 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cb82751c433e1b2a9495f545dde77a538f1cb08b66e55aa6c6af0e3830ef6cff
+  data.tar.gz: 5cc0c7f57f4d5e79db8bba38d97dc3dbc4ca6374de7db8d51acf3fc7d351e681
+SHA512:
+  metadata.gz: ec8a5d094a5054b95a7ee2fd7b2d798a181c4ad92e81f77a1d94bf571041032431d69fa85afbf90f07bd1bd3e35306a8d45a8a994a0989c6760e8321231d99d2
+  data.tar.gz: 32dea04aa3ad82a0033c8505794e2dd6fb959f0fdef51a00dbacd53a083358f0a2ac81628f1feccb745169e163f6c1301400de2c26487167aa2b0064f734551d

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+
+### 0.0.2 / 2026-07-23
+
+* Everything is new. First release.

data/Manifest.txt

@@ -0,0 +1,34 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+bin/fbhub
+bin/fbpp
+lib/fbtxt-pp.rb
+lib/fbtxt-pp/config.rb
+lib/fbtxt-pp/config_clubs.csv
+lib/fbtxt-pp/config_more.rb
+lib/fbtxt-pp/config_worldcup.rb
+lib/fbtxt-pp/helper.rb
+lib/fbtxt-pp/models/document.rb
+lib/fbtxt-pp/models/goals.rb
+lib/fbtxt-pp/models/match.rb
+lib/fbtxt-pp/models/officials.rb
+lib/fbtxt-pp/models/penalties.rb
+lib/fbtxt-pp/models/players.rb
+lib/fbtxt-pp/models/score.rb
+lib/fbtxt-pp/models/stadiums.rb
+lib/fbtxt-pp/models/teams.rb
+lib/fbtxt-pp/pp/ppbookings.rb
+lib/fbtxt-pp/pp/ppgoals.rb
+lib/fbtxt-pp/pp/pplineup.rb
+lib/fbtxt-pp/pp/ppmatch.rb
+lib/fbtxt-pp/pp/ppmatch_full.rb
+lib/fbtxt-pp/pp/ppmatch_min.rb
+lib/fbtxt-pp/pp/ppopts.rb
+lib/fbtxt-pp/pp/pppenalties.rb
+lib/fbtxt-pp/pp/ppsquads.rb
+lib/fbtxt-pp/pp/ppstats.rb
+lib/fbtxt-pp/tool-fbhub.rb
+lib/fbtxt-pp/tool-fbpp.rb
+lib/fbtxt-pp/version.rb

data/README.md

@@ -0,0 +1,25 @@
+# fbtxt-pp - pretty print (pp) football match fixtures & results in the football.txt format
+
+
+* 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/fbtxt-pp](https://rubygems.org/gems/fbtxt-pp)
+* rdoc  :: [rubydoc.info/gems/fbtxt-pp](http://rubydoc.info/gems/fbtxt-pp)
+
+
+
+## Usage
+
+To be done
+
+
+## License
+
+The `fbtxt-pp` scripts are dedicated to the public domain.
+Use 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/fbtxt-pp/version.rb'
+
+
+Hoe.spec 'fbtxt-pp' do
+
+  self.version = Fbtxt::Module::Fbpp::VERSION
+
+  self.summary = "fbtxt-pp - pretty print (pp) football match fixtures & results in the football.txt format"
+  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 = [
+    ['cocos'],
+    ['season-formats'],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+   required_ruby_version: '>= 3.1.0'
+  }
+
+end

data/bin/fbhub

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/fbpp
+
+
+##
+## note - always use latest (local) if present
+$LOAD_PATH.unshift( '/sports/yorobot/fbup/fbup/lib' )
+require 'fbup'
+
+##
+## note - always use latest (local) if present
+$LOAD_PATH.unshift( '/sports/yorobot/sport.db.more/fbtxt-pp/lib' )
+require 'fbtxt-pp'
+
+
+Fbhub.main( ARGV )

data/bin/fbpp

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/fbpp
+
+
+##
+## note - always use latest (local) if present
+$LOAD_PATH.unshift( '/sports/yorobot/sport.db.more/fbtxt-pp/lib' )
+
+require 'fbtxt-pp'
+
+
+Fbpp.main( ARGV )

data/lib/fbtxt-pp/config.rb

@@ -0,0 +1,62 @@
+
+
+
+## defaults
+FORMAT_OPTS_DEFAULTS = {
+    country:  false,
+    city:     false,
+    stadium:  false,
+    timezone: false,
+}
+
+FORMAT_OPTS_FULL_DEFAULTS = {
+    country:       false,
+    city:          true,
+    stadium:       true,
+    timezone:      true,
+
+    show_teams:    false,
+    show_stadiums: false,
+}
+
+def _parse_format_opts( str )
+    h = {}
+   keys = str.split( /[ ]*\|[ ]*/ )
+   keys.each do |key|
+       case key.to_sym
+       when :country  then h[:country] = true
+       when :city     then h[:city]    = true
+       else
+         raise ArgumentError, "unknown key #{key} in format opts"
+       end
+   end
+   h
+end
+
+
+def read_config_pp( *paths )
+  config = {}
+  paths.each do |path|
+    recs = read_csv( path )
+
+    recs.each do |rec|
+      key = rec['code']
+      h = {
+            slug:      key,
+            name:      rec['name'],
+            seasons:   rec['seasons'],
+            opts:      {}.merge( FORMAT_OPTS_DEFAULTS,      _parse_format_opts( rec['opts'] )),
+            opts_full: {}.merge( FORMAT_OPTS_FULL_DEFAULTS, _parse_format_opts( rec['opts_full'] )),
+      }
+
+      config[ key ] = h
+    end
+  end
+  config
+end
+
+
+CONFIGS = {}
+more_configs = read_config_pp( "#{Fbtxt::Module::Fbpp.root}/lib/fbtxt-pp/config_clubs.csv" )
+pp more_configs
+CONFIGS.merge!( more_configs )

data/lib/fbtxt-pp/config_clubs.csv

@@ -0,0 +1,37 @@
+
+code, name, seasons,  opts,    opts_full
+
+##
+##  remove seasons - why? why not?
+
+at,      Austria | Bundesliga,     2025/26,,
+de,      Germany | Bundesliga,     2025/26,,
+eng,     England | Premier League, 2025/26,,
+
+
+fr,      France | Ligue 1,          2025/26,,
+it,      Italy | Serie A,           2025/26,,
+es,      Spain | Primera División,   2025/26,,
+
+mx,      Mexico | Liga MX,           2025/26,,
+
+uefa.cl,     UEFA | Champions League,  2025/26, country|city, country
+uefa.europa, UEFA | Europa League,     2025/26, country|city, country
+uefa.con,    UEFA | Conference League, 2025/26, country|city, country
+
+###
+#  opts
+#    default as false everyting!! e.g.
+#                       country: false,
+#                       stadium: false,
+#                       city:    false,
+#                       timezone: false
+#                     { country: false,
+#                       stadium: false,
+#                       city:    false,
+#                       timezone: false,
+#                     }
+# opts_full
+#    default  only country false
+#    { country: false,
+#                     }

data/lib/fbtxt-pp/config_more.rb

@@ -0,0 +1,65 @@
+
+### rename to setups or such - why? why not?
+
+
+## default setups
+
+CONFIGS.merge!({
+    clubworldcup: {
+         slug:   'clubworldcup',  ## rename to dir / indir / source / source or ???
+        name:      'Club World Cup',
+        seasons:      ['2025'],
+        ## default pp opts
+        opts:        { country:       true,
+                       show_stadiums: false,
+                     },
+        opts_full:   { country: true,
+                     },
+
+     ## outdir = "../../openfootball/clubworldcup"
+    },
+
+
+
+     ## todo - find a better key  than _v0??
+     ##         use clubworldcup_hist or _history or __ ??
+    clubworldcup_v0: {
+       ##  all club world cups  2000, 2005-2023
+       ##    NOT incl. new format every 4 yrs starting in 2025
+       ##    NOT incl. old/new interconti cup every yr starting in 2024
+        slug:   'interconticup',
+        name:      'Club World Cup',
+##        outname:   'clubworldcup',
+        seasons: ['2000',
+                  '2005', '2006', '2007', '2008', '2009',
+                  '2010', '2011', '2012', '2013', '2014',
+                  '2015', '2016', '2017', '2018', '2019',
+                  '2020', '2021', '2022', '2023'],
+        ## default pp opts
+        opts:        { country: true,
+                       show_stadiums: false,
+                       show_teams:   true,
+                     },
+        opts_full:   { country: true,
+                       show_teams:   true,
+                     },
+        ## outdir = "../../openfootball/clubworldcup"
+    },
+
+
+
+    interconticup: {
+       ##    (new) interconti cup   2024-
+        slug:   'interconticup',
+        name:      'Intercontinental Cup',
+       seasons: ['2024', '2025'],
+       ## default pp opts
+        opts:        { country: true,
+                       show_stadiums: false,
+                       show_teams:   true,
+                     },
+        opts_full:   { country: true,
+                       show_teams:   true,
+                     },
+    },
+})

data/lib/fbtxt-pp/config_worldcup.rb

@@ -0,0 +1,27 @@
+
+CONFIGS.merge!({
+  worldcup: {
+        slug:      'worldcup',   ## rename to dir / indir / source / source or ???
+        name:      'World Cup',
+        ## check - incl. 2026 - not all matches with results and teams!!!
+        seasons:   ['1930', '1934', '1938',
+                    '1950', '1954', '1958', '1962', '1966', '1970', '1974', '1978',
+                    '1982', '1986', '1990', '1994', '1998', '2002', '2006', '2010',
+                    '2014', '2018', '2022', '2026'],
+        ## default pp opts
+        opts:        { country:       false,
+                       stadium:       false,
+                       city:          true,
+                       show_stadiums: true,
+                       show_teams:    false,
+                       timezone:      true,
+                     },
+        opts_full:   { country: false,
+                       show_stadiums: true,
+                     },
+        ## opts for squads (incl. jersey numbers - yes/no?)
+        jerseys:  ->(season) { season >= 1954 ? true : false },
+
+         ## outdir = "../../openfootball/worldcup"
+    }
+})

data/lib/fbtxt-pp/helper.rb

@@ -0,0 +1,69 @@
+
+
+def assert( test, msg )
+    if test
+    else
+        puts "!! ASSERT FAILED - #{msg}"
+        exit 1
+    end
+end
+
+
+def parse_date_utc( date_str )
+    ## note - DateTime has NOT daylight saving time (e.g. dst?)
+    ##    or named timezones!!
+    ##        only works with offsets
+    ##
+    ##  use Time for built-in timezones (and check on daylight saving time etc.)
+
+    date = DateTime.strptime( date_str, '%Y-%m-%dT%H:%M%z' )
+
+    assert( date_str == date.strftime('%Y-%m-%dT%H:%MZ'),
+              "date parse expected #{date_str} - got #{date.inspect}" )
+    date
+end
+
+def parse_date_local( date_str )
+    ## fix - parse UTC+-offset !!!!
+    ##  e.g. 2025-08-01 20:30 UTC+2
+    date = DateTime.strptime( date_str, '%Y-%m-%d %H:%M UTC%z' )
+
+    ## assert( date_str == date.strftime('%Y-%m-%dT%H:%MZ'),
+    ##          "date parse expected #{date_str} - got #{date.inspect}" )
+    date
+end
+
+
+
+ MINUTE_RE = %r{  \A
+                       (?<minute>\d{1,3}) '?
+                        (  \+
+                          (?<offset>\d{1,2}) '?
+                        )?
+                   \z
+                 }x
+
+
+def _parse_minute( str )
+
+    ## support weirdo  120'+-30'  -- remove minuts
+    str = str.gsub( '-', '' )
+
+    m = MINUTE_RE.match( str )
+    raise ArgumentError, "unknown goal minute format in #{str.inspect}"  if m.nil?
+
+    minute = m[:minute].to_i(10)
+    offset = m[:offset] ? m[:offset].to_i(10) : nil
+
+    [minute,offset]
+end
+
+def _fmt_minute( minute, offset )
+     ## pp [minute,offset]
+
+     buf = String.new
+     buf << "#{minute}"
+     buf << "+#{offset}"   if offset
+     buf << "'"
+     buf
+end

data/lib/fbtxt-pp/models/document.rb

@@ -0,0 +1,130 @@
+
+##
+## note:
+##  document is container for LeagueSeason holding teams, matches, etc.
+
+class Document
+
+def self.read( path )
+     data = read_json( path )
+     new( data )
+end
+
+def initialize( data )
+    @data = data
+
+    @teams = Teams.new
+    @teams.add( data['teams'] )
+    ## puts "  #{teams.size} team(s) in season #{season}"
+
+    @stadiums = Stadiums.new
+    @stadiums.add( data['stadiums'] )
+    ## puts "  #{stadiums.size} stadium(s) in season #{season}"
+
+
+   ## read in stages for sorting
+   ##   incl.  SequenceOrder, StageLevel (optional)
+   ## stages = Stages.new
+   ## stages.add( read_json( "./#{slug}/misc/#{season}_stages.json" )['Results'] )
+
+    ## automagically sort (by groups) - why? why not?
+    @data['matches'] = _sort_matches( @data['matches'] )
+end
+
+
+def find_team!( q ) @teams.find!( q );  end
+
+def find_stadium!( h ) @stadiums.find!( h );  end
+
+
+## quick ("unsafe/low-level") access for size - keep? why? why not?
+##   use team_count, stadium_count, match_count  - why? why not?
+def teams()     @teams; end
+def stadiums()  @stadiums; end
+def matches()   @data['matches']; end
+
+
+def each_match( &blk )
+   @data['matches'].each do |_m|
+      ## use ("typed" struct) wrapper
+      m = Match.new( self, _m )
+      blk.call( m )
+   end
+end
+alias_method  :each, :each_match
+
+
+## (was: collect_dates)
+##   find a better name e.g. min_max_dates / duration / collect/find_start_end_dates?
+def calc_start_end_dates
+  start_date = nil
+  end_date   = nil
+
+  @data['matches'].each do |_m|
+
+     ## date_utc       = parse_date_utc(   _m['datetime_utc'] )
+     date_local     = parse_date_local( _m['datetime_local'] )
+
+     ## note - alway use local datetime for now
+
+     if start_date.nil? || date_local  < start_date
+        start_date = date_local
+      end
+
+     if end_date.nil? || date_local > end_date
+        end_date = date_local
+     end
+  end
+
+  [start_date, end_date]
+end
+
+
+
+###
+##  (private) helpers
+
+def _sort_matches( matches )
+  ###
+  ##   sort results by group if present
+
+  ## add "old" sort index
+  matches = matches.each_with_index.map {|m,i| m['sort']=i+1; m }
+
+
+  matches =  matches.sort do |l,r|
+
+   lhs_stage =  l['stage']
+   rhs_stage =  r['stage']
+
+   ## lhs_stage = stages.find!( lhs_stageName )
+   ## rhs_stage = stages.find!( rhs_stageName )
+
+   lhs_group  = l['group']   # optional
+   rhs_group  = r['group']   # optional
+
+   lhs_matchday  = l['matchday']   # optional
+   rhs_matchday  = r['matchday']   # optional
+
+   if (lhs_group && rhs_group) && (lhs_stage == rhs_stage)
+       res = lhs_group <=> rhs_group
+       res = (lhs_matchday && rhs_matchday ?
+              lhs_matchday <=> rhs_matchday :  0 )  if res == 0
+       ## same group; sort by old index (or) date??
+       res = l['sort'] <=> r['sort']   if res == 0
+       res
+   else
+       ### sort first by stage (seq) and than keep as is
+       ### res = lhs_stage[:seq] <=> rhs_stage[:seq]
+       ## res = l['sort'] <=> r['sort']    if res == 0
+       ## res
+       l['sort'] <=> r['sort']
+   end
+  end
+
+   matches
+end
+
+
+
+end # class Document

data/lib/fbtxt-pp/models/goals.rb

@@ -0,0 +1,60 @@
+
+
+class Goal
+  def self.build( h )
+    ## split into minute
+    ##  and offset (stoppage/injury time)
+    ##  e.g. 90'+11'
+
+    ##
+    ##  keep minute as string and incl. stoppage/injury time - why? why not?
+
+    new( name:   h['name'],
+         minute: h['minute'],
+         og:     h['og'],   # true|false
+         pen:    h['pen']  # true|false
+         )
+  end
+
+
+  attr_reader :name,
+              :minute, :og, :pen
+
+  def initialize( name:, minute:,
+                  og: false, pen: false )
+
+    norm = norm_name( name )
+    if norm != name
+       puts "  NORM GOAL/PLAYER NAME >#{name}<  =>  >#{norm}<"
+       name = norm
+     end
+
+    @name     = name
+    @minute   = minute
+
+    @og, @pen = og, pen
+  end
+
+  def og?()  @og; end
+  def pen?() @pen; end
+
+end # class Goal
+
+
+
+
+
+=begin
+    ## sort by minutes
+    ##  may not be sorted
+
+    recs = recs.sort do |l,r|
+                 res = l[:minute] <=> r[:minute]
+                 res = (l[:offset]||0) <=> (r[:offset]||0)  if res == 0 &&
+                                                              (l[:minute] == 45 ||
+                                                               l[:minute] == 90 ||
+                                                               l[:minute] == 105 ||  ## check - if possible stoppage in 1st half extra-time??
+                                                               l[:minute] == 120)
+                 res
+           end
+=end

data/lib/fbtxt-pp/models/match.rb

@@ -0,0 +1,76 @@
+
+
+class Match
+
+
+##
+##  use Match.build( h ) - why? why not?
+
+attr_reader :team1,    :team2,
+            :score,
+            :date_utc, :date_local,  :utc_offset,
+            :stadium,
+            :goals1, :goals2
+
+
+
+def initialize( doc, data )
+     ## expect a data as (json) hash for now
+     @doc = doc
+     @h   = data
+
+
+     ## note - always lookup full team records (use match inline only as refs)
+     @team1 = @doc.find_team!( @h['team1'] )
+     @team2 = @doc.find_team!( @h['team2'] )
+
+
+     @date_utc       = parse_date_utc(   @h['datetime_utc'] )
+     @date_local     = parse_date_local( @h['datetime_local'] )
+
+     assert( @date_utc.sec == 0 && @date_local.sec == 0,
+                "sec 00 expected" )
+
+    ## note:  returns Rational (e.g. 3/1 or 1/4 etc.) use to_f/to_i to convert
+    ## diff_in_hours = ((localDateTime - dateTime) * 24).to_f
+    ## diff_in_days  =  localDateTime.jd - dateTime.jd
+
+     # note - offset is in rational fraction of a day (e.g. 1/12 for 2hours)
+     ##  was diff_in_hours
+     @utc_offset = (@date_local.offset * 24).to_i
+
+     ## pp [@date_utc, @date_local, @utc_offset]
+
+     ## note - always lookup full stadium record (use match inline only as ref)
+     @stadium  =  @doc.find_stadium!( @h['stadium'] )
+
+
+     @score   =   @h['score'] ? Score.build( @h['score'] ) :  nil
+
+
+     @goals1 =   @h['goals1'] ? @h['goals1'].map { |h| Goal.build( h ) } : nil
+     @goals2 =   @h['goals2'] ? @h['goals2'].map { |h| Goal.build( h ) } : nil
+end
+
+
+
+## use _data  to mark as "private" and do NOT use - why? why not?
+def data() @h; end
+
+
+
+##  todo - find a better name for timezone offset
+##   use utc_offset - why? why not?
+alias_method :diff_in_hours, :utc_offset
+
+
+def stage()      @h['stage']; end
+def group()      @h['group']; end     # optional
+def num()        @h['number']; end    # optional (match) number
+def matchday()   @h['matchday']; end  # optional
+
+
+def attendance() @h['attendance']; end
+
+
+end  ## class Match