argument_parser 0.0.0 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de34c01a224dda66a54884deaf0818e83855515d33281a8b7191a96e27c8f987
-  data.tar.gz: 8ae1418b2bdeb6c9fb25b339e3cc70e335d91bc42de9871f1e889c789303d1dc
+  metadata.gz: feb0e8be78d5fc392980f1ac65520b131c34641207cc31b11d05badb7edf7fcc
+  data.tar.gz: a74b6300dec4d61257f941e57ff93cd7106190da441d1f09da621e6025f35320
 SHA512:
-  metadata.gz: 7ad9f308dd95fceb6bae98c97d65075312fb0133937fd8367ab37d04188ab061d5ae640926f805433f916468ef88adc287ae810bfaf55937b7a35ed0f0cd1683
-  data.tar.gz: 6fb21b3496c06b8ab9ce58ee60071e6f703c0edfbbf371b4d50affb0b73bd1f4ffbfb58706e138e29310a88d359d796dd0485639989c5edd3eda7e718cf494ab
+  metadata.gz: 9ad1572e3a661121609cfeffed61b1654bdbb94862e317944a5a1c1da9317b6315c5a6219258743275b670bb9c002ddee4188059526e1b2b55a333c34c2b1d0d
+  data.tar.gz: 9656697885fe68d0de72bcf459796f2cf16cb85c94aff6d258ac9ad595a2ccd6f92615f0eb419f6f7068c4e47d8a080013143bf63e994e0cb8813776b85fd76f

data/lib/argument_parser/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ArgumentParser
-  VERSION = "0.0.0"
+  VERSION = "0.1.0"
 end

data/lib/argument_parser.rb

@@ -3,4 +3,114 @@
 require_relative "argument_parser/version"
 
 module ArgumentParser
+  extend self
+
+  Error           = Class.new(StandardError)
+  SchemaError     = Class.new(Error)
+  MissingArgument = Class.new(Error)
+  InvalidArgument = Class.new(Error)
+
+  class Parser < Data.define(:schema)
+    def parse!(argv = ARGV)
+      i = 0
+
+      args = schema.each_with_object({}) do |rule, result|
+        case rule.kind
+        in :required
+          arg = argv[i]
+          raise MissingArgument, "missing required argument: #{rule.name}" if arg.nil?
+          arg = validate!(arg, rule.options)
+
+          result[rule.name] = arg
+          i += 1
+        in :optional
+          arg = validate!(argv[i], rule.options)
+
+          result[rule.name] = arg || rule.options[:default]
+          i += 1 if arg
+        in :rest
+          rest_args = argv.dup[i..] || []
+          rest_args.map! { |it| validate!(it, rule.options) }
+
+          result[rule.name] = rest_args
+          i = argv.size
+        end
+      end
+
+      argv.shift(i)
+
+      args
+    end
+
+    private
+
+    def validate!(arg, options)
+      coerced_arg = coerce!(arg, options)
+      return coerced_arg unless options[:pattern]
+      return coerced_arg unless arg
+      return coerced_arg if options[:pattern] === coerced_arg
+
+      raise InvalidArgument, "invalid argument: #{arg}"
+    end
+
+    def coerce!(arg, options)
+      return arg unless arg
+      return arg unless options[:type]
+
+      if options[:type] == Integer
+        Integer(arg)
+      elsif options[:type] == Float
+        Float(arg)
+      elsif options[:type] == String
+        arg
+      else
+        raise SchemaError, "type not supported: #{options[:type]}"
+      end
+    rescue ArgumentError
+      raise InvalidArgument, "invalid argument: #{arg}"
+    end
+  end
+
+  module Schema
+    class Builder
+      def initialize
+        @current_stage = Schema::RequiredStage.new([])
+      end
+
+      def required(...) = @current_stage = @current_stage.required(...)
+      def optional(...) = @current_stage = @current_stage.optional(...)
+      def rest(...)     = @current_stage = @current_stage.rest(...)
+      def build = @current_stage.build
+    end
+
+    Rule = Data.define(:kind, :name, :options)
+
+    RequiredStage = Data.define(:schema) do
+      def required(name, **opts)
+        self.class.new(schema + [Rule.new(:required, name, opts)])
+      end
+
+      def optional(name, **opts)
+        OptionalStage.new(schema + [Rule.new(:optional, name, opts)])
+      end
+
+      def rest(name, **opts)
+        RestStage.new(schema + [Rule.new(:rest, name, opts)])
+      end
+
+      def build = Parser.new(schema)
+    end
+
+    class OptionalStage < RequiredStage
+      def required(*) = raise SchemaError, "cannot add required arguments after optional/rest"
+      def optional(*) = raise SchemaError, "only one optional argument is allowed"
+    end
+
+    class RestStage < OptionalStage
+      def rest(*) = raise SchemaError, "only one rest argument is allowed"
+    end
+  end
+
+  def schema = Schema::RequiredStage.new([])
+  def build(&block) = Schema::Builder.new.instance_eval(&block).build
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: argument_parser
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.1.0
 platform: ruby
 authors:
 - Matheus Richard
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-16 00:00:00.000000000 Z
+date: 2025-09-17 00:00:00.000000000 Z
 dependencies: []
 description: Parse command line arguments with like you parse options with OptionParser.
 email: