fbtok 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2f0738b7fe70aa6b73cb62e99c6319fe782be09aca0f73f7891a037b98ba020
-  data.tar.gz: b801c24152bac941a766f1340409e3a32aeefb69a217bff94f7f86953749d2b1
+  metadata.gz: a133154bf34937e2961a05a9f3768e92cd2e4d633e64f2a52977e7eb3a7d4ae3
+  data.tar.gz: 382ba42bb20a0038f9efeec721481d70efc41c6241a209da5ea9e2a1fb177ac1
 SHA512:
-  metadata.gz: 406113d724520254adf88aedbe49a6a11ea46aaeaebe85666f2a7a78ea1712936508db4b27bdda928436551d64f52503bc7c9cf98aef464af3cb200917ff324d
-  data.tar.gz: 9e5d237e6d3344b5c4ffb005d5d0c32d40003933ed99594d5e7a6480b6779254f92a15bfde8c4cc6b8b67feb39f4e40e8489d8cae009708eccccbf13b05fdc6b
+  metadata.gz: 800048bae44e60c94fc87073a029075d3e8d88c620ecbc3b2b4217939b4a42b40d57f855e50b60f8fe52c37593a8fe30ce786ed98169bdf87b3f64e7d1987016
+  data.tar.gz: '0921aa61b66e4ca43c1a9643dbe951ad9fcb0bba493bc9d93c2c5ce9ef099629694323b003be701970364d2b05008826a52699d1a7759be301da48ae463db76a'

data/CHANGELOG.md

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

data/Manifest.txt

@@ -3,8 +3,13 @@ Manifest.txt
 README.md
 Rakefile
 bin/fbquick
+bin/fbquik
 bin/fbtok
 bin/fbtree
 bin/fbx
 lib/fbtok.rb
+lib/fbtok/fbquick.rb
+lib/fbtok/fbtok.rb
+lib/fbtok/fbtree.rb
+lib/fbtok/fbx.rb
 lib/fbtok/pathspec.rb

data/README.md

@@ -51,30 +51,29 @@ $ fbtree worldcup
 
 
 
-### fbquick & fbx   -  use quick match reader & dump match schedule
+### fbquick/fbquik & fbx   -  use quick match reader & dump match schedule
 
 - depends on sportdb-quick (& sportdb-parser)
 
 get help
 ```
-$ fbquick -h
+$ fbquik -h
 $ fbx -h
 ```
 
 run on single / individual (data)files
 ````
-$ fbquick england/2025-26/1-permierleague.txt
-$ fbquick worldcup/min/2022.txt
+$ fbquik england/2025-26/1-permierleague.txt
+$ fbquik worldcup/min/2022.txt
 
 $ fbx england/2025-26/1-permierleague.txt
 $ fbx worldcup/min/2022.txt
-
 ```
 
 or on directories (auto-collecting all datafiles)
 
-$ fbquick england
-$ fbquick worldcup
+$ fbquik england
+$ fbquik worldcup
 ```
 
 note: `fbx` only works with single / individual (data)files

data/Rakefile

@@ -2,7 +2,7 @@ require 'hoe'
 
 
 Hoe.spec 'fbtok' do
-  self.version = '0.4.0'
+  self.version = '0.4.1'
 
   self.summary = "fbtok - football.txt lint tools incl. tokenizer, parser & more"
   self.description = summary

data/bin/fbquick

@@ -7,130 +7,9 @@
 ##     -or-
 ##   $ ruby -I ../parser/lib -I ../quick/lib -I ./lib bin/fbquick
 
-##
-## todo/fix - add (shortcut) alias  fbquik,fbqk - why? why not?
-
 
 ## our own code
 require 'fbtok'
 
 
-
-
- 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 )
-
-
-
-if opts[:debug]
-  puts "OPTS:"
-  p opts
-  puts "ARGV:"
-  p args
-
-  SportDb::QuickMatchReader.debug = true
-  SportDb::MatchParser.debug      = true
-else
-  SportDb::QuickMatchReader.debug = false
-  SportDb::MatchParser.debug      = false
-  LogUtils::Logger.root.level = :info
-end
-
-
-## todo/check - use packs or projects or such
-##                instead of specs - why? why not?
-specs =  if opts[:file]
-            read_pathspecs( opts[:file] )
-         else
-           args =     ['/sports/openfootball/euro/2021--europe/euro.txt',
-                       '/sports/openfootball/euro/2024--germany/euro.txt']  if args.empty?
-
-            build_pathspecs( args )
-         end
-
-pp specs
-
-
-
-  specs.each_with_index do |rec,i|
-    datafiles = rec['datafiles']
-    errors = []
-
-    datafiles.each_with_index do |path,j|
-      puts "==> [#{i+1}/#{specs.size}, #{j+1}/#{datafiles.size}] reading >#{path}<..."
-      txt = read_text( path )
-      quick = SportDb::QuickMatchReader.new( txt )
-      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 #{datafiles.size} datafile(s)"
-      pp errors
-    else
-      puts
-      puts "  OK - no parse errors in #{datafiles.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 = SportDb::PathspecReport.new(
-            specs,
-            title: 'fbquick summary report' ).build
-
-  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"
+Fbquick.main

data/bin/fbquik

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   $ ruby -I ./lib bin/fbquik
+
+
+## our own code
+require 'fbtok'
+
+
+Fbquick.main

data/bin/fbtok

@@ -5,123 +5,5 @@
 
 require 'fbtok'
 
-args = ARGV
 
-
-opts = {
-    debug: true,
-    warn:  false,
-    file:  nil,
-}
-
-parser = OptionParser.new do |parser|
-  parser.banner = "Usage: #{$PROGRAM_NAME} [options] PATH"
-
-
-  parser.on( "-q", "--quiet",
-             "less debug output/messages (default: #{!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( "-w", "--warn",
-              "turn warnings into errors (default: #{opts[:warn]})" ) do |warn|
-    opts[:warn] = 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 )
-
-
-
-if opts[:debug]
-  puts "OPTS:"
-  p opts
-  puts "ARGV:"
-  p args
-end
-
-
-# SportDb::Parser::Linter.debug = opts[:debug]
-# SportDb::Parser::Linter.warn  = opts[:warn]
-
-
-
-## todo/check - use packs or projects or such
-##                instead of specs - why? why not?
-specs =  if opts[:file]
-            read_pathspecs( opts[:file] )
-         else
-           args = ['/sports/openfootball/euro/2021--europe/euro.txt',
-                   '/sports/openfootball/euro/2024--germany/euro.txt']  if args.empty?
-
-            build_pathspecs( args )
-         end
-
-
-pp specs
-
-
-
-specs.each_with_index do |rec,i|
-    datafiles = rec['datafiles']
-
-    errors = []
-
-    datafiles.each_with_index do |path,j|
-      puts "==> [#{i+1}/#{specs.size}, #{j+1}/#{datafiles.size}] reading >#{path}<..."
-
-      txt = read_text( path )
-      lexer = SportDb::Lexer.new( txt, debug: opts[:debug] )
-      tokens, more_errors = lexer.tokenize_with_errors
-
-      ####
-      ## todo - report error on empty file (no tokens!!!)
-
-      puts "   #{tokens.size} token(s)"
-
-      errors += more_errors    if more_errors.size > 0
-   end
-
-   if errors.size > 0
-      puts
-      pp errors
-      puts
-      puts "!!   #{errors.size} tokenize error(s) in #{datafiles.size} datafiles(s)"
-   else
-      puts
-      puts "OK   no tokenize errors found in #{datafiles.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 = SportDb::PathspecReport.new(
-            specs,
-            title: 'fbtok summary report' ).build
-
-  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"
+Fbtok.main

data/bin/fbtree

@@ -5,138 +5,4 @@
 
 require 'fbtok'
 
-args = ARGV
-
-
-opts = {
-    debug: true,
-    warn:  false,
-    file:  nil,
-}
-
-parser = OptionParser.new do |parser|
-  parser.banner = "Usage: #{$PROGRAM_NAME} [options] PATH"
-
-
-  parser.on( "-q", "--quiet",
-             "less debug output/messages (default: #{!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( "-w", "--warn",
-              "turn warnings into errors (default: #{opts[:warn]})" ) do |warn|
-    opts[:warn] = 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 )
-
-
-if opts[:debug]
-  puts "OPTS:"
-  p opts
-  puts "ARGV:"
-  p args
-end
-
-
-# SportDb::Parser::Linter.debug = opts[:debug]
-# SportDb::Parser::Linter.warn  = opts[:warn]
-
-
-
-
-## todo/check - use packs or projects or such
-##                instead of specs - why? why not?
-specs =  if opts[:file]
-            read_pathspecs( opts[:file] )
-         else
-           args = ['/sports/openfootball/euro/2021--europe/euro.txt',
-                   '/sports/openfootball/euro/2024--germany/euro.txt']  if args.empty?
-
-            build_pathspecs( args )
-         end
-
-
-
-def dump_tree_stats( tree )
-  stats = Hash.new(0)  ## track counts only for now
-  tree.each do |node|
-     stats[ node.class ] += 1
-  end
-
-  match_count  = stats[ RaccMatchParser::MatchLine ]
-  goal_count   = stats[ RaccMatchParser::GoalLine ]
-  lineup_count = stats[ RaccMatchParser::LineupLine ]
-
-  puts "   #{match_count} MatchLine(s)"     if match_count > 0
-  puts "   #{goal_count} GoalLine(s)"       if goal_count > 0
-  puts "   #{lineup_count} LineupLine(s)"   if lineup_count > 0
-end
-
-
-
-
-
-specs.each_with_index do |rec,i|
-    datafiles = rec['datafiles']
-
-    errors = []
-
-   datafiles.each_with_index do |path,j|
-      puts "==> [#{i+1}/#{specs.size}, #{j+1}/#{datafiles.size}] reading >#{path}<..."
-
-      txt = read_text( path )
-      parser = RaccMatchParser.new( txt, debug: opts[:debug] )
-      tree = parser.parse
-
-      dump_tree_stats( tree )
-
-      errors += parser.errors    if parser.errors?
-   end
-
-   if errors.size > 0
-      puts
-      pp errors
-      puts
-      puts "!!   #{errors.size} parse error(s) in #{datafiles.size} datafiles(s)"
-   else
-      puts
-      puts "OK   no parse errors found in #{datafiles.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 = SportDb::PathspecReport.new(
-            specs,
-            title: 'fbtree summary report' ).build
-
-  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"
+Fbtree.main

data/bin/fbx

@@ -1,110 +1,11 @@
 #!/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?
+##   $ ruby -I ./lib  bin/fbx
 
 
 ## 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 )
-
-
-if opts[:debug]
-  puts "OPTS:"
-  p opts
-  puts "ARGV:"
-  p args
-
-  SportDb::MatchParser.debug = true
-else
-  SportDb::MatchParser.debug = false
-  LogUtils::Logger.root.level = :info
-end
-
-
-args =  [
-              '../../../openfootball/euro/2021--europe/euro.txt',
-              '../../../openfootball/euro/2024--germany/euro.txt',
-        ]   if args.empty?
-
-pp args
-
-
-paths = args
-
-
-## errors = []
-
-
-paths.each_with_index do |path,i|
-    puts "==> [#{i+1}/#{paths.size}] reading >#{path}<..."
-
-    txt = read_text( path )
-
-    parser = SportDb::MatchParser.new( txt, start: nil )
-
-    auto_conf_teams, matches, rounds, groups = parser.parse
-
-      puts ">>> #{auto_conf_teams.size} teams:"
-      pp auto_conf_teams
-      puts ">>> #{matches.size} matches:"
-      pp matches[0,2]   ## print first two matches
-      puts "..."
-      puts ">>> #{rounds.size} rounds:"
-      pp rounds
-      puts ">>> #{groups.size} groups:"
-      pp groups
-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"
+Fbx.main

data/lib/fbtok/fbquick.rb

@@ -0,0 +1,123 @@
+
+module Fbquick
+
+
+def self.main( args=ARGV )
+
+ opts = { debug: false,
+          file:  nil,
+        }
+
+ parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] DATAFILE or DIR"
+
+##
+## 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 )
+
+
+
+if opts[:debug]
+  puts "OPTS:"
+  p opts
+  puts "ARGV:"
+  p args
+
+  SportDb::QuickMatchReader.debug = true
+  SportDb::MatchParser.debug      = true
+else
+  SportDb::QuickMatchReader.debug = false
+  SportDb::MatchParser.debug      = false
+  LogUtils::Logger.root.level = :info
+end
+
+
+## todo/check - use packs or projects or such
+##                instead of specs - why? why not?
+specs =  if opts[:file]
+            read_pathspecs( opts[:file] )
+         else
+           args =     ['/sports/openfootball/euro/2021--europe/euro.txt',
+                       '/sports/openfootball/euro/2024--germany/euro.txt']  if args.empty?
+
+            build_pathspecs( args )
+         end
+
+pp specs
+
+
+
+  specs.each_with_index do |rec,i|
+    datafiles = rec['datafiles']
+    errors = []
+
+    datafiles.each_with_index do |path,j|
+      puts "==> [#{i+1}/#{specs.size}, #{j+1}/#{datafiles.size}] reading >#{path}<..."
+      txt = read_text( path )
+      quick = SportDb::QuickMatchReader.new( txt )
+      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 #{datafiles.size} datafile(s)"
+      pp errors
+    else
+      puts
+      puts "  OK - no parse errors in #{datafiles.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 = SportDb::PathspecReport.new(
+            specs,
+            title: 'fbquick summary report' ).build
+
+  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"
+end
+
+end  # module Fbquick

