fbtok 0.0.1 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 434d60833636dd403ce4671279c847aa446295236685f264fa31b4791d9cdf82
-  data.tar.gz: 55729c6c2100163e05af42f53121958f7b9442ee15e07af2bfc28a7a94cdb75f
+  metadata.gz: b4ab88883b8f80ee4824cab352297f037e2afcb72351bf6956a8e48bddd5a164
+  data.tar.gz: 6bd75bea2015124e34b01f506757a54a5537ca0544559a0377b6f0a6a0533c0b
 SHA512:
-  metadata.gz: e0694f22d437e9d614070acf083db4c4b522d99fe20c0c53370c6dd59d73107cc9ab7f94b26a049c4f3031f2acbfef2ff64ad0eb447dd6c2a54c34293becc717
-  data.tar.gz: fbe918cfe469447bcc1b77e9bb12a17e6430e6dc1bf5e287637cc0cb8379f606582c9adbfb1e3150609887db26fc7f75506f7faa64ae992f4e7a5487b7d0c16e
+  metadata.gz: 94b3582db70136fdeadeebe003fefdff304ca923bd76edcc0a40d28731c64e73f372b7c0ecf74e58623358102c32ad51e0a233becee4555d5ccd322552d53d80
+  data.tar.gz: dca47c3d3e134ed9c103ba873e76e0c4793d690bbaf6ced8a34693e4c2fea3fc1ff43af0d45ebc62738022f02bb02a0e0bcc04c153dd752a49c7a50d62ba6bba

data/CHANGELOG.md

@@ -1,3 +1,4 @@
+### 0.1.1
 ### 0.0.1 / 2025-01-02
 
 * Everything is new. First release.

data/Manifest.txt

@@ -2,8 +2,10 @@ CHANGELOG.md
 Manifest.txt
 README.md
 Rakefile
+bin/fbchk
+bin/fbt
 bin/fbtok
+bin/fbx
 lib/fbtok.rb
-lib/fbtok/fbtok.rb
 lib/fbtok/linter.rb
 lib/fbtok/opts.rb

data/README.md

@@ -19,6 +19,20 @@ $ gem install fbtok
 
 ## Usage
 
+
+### fbtok -  use tokenizer/parser
+
+- depends on sportdb-parser
+
+### fbt   -  use quick match reader &  fbx   -  dump match schedule  - uses quick league & match readers
+
+- depends on sportdb-quick
+
+### fbchk  -  use quick match linter; check league and team names via search & more
+
+- depends on sportdb-formats (incl. sportdb-search & sportdb-catalogs)
+
+
 ...
 
 

data/Rakefile

@@ -2,7 +2,7 @@ require 'hoe'
 
 
 Hoe.spec 'fbtok' do
-  self.version = '0.0.1'
+  self.version = '0.1.1'
 
   self.summary = "fbtok - football.txt lint tools incl. tokenizer, parser & more"
   self.description = summary
