fbup 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d55ede42bbe3e933365193d25054464d9226d1a5743dc9b4919ce47760faa68d
+  data.tar.gz: 2c759f0719ceed561a02d25818141cb57625ef60ca99f1f294c5e80e0b185d05
+SHA512:
+  metadata.gz: ea4c01a1e01290360ebe48028225745c6b33d6ad2196af66846f6287a1a0bd2c6713c7026127a281caade87d8b2488c27c09e0c61d54a7992322d0b334b33d12
+  data.tar.gz: 5b6afe253dcabb81e23918dbb257104dcb3c25446f3a5ffdcd3e12553fd5dcf69995018f4476903c3ae5844fc00e3969afb84c0634d390063b743011553d7419

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.0.1 / 2024-12-29
+
+* Everything is new. First release.

data/Manifest.txt

@@ -0,0 +1,11 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+bin/fbup
+config/openfootball.csv
+lib/fbup.rb
+lib/fbup/github.rb
+lib/fbup/github_config.rb
+lib/fbup/main.rb
+lib/fbup/version.rb

data/README.md

@@ -0,0 +1,37 @@
+# fbup - (auto-)update machinery for footbal match schedules & more in football.txt; incl. (auto-sync & commit) support for github openfootball repos & more
+ 
+
+* 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/fbup](https://rubygems.org/gems/fbup)
+* rdoc  :: [rubydoc.info/gems/fbup](http://rubydoc.info/gems/fbup)
+
+
+## Step 0 - Installation Via Gems
+
+To install the command-line tool via gems (ruby's package manager) use:
+
+```
+$ gem install fbup
+```
+
+
+## Usage
+
+Try in your shell / terminal:
+
+```
+$ fbup -h
+```
+
+resulting in:
+
+
+...
+
+
+
+## Questions? Comments?
+
+Yes, you can. More than welcome.
+See [Help & Support »](https://github.com/openfootball/help)

data/Rakefile

@@ -0,0 +1,30 @@
+require 'hoe'
+require './lib/fbup/version.rb'
+
+
+Hoe.spec 'fbup' do
+  self.version = SportDb::Module::Fbup::VERSION
+
+  self.summary = "fbup - (auto-)update machinery for footbal match schedules & more in football.txt; incl. (auto-sync & commit) support for github openfootball repos & more"
+  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.licenses = ['Public Domain']
+
+  self.extra_deps = [
+       ['sportdb-writers', '>= 0.4.0'],
+       ['gitti', '>= 0.6.1'],
+  ]
+
+  self.spec_extras = {
+    required_ruby_version: '>= 3.1.0'
+  }
+end

data/bin/fbup

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/fbup
+##     or
+##   ruby -I fbup/lib fbup/bin/fbup
+
+
+
+require 'fbup'
+
+
+Fbup.main( ARGV )
+
+
+puts "bye"

data/config/openfootball.csv

@@ -0,0 +1,117 @@
+key,  path
+
+at,   austria
+
+de,   deutschland
+eng,  england
+es,   espana
+it,   italy
+
+fr,   europe/france
+
+hu, europe/hungary
+gr, europe/greece
+pt, europe/portugal
+
+ch, europe/switzerland
+
+tr, europe/turkey
+
+is,   europe/iceland
+sco,  europe/scotland
+ie,  europe/ireland
+
+fi,  europe/finland
+se,  europe/sweden
+no,  europe/norway
+dk,  europe/denmark
+
+lu,  europe/luxembourg
+be,  europe/belgium
+nl,  europe/netherlands
+cz,  europe/czech-republic
+
+sk,   europe/slovakia
+hr,  europe/croatia
+pl,   europe/poland
+
+ro,  europe/romania
+
+ua,  europe/ukraine
+
+ru,  europe/russia
+
+
+al,  europe/albania
+ad,  europe/andorra
+by,  europe/belarus
+ba,  europe/bosnia-herzegovina   ## use bosnia-n-herzegovina ??
+bg,  europe/bulgaria
+cy,  europe/cyprus
+ee,  europe/estonia
+lv,  europe/latvia
+li,  europe/liechtenstein
+lt,  europe/lithuania
+mk,  europe/north-macedonia
+mt,  europe/malta
+md,  europe/moldova
+me,  europe/montenegro
+
+sm,  europe/san-marino
+rs,  europe/serbia
+si,  europe/slovenia
+
+xk,  europe/kosovo
+kos, europe/kosovo
+
+am,  europe/armenia
+az,  europe/azerbaijan
+ge,  europe/georgia
+fo,  europe/faroe-islands
+gi,  europe/gibraltar
+
+wal, europe/wales
+nir, europe/northern-ireland
+
+
+
+uefa.cl,      champions-league
+uefa.champs,  champions-league
+uefa.el,      champions-league
+uefa.europa,  champions-league
+uefa.conf,    champions-league
+uefa.con,     champions-league
+
+euro,       euro
+
+
+
+mx, mexico
+
+
+ar, south-america/argentina
+br, south-america/brazil
+co, south-america/colombia
+
+copa.l,  south-america/copa-libertadores
+copa.s,  south-america/copa-libertadores
+
+
+eg,         africa/egypt
+ma,         africa/morocco
+dz,         africa/algeria
+afl,        africa/african-football-league
+caf.cl,     africa/champions-league
+caf.champs, africa/champions-league
+
+
+cn,  world/asia/china
+jp,  world/asia/japan
+
+kz,  world/asia/kazakhstan
+
+il,  world/middle-east/israel
+
+
+
+world,   worldcup

data/lib/fbup/github.rb

@@ -0,0 +1,115 @@
+
+module Fbup
+
+###
+## todo/fix:
+##   add -i/--interactive flag
+##     will prompt yes/no  before git operations (with consequences)!!!
+
+
+
+class GitHubSync
+
+########
+##  (auto)default to Writer.config.out_dir - why? why not?
+##
+##    note - is monotree (that is, requires openfootball/england etc.
+##                  for repo pathspecs)
+def self.root()  @root || "/sports"; end
+def self.root=( dir ) @root = dir; end
+## use root_dir (or add alias) - why? why not?
+
+
+REPOS = GitHubConfig.new
+recs = read_csv( "#{SportDb::Module::Fbup.root}/config/openfootball.csv" )
+REPOS.add( recs )
+
+## note: datasets of format
+##
+## DATASETS = [
+##   ['it.1',    %w[2020/21 2019/20]],
+##  ['it.2',    %w[2019/20]],
+##  ['es.1',    %w[2019/20]],
+##  ['es.2',    %w[2019/20]],
+## ]
+
+def self.find_repos( datasets )
+repos = []
+datasets.each do |league_key, seasons|
+  repo  = REPOS[ league_key ]
+  ## pp repo
+  if repo.nil?
+     puts "!! ERROR - no repo config/path found for league >#{league_key}<; sorry"
+     exit 1
+  end
+
+  repos <<  "#{repo['owner']}/#{repo['name']}"
+end
+
+pp repos
+repos.uniq   ## note: remove duplicates (e.g. europe or world or such)
+end
+
+
+
+def initialize( repos )
+    @repos = repos
+end
+
+
+def git_push_if_changes
+   message = "auto-update week #{Date.today.cweek}"  ## add /#{Date.today.cday - why? why not?
+   puts message
+
+   @repos.each do |pathspec|
+       _git_push_if_changes( pathspec, message: message )
+   end
+end
+
+def git_fast_forward_if_clean
+    @repos.each do |pathspec|
+      _git_fast_forward_if_clean( pathspec )
+    end
+end
+
+
+
+## todo/fix: rename to something like
+##    git_(auto_)commit_and_push_if_changes/if_dirty()
+
+def _git_push_if_changes( pathspec, message: )
+    path = "#{self.class.root}/#{pathspec}"
+
+    Gitti::GitProject.open( path ) do |proj|
+      puts ''
+      puts "###########################################"
+      puts "## trying to commit & push repo in path >#{path}<"
+      puts "Dir.getwd: #{Dir.getwd}"
+      output = proj.changes
+      if output.empty?
+        puts "no changes found; skipping commit & push"
+      else
+        proj.add( '.' )
+        proj.commit( message )
+        proj.push
+      end
+    end
+end
+
+
+def _git_fast_forward_if_clean( pathspec )
+    path = "#{self.class.root}/#{pathspec}"
+
+    Gitti::GitProject.open( path ) do |proj|
+      output = proj.changes
+      unless  output.empty?
+        puts "FAIL - cannot git pull (fast-forward) - working tree has changes:"
+        puts output
+        exit 1
+      end
+
+      proj.fast_forward
+    end
+end
+end  # class GitHub
+end  # module Fbup

data/lib/fbup/github_config.rb

@@ -0,0 +1,97 @@
+
+module Fbup
+class GitHubConfig
+
+  ## map leagues to repo+path
+  ##  e.g.   fr.1   => europe/france
+  ##         eng..1 => england
+  ##
+  ##  for other than openfootball (default)
+  ## use @
+  ##   e.g.    myorg@austria
+  ##           austria@myorg ??
+  ##
+  ##           myorg@europe/france
+  ##            europe/france@myorg
+
+
+def self.read( path )
+    recs = read_csv( path )
+    new( recs )
+end
+
+def initialize( recs=nil )
+    @table = {}
+    add( recs )  if recs
+end
+
+
+def add( recs )
+  recs.each do |rec|
+    path = rec['path']  ## use pathspec - why? why not?
+                        ##  or repospec or such
+
+    ## auto-expand to openfootball as default org if no @ specified
+    owner, path = if path.index( '@')
+                      path.split( '@', 2 )
+                  else
+                      ['openfootball', path ]
+                  end
+    name, path = path.split( '/', 2 )
+
+
+    ## openfootball@europe/france
+    ##    =>
+    ##    owner: openfootball
+    ##    name:  europe
+    ##    path:  france
+    ##
+    ## openfootball@austria
+    ##    =>
+    ##    owner: openfootball
+    ##    name:  austria
+    ##    path:  nil
+    @table[ rec['key'] ] = {  'owner' => owner, ## (required)
+                              'name'  => name,  ## (required)
+                              'path'  => path   ## extra/inner/inside/local path (optional)
+                            }
+  end
+end
+
+
+##
+## todo/fix:
+##   make key lookup more flexible
+##    auto-add more variants!!!
+##       e.g. at.1  AT1, AT or such
+##
+
+## find (full) record by key
+def find( key )
+  key = key.to_s.downcase
+
+  ## first check for 1:1 match
+  rec = @table[key]
+  if rec.nil?
+     ## try match by (country / first) code
+     ##   split by .
+     key, _ = key.split( '.' )
+     rec = @table[key]
+  end
+
+  rec
+end
+alias_method :[], :find  ## keep alias - why? why not?
+
+
+def find_repo( key )
+   rec = _find( key )
+
+   rec ? "#{rec['owner']}/#{rec['name']}" : nil
+end
+
+end # class GitHubConfig
+end # module Fbup
+
+
+

data/lib/fbup/main.rb

@@ -0,0 +1,165 @@
+
+module Fbup
+def self.main( args=ARGV )
+
+opts = {
+  source_path: [],
+  push:     false,
+  ffwd:     false,
+  dry:      false,  ## dry run (no write)
+  test:     true,   ## sets push & ffwd to false
+  debug:    true,
+  file:     nil,
+  test_dir:  './o',
+}
+
+
+parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] [args]"
+
+    parser.on( "-p", "--[no-]push",
+               "fast forward sync and commit & push changes to git repo - default is (#{opts[:push]})" ) do |push|
+      opts[:push] = push
+      if opts[:push]   ## note: autoset ffwd too if push == true
+        opts[:ffwd] = true
+        opts[:test] = false
+      end
+    end
+    ## todo/check - add a --ffwd flag too - why? why not?
+
+    parser.on( "-t", "--test",
+                "test run; writing output to #{opts[:test_dir]} - default is #{opts[:test]}" ) do |test|
+      opts[:test] = true
+      opts[:push] = false
+      opts[:ffwd] = false
+    end
+
+    parser.on( "--dry",
+                "dry run; do NOT write - default is (#{opts[:dry]})" ) do |dry|
+      opts[:dry] = dry
+      opts[:test] = false
+      opts[:push] = false    ### autoset push & ffwd - why? why not?
+      opts[:ffwd] = false
+    end
+
+    parser.on( "-q", "--quiet",
+               "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
+      opts[:debug] = false
+    end
+
+    parser.on( "-I DIR", "--include DIR",
+                "add directory to (source) search path - default is (#{opts[:source_path].join(',')})") do |dir|
+      opts[:source_path] += path
+    end
+
+    parser.on( "-f FILE", "--file FILE",
+                "read leagues (and seasons) via .csv file") do |file|
+      opts[:file] = file
+    end
+end
+parser.parse!( args )
+
+
+if opts[:source_path].empty? &&
+   File.exist?( '/sports/cache.api.fbdat')  &&
+   File.exist?( '/sports/cache.wfb' )
+     opts[:source_path] << '/sports/cache.api.fbdat'
+     opts[:source_path] << '/sports/cache.wfb'
+end
+
+if opts[:source_path].empty?
+  opts[:source_path]  = ['.']   ## use ./ as default
+end
+
+
+
+puts "OPTS:"
+p opts
+puts "ARGV:"
+p args
+
+
+datasets =   if opts[:file]
+                  read_leagueset( opts[:file] )
+             else
+                  parse_leagueset_args( args )
+             end
+
+puts "datasets:"
+pp datasets
+
+
+source_path = opts[:source_path]
+
+root_dir =  if opts[:test]
+               opts[:test_dir]
+            else
+               GitHubSync.root   # e.g. "/sports"
+            end
+
+puts "  (output) root_dir: >#{root_dir}<"
+
+repos = GitHubSync.find_repos( datasets )
+puts "  #{repos.size} repo(s):"
+pp repos
+sync  =  GitHubSync.new( repos )
+
+puts "  sync:"
+pp sync
+
+
+
+sync.git_fast_forward_if_clean    if opts[:ffwd]
+
+### step 0 - validate and fill-in seasons etc.
+datasets.validate!( source_path: source_path )
+
+
+
+datasets.each do |league_key, seasons|
+    puts "==> gen #{league_key} - #{seasons.size} seasons(s)..."
+
+    league_info = find_league_info( league_key )
+    pp league_info
+
+    seasons.each do |season|
+      filename = "#{season.to_path}/#{league_key}.csv"
+      path = find_file( filename, path: source_path )
+
+      ### get matches
+      puts "  ---> reading matches in #{path} ..."
+      matches = SportDb::CsvMatchParser.read( path )
+      puts "     #{matches.size} matches"
+
+      ## build
+      txt = SportDb::TxtMatchWriter.build( matches )
+      puts txt   if opts[:debug]
+
+      league_name  = league_info[ :name ]      # e.g. Brasileiro Série A
+      basename     = league_info[ :basename]   #.e.g  1-seriea
+
+      league_name =  league_name.call( season )   if league_name.is_a?( Proc )  ## is proc/func - name depends on season
+      basename    =  basename.call( season )      if basename.is_a?( Proc )  ## is proc/func - name depends on season
+
+      buf = String.new
+      buf << "= #{league_name} #{season}\n\n"
+      buf << txt
+
+      repo  = GitHubSync::REPOS[ league_key ]
+      repo_path = "#{repo['owner']}/#{repo['name']}"
+      repo_path << "/#{repo['path']}"    if repo['path']  ## note: do NOT forget to add optional extra path!!!
+
+      outpath = "#{root_dir}/#{repo_path}/#{season.to_path}/#{basename}.txt"
+
+      if opts[:dry]
+        puts "   (dry) writing to >#{outpath}<..."
+      else
+        write_text( outpath, buf )
+      end
+    end
+end
+
+sync.git_push_if_changes   if opts[:push]
+
+end  # method self.main
+end  # module Fbup

data/lib/fbup/version.rb

@@ -0,0 +1,24 @@
+
+module SportDb
+module Module
+  module Fbup
+    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
+      "fbup/#{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 Fbup
+end # module Module
+end # module SportDb

data/lib/fbup.rb

@@ -0,0 +1,27 @@
+
+require 'sportdb/writers'
+
+
+require 'optparse'    ## command-line processing; check if included updstream?
+
+########################
+#  push & pull github scripts
+require 'gitti'    ## note - requires git machinery
+
+
+
+###
+# our own code
+require_relative 'fbup/version'
+
+require_relative 'fbup/github_config'
+require_relative 'fbup/github'   ## github helpers/update machinery
+
+
+require_relative 'fbup/main'
+
+
+
+
+
+puts SportDb::Module::Fbup.banner   # say hello

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification
+name: fbup
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2024-12-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sportdb-writers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: gitti
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+- !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: fbup - (auto-)update machinery for footbal match schedules & more in
+  football.txt; incl. (auto-sync & commit) support for github openfootball repos &
+  more
+email: gerald.bauer@gmail.com
+executables:
+- fbup
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- bin/fbup
+- config/openfootball.csv
+- lib/fbup.rb
+- lib/fbup/github.rb
+- lib/fbup/github_config.rb
+- lib/fbup/main.rb
+- lib/fbup/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: fbup - (auto-)update machinery for footbal match schedules & more in football.txt;
+  incl. (auto-sync & commit) support for github openfootball repos & more
+test_files: []