fbtxt-parser 0.9.0

data/lib/fbtxt/parser/version.rb

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

data/lib/fbtxt/parser.rb

@@ -0,0 +1,140 @@
+require 'cocos'
+
+
+
+
+require_relative 'parser/version'
+
+
+require_relative 'parser/debuggable'    ## generic debug/logger helper
+
+
+
+##
+## add shared/most basic regexes here
+## todo - use ANY_RE  to token_commons or such - for shared by many?
+module Fbtxt
+class Lexer
+
+## general catch-all  (RECOMMENDED (ALWAYS) use as last entry in union)
+##   to avoid advance of pos match!!!
+ANY_RE = %r{
+               (?<any> .)
+          }ix
+
+SPACES_RE = %r{
+                  (?<spaces> [ ]{2,})
+                | (?<space>  [ ])
+             }ix
+
+
+end # class Lexer
+end # module Fbtxt
+
+
+require_relative 'parser/token-score'
+require_relative 'parser/token-score_full'
+require_relative 'parser/token-score_fuller'
+require_relative 'parser/token-score_legs'
+require_relative 'parser/token-score--helpers'
+
+require_relative 'parser/token-time'
+require_relative 'parser/token-date--names'
+require_relative 'parser/token-date'
+require_relative 'parser/token-date_duration'
+require_relative 'parser/token-date--helpers'
+
+require_relative 'parser/token-text'
+require_relative 'parser/token-prop'    ## team prop(erty) mode (note - must be before token)
+require_relative 'parser/token-prop_name'    ## a.k.a token-text_ii
+require_relative 'parser/token-status'
+require_relative 'parser/token-status_inline'
+require_relative 'parser/token-note'
+require_relative 'parser/token-goals'
+require_relative 'parser/token-goals--helpers'
+require_relative 'parser/token-geo'
+require_relative 'parser/token-group'
+require_relative 'parser/token-round'
+require_relative 'parser/token'
+
+
+
+
+
+require_relative 'parser/lexer_buffer'   ## incl. Tokens (aka TokenBuffer)
+require_relative 'parser/lexer_token'
+
+require_relative 'parser/lexer-prep_doc'
+require_relative 'parser/lexer-prep_line'
+
+require_relative 'parser/lexer-logger'   ## e.g. _trace, _warn, _info, etc.
+require_relative 'parser/lexer-tokenize'
+require_relative 'parser/lexer-on_round_def'
+require_relative 'parser/lexer-on_group_def'
+require_relative 'parser/lexer-on_prop_misc'
+require_relative 'parser/lexer-on_prop_lineup'
+require_relative 'parser/lexer-on_prop_penalties'
+require_relative 'parser/lexer-on_goal'
+require_relative 'parser/lexer-on_top'
+require_relative 'parser/lexer'
+
+
+## note - use "embeded" racc parser runtime
+##    MUST uncomment  require 'racc/parser'  in generated parser!!!
+require_relative 'parser/parser-runtime'
+
+require_relative 'parser/parser'   ## auto-generated by racc (from parser.y)
+require_relative 'parser/parser-top'
+
+require_relative 'parser/parse_tree--core'    ## incl. core extensions eg. as_json on Object/Array/Hash
+require_relative 'parser/parse_tree'
+require_relative 'parser/parse_tree-match'
+require_relative 'parser/parse_tree-props'
+
+
+## deprecated - remove old RaccMatchParser name sooner than later!!
+##    use Fbtxt.parse for "public" api
+##
+RaccMatchParser = Fbtxt::Parser
+
+
+
+###
+#  make parser api (easily) available - why? why not?
+#
+#  use Fbtxt.parse( txt ) &&
+#      Fbtxt.lex( txt)            -- or Fbtxt.tokenize?
+#
+#   Fbtxt.lex( txt,
+#                 flatten: true|false,        ## keep nested [] for lines (no NEWLINE tokens)
+#                 transform: true|false )     ## builtin transforms eg. merge DATE & TIME => DATETIME, etc.
+#
+#   how to deal with errors?
+##    always return   [tokens, errors] or such?
+##           or return a Result struct - why? why not?
+
+
+
+module Fbtxt
+
+def self.lex( txt, flatten: true )      ## returns Fbtxt::LexerResult (ok?/tokens/errors)
+  lexer = Lexer.new( txt )
+  ## move "wrapping" into result obj inside lexer - why? why not?
+  tokens, errors = lexer.tokenize_with_errors( flatten: flatten )
+  LexerResult.new( tokens, errors )
+end
+
+def self.parse( txt )   ## returns Fbtxt::ParserResult (ok?/tree/errors)
+  parser = Parser.new( txt )
+  ## move "wrapping" into result obj inside parser - why? why not?
+  tree, errors = parser.parse_with_errors
+  ParserResult.new( tree, errors )
+end
+end #  module Fbtxt
+
+
+
+
+
+
+puts Fbtxt::Module::Parser.banner    # say hello

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: fbtxt-parser
+version: !ruby/object:Gem::Version
+  version: 0.9.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-07-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: cocos
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.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: fbtxt-parser - football.txt match parser (& tokenizer)
+email: gerald.bauer@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/fbtxt/parser.rb
+- lib/fbtxt/parser/debuggable.rb
+- lib/fbtxt/parser/lexer-logger.rb
+- lib/fbtxt/parser/lexer-on_goal.rb
+- lib/fbtxt/parser/lexer-on_group_def.rb
+- lib/fbtxt/parser/lexer-on_prop_lineup.rb
+- lib/fbtxt/parser/lexer-on_prop_misc.rb
+- lib/fbtxt/parser/lexer-on_prop_penalties.rb
+- lib/fbtxt/parser/lexer-on_round_def.rb
+- lib/fbtxt/parser/lexer-on_top.rb
+- lib/fbtxt/parser/lexer-prep_doc.rb
+- lib/fbtxt/parser/lexer-prep_line.rb
+- lib/fbtxt/parser/lexer-tokenize.rb
+- lib/fbtxt/parser/lexer.rb
+- lib/fbtxt/parser/lexer_buffer.rb
+- lib/fbtxt/parser/lexer_token.rb
+- lib/fbtxt/parser/parse_tree--core.rb
+- lib/fbtxt/parser/parse_tree-match.rb
+- lib/fbtxt/parser/parse_tree-props.rb
+- lib/fbtxt/parser/parse_tree.rb
+- lib/fbtxt/parser/parser-runtime.rb
+- lib/fbtxt/parser/parser-top.rb
+- lib/fbtxt/parser/parser.rb
+- lib/fbtxt/parser/token-date--helpers.rb
+- lib/fbtxt/parser/token-date--names.rb
+- lib/fbtxt/parser/token-date.rb
+- lib/fbtxt/parser/token-date_duration.rb
+- lib/fbtxt/parser/token-geo.rb
+- lib/fbtxt/parser/token-goals--helpers.rb
+- lib/fbtxt/parser/token-goals.rb
+- lib/fbtxt/parser/token-group.rb
+- lib/fbtxt/parser/token-note.rb
+- lib/fbtxt/parser/token-prop.rb
+- lib/fbtxt/parser/token-prop_name.rb
+- lib/fbtxt/parser/token-round.rb
+- lib/fbtxt/parser/token-score--helpers.rb
+- lib/fbtxt/parser/token-score.rb
+- lib/fbtxt/parser/token-score_full.rb
+- lib/fbtxt/parser/token-score_fuller.rb
+- lib/fbtxt/parser/token-score_legs.rb
+- lib/fbtxt/parser/token-status.rb
+- lib/fbtxt/parser/token-status_inline.rb
+- lib/fbtxt/parser/token-text.rb
+- lib/fbtxt/parser/token-time.rb
+- lib/fbtxt/parser/token.rb
+- lib/fbtxt/parser/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: fbtxt-parser - football.txt match parser (& tokenizer)
+test_files: []