@@ -19,7 +19,10 @@ Hoe.spec 'fbtok' do
   self.licenses = ['Public Domain']
 
   self.extra_deps = [
-       ['sportdb-parser', '>= 0.3.9'],
+     #  ['sportdb-parser',  '>= 0.2.2'],
+     #  ['sportdb-structs', '>= 0.5.0'],
+     #  ['logutils',        '>= 0.6.1'],
+     ['sportdb-formats', '>= 2.1.2'],
   ]
 
   self.spec_extras = {

data/bin/fbchk

@@ -0,0 +1,177 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/fbchk
+
+
+## local hack for debugging
+##   use local versions if present
+$LOAD_PATH.unshift( File.expand_path( '/sports/sportdb/sport.db/sportdb-structs/lib' ))
+$LOAD_PATH.unshift( File.expand_path( '/sports/sportdb/sport.db/sportdb-catalogs/lib' ))
+$LOAD_PATH.unshift( File.expand_path( '/sports/sportdb/sport.db/sportdb-search/lib' ))
+
+
+## our own code
+require 'fbtok'
+
+
+
+## local hack
+##   if exists up-to-date catalog db (use local version NOT built-in)
+catalog_path = '/sports/sportdb/sport.db/catalog/catalog.db'
+if File.exist?( catalog_path )
+  SportDb::Import.config.catalog_path = catalog_path
+end
+
+
+ args = ARGV
+ opts = { debug: false,
+          file:  nil,
+          teams: true,   ## check/lint teams (name errros etc.)
+        }
+
+ parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options]"
+
+##
+## check if git has a offline option?? (use same)
+##             check for other tools - why? why not?
+#    parser.on( "-q", "--quiet",
+#                 "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
+#      opts[:debug] = false
+#    end
+   parser.on( "--verbose", "--debug",
+               "turn on verbose / debug output (default: #{opts[:debug]})" ) do |debug|
+     opts[:debug] = true
+   end
+
+    parser.on( "-f FILE", "--file FILE",
+                    "read datafiles (pathspecs) via .csv file") do |file|
+      opts[:file] = file
+    end
+
+    parser.on( "--[no-]teams",
+                  "turn on/off team name checks (default: #{opts[:teams]})") do |teams|
+      opts[:teams] = teams
+    end
+end
+parser.parse!( args )
+
+
+puts "OPTS:"
+p opts
+puts "ARGV:"
+p args
+
+
+    ## todo/check - use packs or projects or such
+    ##                instead of specs - why? why not?
+    specs = []
+    if opts[:file]
+          recs = read_csv( opts[:file] )
+          pp recs
+          ##  note - make pathspecs relative to passed in file arg!!!
+          basedir = File.dirname( opts[:file] )
+          recs.each do |rec|
+             paths = SportDb::Parser::Opts.find( rec['path'], dir: basedir )
+             specs << [paths, rec]
+          end
+    else
+       paths = if args.empty?
+                 []
+              else
+                ## check for directories
+                ##   and auto-expand
+                SportDb::Parser::Opts.expand_args( args )
+              end
+        specs << [paths, {}]
+    end
+
+
+if opts[:debug]
+   SportDb::QuickMatchLinter.debug = true
+   SportDb::QuickMatchReader.debug = true
+   SportDb::MatchParser.debug      = true
+else
+   SportDb::QuickMatchLinter.debug = false
+   SportDb::QuickMatchReader.debug = false
+   SportDb::MatchParser.debug      = false
+   LogUtils::Logger.root.level = :info
+end
+
+
+  specs.each_with_index do |(paths, rec),i|
+    errors = []
+    paths.each_with_index do |path,j|
+      puts "==> [#{j+1}/#{paths.size}] reading >#{path}<..."
+      quick = SportDb::QuickMatchLinter.new( read_text( path ),
+                                              check_teams: opts[:teams] )
+      matches = quick.parse
+
+
+      if quick.errors?
+        puts "!! #{quick.errors.size} error(s):"
+        pp quick.errors
+
+        quick.errors.each do |err|
+          errors << [ path, *err ]   # note: use splat (*) to add extra values (starting with msg)
+        end
+      end
+      puts "  #{matches.size} match(es)"
+    end
+
+    if errors.size > 0
+      puts
+      puts "!! #{errors.size} PARSE ERRORS in #{paths.size} datafile(s)"
+      pp errors
+    else
+      puts
+      puts "  OK - no parse errors in #{paths.size} datafile(s)"
+    end
+
+     ## add errors to rec via rec['errors'] to allow
+     ##   for further processing/reporting
+     rec['errors'] = errors
+  end
+
+
+
+###
+## generate a report if --file option used
+if opts[:file]
+
+  buf = String.new
+
+  buf << "# fbchk summary report - #{specs.size} dataset(s)\n\n"
+
+  specs.each_with_index do |(paths, rec),i|
+     errors = rec['errors']
+
+     if errors.size > 0
+       buf << "!! #{errors.size} ERROR(S)  "
+     else
+       buf << "   OK          "
+     end
+     buf << "%-20s" % rec['path']
+     buf << " - #{paths.size} datafile(s)"
+     buf << "\n"
+
+     if errors.size > 0
+         buf << errors.pretty_inspect
+         buf << "\n"
+     end
+ end
+
+  puts
+  puts "SUMMARY:"
+  puts buf
+
+  basedir  = File.dirname( opts[:file] )
+  basename = File.basename( opts[:file], File.extname( opts[:file] ))
+  outpath  = "#{basedir}/fbcheck.#{basename}.txt"
+  write_text( outpath, buf )
+end
+
+
+puts "bye"
+

data/bin/fbt

