l43_opt_parser 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 63be9d1fa069240f7ef6fdd36805bb3af88c50519543465170bfb15dcd1af069
+  data.tar.gz: f54d8f9209b79139f896e8453e78010de27dd3bdd00c0aa6aa6db3f0713c8e4a
+SHA512:
+  metadata.gz: fb4bf372fe886ef383b136b964499dbfc861fc6c67b7b58343eb63651b0ecf1b4235e66aacf865d0465f807386c4d330b844463af9c414351f598bf839a4072c
+  data.tar.gz: c332e0cb1dda8032e5636d9c96b5fc99d43f9c588140e3561ac48f0e7ebe7d6d7128bea88b67b968f90dc1a585c48574ad0dc77a1eedf4388adaec5833cce99e

data/lib/l43/opt_parser/errors.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class OptParser
+  DuplicateFlagDefinition = Class.new(RuntimeError)
+  DuplicateKeywordDefinition = Class.new(RuntimeError)
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/l43/opt_parser/flag.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+module L43
+  class OptParser
+    class Flag
+      attr_reader :multiple, :name
+
+      def on_multiple(&blk)
+        @on_multiple = blk
+        self
+      end
+
+      def update(value, old_value)
+        if old_value && !multiple
+          [:error, "flag :#{name} has already been specified but is not a multiple flag"]
+        elsif multiple
+          [:ok, @on_multiple.(old_value, value)]
+        else
+          [:ok, true]
+        end
+      end
+
+      private
+      def initialize(name, multiple: false)
+        @name = name
+        @multiple = multiple
+        on_multiple do |old, value|
+          old ? old.succ : value
+        end
+      end
+    end
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/l43/opt_parser/keyword.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module L43
+  class OptParser
+    class Keyword
+      attr_reader :initializer, :multiple, :name, :type
+
+      def on_multiple(&blk)
+        @on_multiple = blk
+        self
+      end
+
+      def update(value, old_value)
+        if old_value && !multiple
+          [:error, "keyword #{name} has already been specified but is not a multiple keyword"]
+        elsif old_value
+          value = make_value(value)
+          [:ok, @on_multiple.(old_value, value)]
+        elsif multiple
+          [:ok, [make_value(value)]]
+        else
+          [:ok, make_value(value)]
+        end
+      end
+
+      private
+      def initialize(name, multiple: false, type: String, &initializer)
+        @initializer = initializer
+        @name = name
+        @multiple = multiple
+        @type = type
+        on_multiple do |old, value|
+          old ? [*old, value] : value
+        end
+      end
+
+      def make_value(value)
+        value = type.new(value)
+        value = initializer.(value) if initializer
+        multiple
+        value
+      end
+    end
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/l43/opt_parser/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module L43
+  class OptParser
+    VERSION = '0.0.1'
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/l43/opt_parser.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+require 'ostruct'
+require_relative 'opt_parser/errors'
+require_relative 'opt_parser/flag'
+require_relative 'opt_parser/keyword'
+
+module L43
+  class OptParser
+
+    FlagRgx = /\A:(.*)/
+    KeywordRgx = /(.*):\z/
+
+    # Constraints
+    # -----------
+    def flag(name, multiple: false)
+      flags.merge!(symbolize(name) => Flag.new(symbolize(name), multiple:)) { |*|
+        raise DuplicateFlagDefinition, "flag :#{name} is already defined"
+      }
+      @constrained = true
+      self
+    end
+
+    def keyword(name, multiple: false, type: String, &initializer)
+      keywords.merge!(name => Keyword.new(name, multiple:, type:, &initializer)) { |*| 
+        raise DuplicateKeywordDefinition, "keyword :#{name} is already defined"
+      }
+      @constrained = true
+      self
+    end
+
+    # Business Logic
+    # --------------
+    def parse(arguments)
+      reset_data!
+      @arguments = arguments
+      parse_arguments
+
+      OpenStruct.new(args:, errors:, kwds:, ok?: errors.empty?).freeze
+    end
+
+    private
+    # Permissions
+    # -----------
+    def allowed_flag?(flag)
+      return true unless constrained?
+      flags.fetch(flag, false)
+    end
+
+    def allowed_kwd?(kwd)
+      return true unless constrained?
+      keywords.fetch(kwd, false)
+    end
+
+    def check_kwd(kwd, value)
+      return unless constrained?
+    end
+
+
+    # Error Handling
+    # --------------
+    def add_errors(new_errors) = errors.push(*new_errors)
+
+    # Business Logic
+    # --------------
+    def assign_kwd(kwd, value)
+      error = check_kwd(kwd, value)
+      return add_errors(error) if error
+      keyword = get_keyword(kwd)
+      case keyword.update(value, kwds[kwd]) 
+      in :ok, value
+        kwds.merge!(kwd => value)
+      in :error, message
+        add_errors(message)
+      end
+    end
+
+    def cast_value(_kwd, value)
+      return value unless constrained?
+    end
+
+    def get_flag(flag)
+      flags.fetch(flag) do
+        flags[flag] = Flag.new(flag, multiple: true)
+      end
+    end
+
+    def get_keyword(kwd)
+      keywords.fetch(kwd) do
+        keywords[kwd] = Keyword.new(kwd, multiple: true)
+      end
+    end
+
+    def parse_argument
+      case @arguments.first
+      when nil
+        return
+      when '::'
+        args.push(*@arguments.drop(1))
+        return
+      when FlagRgx
+        parse_flag($1.to_sym)
+      when KeywordRgx
+        parse_kwd($1.to_sym)
+      else
+        args << @arguments.first
+        1
+      end
+    end
+
+    def parse_arguments
+      loop do
+        count = parse_argument
+        return unless count
+        @arguments = @arguments.drop(count)
+      end
+    end
+
+    def parse_flag(flag)
+      add_errors("undefined flag: :#{flag}") unless allowed_flag?(flag)
+
+      defined_flag = get_flag(flag)
+      case defined_flag.update(1, kwds[flag])
+      in :ok, value
+        kwds.merge!(flag => value)
+      in :error, message
+        add_errors(message)
+      end
+      1
+    end
+
+    def parse_kwd(kwd)
+      add_errors("undefined keyword: #{kwd}:") unless allowed_kwd?(kwd)
+        case @arguments
+        in [_]
+          add_errors("keyword #{kwd}: requires value but none was given, make sure there is an argument after '#{kwd}:'")
+        in [_, value, *]
+          assign_kwd(kwd, value)
+        end
+      2
+    end
+
+    def symbolize(name) = name.to_s.gsub("-", "_").to_sym
+
+    # Data
+    # ----
+    def args =  @__args__ ||= []
+    def constrained? = @constrained
+    def errors =  @__errors__ ||= []
+    def kwds =  @__kwds__ ||= {}
+    def flags =  @__flags__ ||= {}
+    def keywords =  @__keywords__ ||= {}
+
+    def reset_data!
+      @__args__ = []
+      @__errors__ = []
+      @__kwds__ = {}
+    end
+
+  end
+end
+# SPDX-License-Identifier: AGPL-3.0-or-later

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: l43_opt_parser
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Robert Dober
+bindir: bin
+cert_chain: []
+date: 2026-02-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ostruct
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.3
+description: |
+  A highly customizable option parser, allowing for different
+  option syntax and returning custom classes' instances depending on
+  the configured options
+email: robert.dober@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/l43/opt_parser.rb
+- lib/l43/opt_parser/errors.rb
+- lib/l43/opt_parser/flag.rb
+- lib/l43/opt_parser/keyword.rb
+- lib/l43/opt_parser/version.rb
+homepage: https://codeberg.org/lab419/l43_opt_parser
+licenses:
+- AGPL-3.0-or-later
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.4
+specification_version: 4
+summary: Extract Specs from Markdown
+test_files: []