data/lib/fbtok/fbtok.rb

@@ -0,0 +1,127 @@
+
+module Fbtok
+
+
+def self.main( args=ARGV )
+
+opts = {
+    debug: true,
+    warn:  false,
+    file:  nil,
+}
+
+
+parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] DATAFILE or DIR"
+
+
+  parser.on( "-q", "--quiet",
+             "less debug output/messages (default: #{!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( "-w", "--warn",
+              "turn warnings into errors (default: #{opts[:warn]})" ) do |warn|
+    opts[:warn] = 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 )
+
+
+
+if opts[:debug]
+  puts "OPTS:"
+  p opts
+  puts "ARGV:"
+  p args
+end
+
+
+# SportDb::Parser::Linter.debug = opts[:debug]
+# SportDb::Parser::Linter.warn  = opts[:warn]
+
+
+
+## todo/check - use packs or projects or such
+##                instead of specs - why? why not?
+specs =  if opts[:file]
+            read_pathspecs( opts[:file] )
+         else
+           args = ['/sports/openfootball/euro/2021--europe/euro.txt',
+                   '/sports/openfootball/euro/2024--germany/euro.txt']  if args.empty?
+
+            build_pathspecs( args )
+         end
+
+
+pp specs
+
+
+
+specs.each_with_index do |rec,i|
+    datafiles = rec['datafiles']
+
+    errors = []
+
+    datafiles.each_with_index do |path,j|
+      puts "==> [#{i+1}/#{specs.size}, #{j+1}/#{datafiles.size}] reading >#{path}<..."
+
+      txt = read_text( path )
+      lexer = SportDb::Lexer.new( txt, debug: opts[:debug] )
+      tokens, more_errors = lexer.tokenize_with_errors
+
+      ####
+      ## todo - report error on empty file (no tokens!!!)
+
+      puts "   #{tokens.size} token(s)"
+
+      errors += more_errors    if more_errors.size > 0
+   end
+
+   if errors.size > 0
+      puts
+      pp errors
+      puts
+      puts "!!   #{errors.size} tokenize error(s) in #{datafiles.size} datafiles(s)"
+   else
+      puts
+      puts "OK   no tokenize errors found in #{datafiles.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 = SportDb::PathspecReport.new(
+            specs,
+            title: 'fbtok summary report' ).build
+
+  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"
+
+end  # self.main
+end  # module Fbtok

data/lib/fbtok/fbtree.rb

@@ -0,0 +1,141 @@
+
+module Fbtree
+
+def self.main( args=ARGV )
+
+
+opts = {
+    debug: true,
+    warn:  false,
+    file:  nil,
+}
+
+parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] DATAFILE or DIR"
+
+
+  parser.on( "-q", "--quiet",
+             "less debug output/messages (default: #{!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( "-w", "--warn",
+              "turn warnings into errors (default: #{opts[:warn]})" ) do |warn|
+    opts[:warn] = 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 )
+
+
+if opts[:debug]
+  puts "OPTS:"
+  p opts
+  puts "ARGV:"
+  p args
+end
+
+
+# SportDb::Parser::Linter.debug = opts[:debug]
+# SportDb::Parser::Linter.warn  = opts[:warn]
+
+
+
+
+## todo/check - use packs or projects or such
+##                instead of specs - why? why not?
+specs =  if opts[:file]
+            read_pathspecs( opts[:file] )
+         else
+           args = ['/sports/openfootball/euro/2021--europe/euro.txt',
+                   '/sports/openfootball/euro/2024--germany/euro.txt']  if args.empty?
+
+            build_pathspecs( args )
+         end
+
+
+
+
+specs.each_with_index do |rec,i|
+    datafiles = rec['datafiles']
+
+    errors = []
+
+   datafiles.each_with_index do |path,j|
+      puts "==> [#{i+1}/#{specs.size}, #{j+1}/#{datafiles.size}] reading >#{path}<..."
+
+      txt = read_text( path )
+      parser = RaccMatchParser.new( txt, debug: opts[:debug] )
+      tree = parser.parse
+
+      dump_tree_stats( tree )
+
+      errors += parser.errors    if parser.errors?
+   end
+
+
+   if errors.size > 0
+      puts
+      pp errors
+      puts
+      puts "!!   #{errors.size} parse error(s) in #{datafiles.size} datafiles(s)"
+   else
+      puts
+      puts "OK   no parse errors found in #{datafiles.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 = SportDb::PathspecReport.new(
+            specs,
+            title: 'fbtree summary report' ).build
+
+  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"
+end
+
+
+def self.dump_tree_stats( tree )
+  stats = Hash.new(0)  ## track counts only for now
+  tree.each do |node|
+     stats[ node.class ] += 1
+  end
+
+  match_count  = stats[ RaccMatchParser::MatchLine ]
+  goal_count   = stats[ RaccMatchParser::GoalLine ]
+  lineup_count = stats[ RaccMatchParser::LineupLine ]
+
+  puts "   #{match_count} MatchLine(s)"     if match_count > 0
+  puts "   #{goal_count} GoalLine(s)"       if goal_count > 0
+  puts "   #{lineup_count} LineupLine(s)"   if lineup_count > 0
+end
+
+
+end # module Fbtree