@@ -0,0 +1,167 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/fbt
+##     -or-
+##   ruby -I ../parser/lib -I ./lib bin/fbt
+##     -or-
+##   ruby -I ../parser/lib -I ../sportdb-structs/lib -I ./lib bin/fbt
+
+
+## our own code
+require 'fbtok'
+
+
+##
+## read textfile
+##   and dump tokens
+##
+##   fbt  ../openfootball/.../euro.txt
+
+
+
+
+ args = ARGV
+ opts = { debug: false,
+          file:  nil,
+        }
+
+ parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options]"
+
+##
+## check if git has a offline option?? (use same)
+##             check for other tools - why? why not?
+#    parser.on( "-q", "--quiet",
+#                 "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
+#      opts[:debug] = false
+#    end
+   parser.on( "--verbose", "--debug",
+               "turn on verbose / debug output (default: #{opts[:debug]})" ) do |debug|
+     opts[:debug] = true
+   end
+
+    parser.on( "-f FILE", "--file FILE",
+                    "read datafiles (pathspecs) via .csv file") do |file|
+      opts[:file] = file
+    end
+
+
+end
+parser.parse!( args )
+
+puts "OPTS:"
+p opts
+puts "ARGV:"
+p args
+
+
+    ## todo/check - use packs or projects or such
+    ##                instead of specs - why? why not?
+    specs = []
+    if opts[:file]
+          recs = read_csv( opts[:file] )
+          pp recs
+          ##  note - make pathspecs relative to passed in file arg!!!
+          basedir = File.dirname( opts[:file] )
+          recs.each do |rec|
+             paths = SportDb::Parser::Opts.find( rec['path'], dir: basedir )
+             specs << [paths, rec]
+          end
+    else
+       paths = if args.empty?
+                 [
+                   '../../../openfootball/euro/2021--europe/euro.txt',
+                   '../../../openfootball/euro/2024--germany/euro.txt',
+                 ]
+              else
+                ## check for directories
+                ##   and auto-expand
+                SportDb::Parser::Opts.expand_args( args )
+              end
+        specs << [paths, {}]
+    end
+
+
+if opts[:debug]
+   SportDb::QuickMatchReader.debug = true
+   SportDb::MatchParser.debug      = true
+else
+   SportDb::QuickMatchReader.debug = false
+   SportDb::MatchParser.debug      = false
+   LogUtils::Logger.root.level = :info
+end
+
+
+  specs.each_with_index do |(paths, rec),i|
+    errors = []
+    paths.each_with_index do |path,j|
+      puts "==> [#{j+1}/#{paths.size}] reading >#{path}<..."
+      quick = SportDb::QuickMatchReader.new( read_text( path ) )
+      matches = quick.parse
+
+      if quick.errors?
+        puts "!! #{quick.errors.size} error(s):"
+        pp quick.errors
+
+        quick.errors.each do |err|
+          errors << [ path, *err ]   # note: use splat (*) to add extra values (starting with msg)
+        end
+      end
+      puts "  #{matches.size} match(es)"
+    end
+
+    if errors.size > 0
+      puts
+      puts "!! #{errors.size} PARSE ERRORS in #{paths.size} datafile(s)"
+      pp errors
+    else
+      puts
+      puts "  OK - no parse errors in #{paths.size} datafile(s)"
+    end
+
+     ## add errors to rec via rec['errors'] to allow
+     ##   for further processing/reporting
+     rec['errors'] = errors
+  end
+
+
+
+###
+## generate a report if --file option used
+if opts[:file]
+
+  buf = String.new
+
+  buf << "# fbt summary report - #{specs.size} dataset(s)\n\n"
+
+  specs.each_with_index do |(paths, rec),i|
+     errors = rec['errors']
+
+     if errors.size > 0
+       buf << "!! #{errors.size} ERROR(S)  "
+     else
+       buf << "   OK          "
+     end
+     buf << "%-20s" % rec['path']
+     buf << " - #{paths.size} datafile(s)"
+     buf << "\n"
+
+     if errors.size > 0
+         buf << errors.pretty_inspect
+         buf << "\n"
+     end
+ end
+
+  puts
+  puts "SUMMARY:"
+  puts buf
+
+  #  maybe write out in the future?
+  # basedir  = File.dirname( opts[:file] )
+  # basename = File.basename( opts[:file], File.extname( opts[:file] ))
+end
+
+
+puts "bye"
+

data/bin/fbtok

@@ -5,9 +5,141 @@
 
 require 'fbtok'
 
+args = ARGV
+ 
 
-Fbtok.main( ARGV )
+opts = {
+    debug: true,
+    metal: false,
+    file:  nil,
+}
 
+parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] PATH"
+
+
+  parser.on( "-q", "--quiet",
+             "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
+    opts[:debug] = false
+  end
+  parser.on( "--verbose", "--debug",
+               "turn on verbose / debug output (default: #{opts[:debug]})" ) do |debug|
+    opts[:debug] = true
+  end
+
+  parser.on( "--metal",
+                 "turn off typed parse tree; show to the metal tokens"+
+                   " (default: #{opts[:metal]})" ) do |metal|
+    opts[:metal] = true
+  end
+
+  parser.on( "-f FILE", "--file FILE",
+                "read datafiles (pathspecs) via .csv file") do |file|
+    opts[:file] = file
+    ## note: for batch (massive) processing auto-set debug (verbose output) to false (as default)
+    opts[:debug] = false
+  end
+end
+parser.parse!( args )
+
+puts "OPTS:"
+p opts
+puts "ARGV:"
+p args
+
+
+## todo/check - use packs or projects or such
+##                instead of specs - why? why not?
+specs = []
+if opts[:file]
+      recs = read_csv( opts[:file] )
+      pp recs
+      ##  note - make pathspecs relative to passed in file arg!!!
+      basedir = File.dirname( opts[:file] )
+      recs.each do |rec|
+         paths = SportDb::Parser::Opts.find( rec['path'], dir: basedir )
+         specs << [paths, rec]
+      end
+else
+   paths = if args.empty?
+             [
+               '../../../openfootball/euro/2021--europe/euro.txt',
+               '../../../openfootball/euro/2024--germany/euro.txt',
+             ]
+          else
+            ## check for directories
+            ##   and auto-expand
+            SportDb::Parser::Opts.expand_args( args )
+          end
+    specs << [paths, {}]
+end
+
+
+SportDb::Parser::Linter.debug = true    if opts[:debug]
+
+linter = SportDb::Parser::Linter.new
+
+
+specs.each_with_index do |(paths, rec),i|
+   errors = []
+
+   paths.each_with_index do |path,j|
+      puts "==> [#{j+1}/#{paths.size}] reading >#{path}<..."
+      linter.read( path, parse: !opts[:metal] )
+
+      errors += linter.errors    if linter.errors?
+   end
+
+   if errors.size > 0
+      puts
+      pp errors
+      puts
+      puts "!!   #{errors.size} parse error(s) in #{paths.size} datafiles(s)"
+   else
+      puts
+      puts "OK   no parse errors found in #{paths.size} datafile(s)"
+   end
+
+   ## add errors to rec via rec['errors'] to allow
+   ##   for further processing/reporting
+   rec['errors'] = errors
+end
+
+
+###
+## generate a report if --file option used
+if opts[:file]
+
+buf = String.new
+
+buf << "# fbtok summary report - #{specs.size} dataset(s)\n\n"
+
+specs.each_with_index do |(paths, rec),i|
+ errors = rec['errors']
+
+ if errors.size > 0
+   buf << "!! #{errors.size} ERROR(S)  "
+ else
+   buf << "   OK          "
+ end
+ buf << "%-20s" % rec['path']
+ buf << " - #{paths.size} datafile(s)"
+ buf << "\n"
+
+ if errors.size > 0
+     buf << errors.pretty_inspect
+     buf << "\n"
+ end
+end
+
+puts
+puts "SUMMARY:"
+puts buf
+
+#  maybe write out in the future?
+# basedir  = File.dirname( opts[:file] )
+# basename = File.basename( opts[:file], File.extname( opts[:file] ))
+end
 
 puts "bye"
 

data/bin/fbx

@@ -0,0 +1,149 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib -I ../parser/lib bin/fbx
+
+##
+## todo/fix - use for testing
+#                reads textfile and dumps results in json
+#
+#  check - keep fbx name or find a differnt name - why? why not?
+
+
+## our own code
+require 'fbtok'
+
+
+##
+## read textfile
+##   and dump match parse results
+##
+##   fbt  ../openfootball/.../euro.txt
+
+
+
+
+ args = ARGV
+ opts = { debug: false,
+          outline: false }
+
+ parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options]"
+
+##
+## check if git has a offline option?? (use same)
+##             check for other tools - why? why not?
+
+
+  parser.on( "--verbose", "--debug",
+               "turn on verbose / debug output (default: #{opts[:debug]})" ) do |debug|
+    opts[:debug] = debug
+  end
+
+  parser.on( "--outline",
+                "turn on outline (only) output (default: #{opts[:outline]})" ) do |outline|
+    opts[:outline] = outline
+  end
+end
+parser.parse!( args )
+
+puts "OPTS:"
+p opts
+puts "ARGV:"
+p args
+
+
+
+
+
+paths =  if args.empty?
+            [
+              '../../../openfootball/euro/2021--europe/euro.txt',
+              '../../../openfootball/euro/2024--germany/euro.txt',
+            ]
+         else
+            ## check for directories
+            ##   and auto-expand
+
+            SportDb::Parser::Opts.expand_args( args )
+         end
+
+
+
+
+
+
+
+SportDb::MatchParser.debug = true    if opts[:debug]
+
+
+## errors = []
+
+
+paths.each_with_index do |path,i|
+    puts "==> [#{i+1}/#{paths.size}] reading >#{path}<..."
+
+    txt = read_text( path )
+    secs = SportDb::QuickLeagueOutlineReader.parse( txt )
+    ## pp secs
+
+    secs.each_with_index do |sec,j|   ## sec(tion)s
+      season = sec[:season]
+      league = sec[:league]
+      stage  = sec[:stage]
+      lines  = sec[:lines]
+
+      puts "   section #{j+1}/#{secs.size} -   #{league.name} #{season}, #{stage}  -  #{lines.size} line(s)"
+
+      next if opts[:outline]
+
+=begin
+    ### check if event info availabe - use start_date;
+      ##    otherwise we have to guess (use a "synthetic" start_date)
+      event_info = catalog.events.find_by( season: season,
+                                           league: league )
+
+      start = if event_info && event_info.start_date
+                  puts "event info found:"
+                  puts "  using start date from event: "
+                  pp event_info
+                  pp event_info.start_date
+                  event_info.start_date
+              else
+=end
+     start  =   if season.year?
+                  Date.new( season.start_year, 1, 1 )
+                else
+                  Date.new( season.start_year, 7, 1 )
+                end
+
+      parser = SportDb::MatchParser.new( lines,
+                                         start )   ## note: keep season start_at date for now (no need for more specific stage date need for now)
+
+      auto_conf_teams,  matches, rounds, groups = parser.parse
+
+      puts ">>> #{auto_conf_teams.size} teams:"
+      pp auto_conf_teams
+      puts ">>> #{matches.size} matches:"
+      ## pp matches
+      puts ">>> #{rounds.size} rounds:"
+      pp rounds
+      puts ">>> #{groups.size} groups:"
+      pp groups
+    end  # each secs
+end  # each paths
+
+=begin
+if errors.size > 0
+    puts
+    pp errors
+    puts
+    puts "!!   #{errors.size} parse error(s) in #{paths.size} datafiles(s)"
+else
+    puts
+    puts "OK   no parse errors found in #{paths.size} datafile(s)"
+end
+=end
+
+puts "bye"
+

data/lib/fbtok.rb

@@ -1,9 +1,13 @@
 
-require 'sportdb/parser'
+require 'sportdb/formats'
+
+
+## more stdlibs
+require 'optparse'   ## check - already auto-required in cocos? keep? why? why not?
 
 
 ## our own code
 require_relative 'fbtok/opts'
-require_relative 'fbtok/fbtok'
+require_relative 'fbtok/linter'
 
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fbtok
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.1
 platform: ruby
 authors:
 - Gerald Bauer
@@ -11,19 +11,19 @@ cert_chain: []
 date: 2025-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: sportdb-parser
+  name: sportdb-formats
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 2.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.9
+        version: 2.1.2
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -61,7 +61,10 @@ dependencies:
 description: fbtok - football.txt lint tools incl. tokenizer, parser & more
 email: gerald.bauer@gmail.com
 executables:
+- fbchk
+- fbt
 - fbtok
+- fbx
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
@@ -72,9 +75,11 @@ files:
 - Manifest.txt
 - README.md
 - Rakefile
+- bin/fbchk
+- bin/fbt
 - bin/fbtok
+- bin/fbx
 - lib/fbtok.rb
-- lib/fbtok/fbtok.rb
 - lib/fbtok/linter.rb
 - lib/fbtok/opts.rb
 homepage: https://github.com/sportdb/footty

data/lib/fbtok/fbtok.rb

@@ -1,141 +0,0 @@
-
-module Fbtok
-def self.main( args=ARGV )
-
-    opts = {
-        debug: true,
-        metal: false,
-        file:  nil,
-    }
-
-    parser = OptionParser.new do |parser|
-      parser.banner = "Usage: #{$PROGRAM_NAME} [options] PATH"
-
-
-      parser.on( "-q", "--quiet",
-                 "less debug output/messages - default is (#{!opts[:debug]})" ) do |debug|
-        opts[:debug] = false
-      end
-      parser.on( "--verbose", "--debug",
-                   "turn on verbose / debug output (default: #{opts[:debug]})" ) do |debug|
-        opts[:debug] = true
-      end
-
-      parser.on( "--metal",
-                     "turn off typed parse tree; show to the metal tokens"+
-                       " (default: #{opts[:metal]})" ) do |metal|
-        opts[:metal] = true
-      end
-
-      parser.on( "-f FILE", "--file FILE",
-                    "read datafiles (pathspecs) via .csv file") do |file|
-        opts[:file] = file
-        ## note: for batch (massive) processing auto-set debug (verbose output) to false (as default)
-        opts[:debug] = false
-      end
-    end
-    parser.parse!( args )
-
-    puts "OPTS:"
-    p opts
-    puts "ARGV:"
-    p args
-
-
-    ## todo/check - use packs or projects or such
-    ##                instead of specs - why? why not?
-    specs = []
-    if opts[:file]
-          recs = read_csv( opts[:file] )
-          pp recs
-          ##  note - make pathspecs relative to passed in file arg!!!
-          basedir = File.dirname( opts[:file] )
-          recs.each do |rec|
-             paths = SportDb::Parser::Opts.find( rec['path'], dir: basedir )
-             specs << [paths, rec]
-          end
-    else
-       paths = if args.empty?
-                 [
-                   '../../../openfootball/euro/2021--europe/euro.txt',
-                   '../../../openfootball/euro/2024--germany/euro.txt',
-                 ]
-              else
-                ## check for directories
-                ##   and auto-expand
-                SportDb::Parser::Opts.expand_args( args )
-              end
-        specs << [paths, {}]
-    end
-
-
-    SportDb::Parser::Linter.debug = true    if opts[:debug]
-
-    linter = SportDb::Parser::Linter.new
-
-
-    specs.each_with_index do |(paths, rec),i|
-       errors = []
-
-       paths.each_with_index do |path,j|
-          puts "==> [#{j+1}/#{paths.size}] reading >#{path}<..."
-          linter.read( path, parse: !opts[:metal] )
-
-          errors += linter.errors    if linter.errors?
-       end
-
-       if errors.size > 0
-          puts
-          pp errors
-          puts
-          puts "!!   #{errors.size} parse error(s) in #{paths.size} datafiles(s)"
-       else
-          puts
-          puts "OK   no parse errors found in #{paths.size} datafile(s)"
-       end
-
-       ## add errors to rec via rec['errors'] to allow
-       ##   for further processing/reporting
-       rec['errors'] = errors
-    end
-
-
-###
-## generate a report if --file option used
-if opts[:file]
-
-  buf = String.new
-
-  buf << "# fbtok summary report - #{specs.size} dataset(s)\n\n"
-
-  specs.each_with_index do |(paths, rec),i|
-     errors = rec['errors']
-
-     if errors.size > 0
-       buf << "!! #{errors.size} ERROR(S)  "
-     else
-       buf << "   OK          "
-     end
-     buf << "%-20s" % rec['path']
-     buf << " - #{paths.size} datafile(s)"
-     buf << "\n"
-
-     if errors.size > 0
-         buf << errors.pretty_inspect
-         buf << "\n"
-     end
- end
-
-  puts
-  puts "SUMMARY:"
-  puts buf
-
-  #  maybe write out in the future?
-  # basedir  = File.dirname( opts[:file] )
-  # basename = File.basename( opts[:file], File.extname( opts[:file] ))
-end
-
-
-
-end  # method self.main
-end  #  module Fbtok