data/lib/fbtok/fbx.rb

@@ -0,0 +1,107 @@
+##
+## todo/fix - use for testing
+#                reads textfile and dumps results in json
+#
+#  check - keep fbx name or find a differnt name - why? why not?
+
+##
+## read textfile
+##   and dump match parse results
+##
+##   fbt  ../openfootball/.../euro.txt
+
+
+
+module Fbx
+
+def self.main( args=ARGV )
+
+ opts = { debug: false,
+          outline: false }
+
+ parser = OptionParser.new do |parser|
+  parser.banner = "Usage: #{$PROGRAM_NAME} [options] DATAFILE"
+
+##
+## 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 )
+
+
+if opts[:debug]
+  puts "OPTS:"
+  p opts
+  puts "ARGV:"
+  p args
+
+  SportDb::MatchParser.debug = true
+else
+  SportDb::MatchParser.debug = false
+  LogUtils::Logger.root.level = :info
+end
+
+
+args =  [
+              '../../../openfootball/euro/2021--europe/euro.txt',
+              '../../../openfootball/euro/2024--germany/euro.txt',
+        ]   if args.empty?
+
+pp args
+
+
+
+## errors = []
+
+
+paths = args
+
+paths.each_with_index do |path,i|
+    puts "==> [#{i+1}/#{paths.size}] reading >#{path}<..."
+
+    txt = read_text( path )
+
+    ##
+    ## note - use start: nil => requires that first date incl. a year!!!
+    parser = SportDb::MatchParser.new( txt, start: nil )
+
+    auto_conf_teams, matches, rounds, groups = parser.parse
+
+      puts ">>> #{auto_conf_teams.size} teams:"
+      pp auto_conf_teams
+      puts ">>> #{matches.size} matches:"
+      pp matches[0,2]   ## print first two matches
+      puts "..."
+      puts ">>> #{rounds.size} rounds:"
+      pp rounds
+      puts ">>> #{groups.size} groups:"
+      pp groups
+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"
+
+end  # self.main
+end  # module Fbx

data/lib/fbtok.rb

@@ -4,3 +4,9 @@ require 'sportdb/quick'
 
 ## our own code
 require_relative 'fbtok/pathspec'
+
+
+require_relative 'fbtok/fbtok'
+require_relative 'fbtok/fbtree'
+require_relative 'fbtok/fbquick'
+require_relative 'fbtok/fbx'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fbtok
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Gerald Bauer
@@ -76,6 +76,7 @@ description: fbtok - football.txt lint tools incl. tokenizer, parser & more
 email: gerald.bauer@gmail.com
 executables:
 - fbquick
+- fbquik
 - fbtok
 - fbtree
 - fbx
@@ -90,10 +91,15 @@ files:
 - README.md
 - Rakefile
 - bin/fbquick
+- bin/fbquik
 - bin/fbtok
 - bin/fbtree
 - bin/fbx
 - lib/fbtok.rb
+- lib/fbtok/fbquick.rb
+- lib/fbtok/fbtok.rb
+- lib/fbtok/fbtree.rb
+- lib/fbtok/fbx.rb
 - lib/fbtok/pathspec.rb
 homepage: https://github.com/sportdb/footty
 licenses: