flex_args 0.0.1 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e93a15e8addb2cefcdcda7b58faf9cceb148e5775a57f0e21cceb3dd90734260
-  data.tar.gz: 68a45e49acfd7d0f99033140fba26352db551c7e4f9b161c64e9fe231de0b695
+  metadata.gz: ef1ef86d73320f89eba86a8e982f3b7d24724ccdfe0d085ac2a9ac674485b79e
+  data.tar.gz: 0f554da437841db0d31aee39352d15db3e6480b95bcbcf8755ac5dcf77d84cbb
 SHA512:
-  metadata.gz: a46f39dd0565e37fb17c52efc6b7e15acd1e10f197574aa779111f48da19142984faf53867b22354193670514a366cd278135021769ac7985dad325ef910f8ca
-  data.tar.gz: 59e4cf51aa46e4119fe7de1cb01639e5cdd12cf911f16a9f473a2a465798543e6ea80178aeaea9cb61fb925bdbc639a2da4732c9bec794e90de26039ce1d3487
+  metadata.gz: f745f4e480196273b41b4db03742f3ba1a8d1a1d4b645d81b2aa976a30b7709c7971871ab6edea421d0575878c24de931055c60a39b20f54adbb1dc8bba201b9
+  data.tar.gz: 74e53271bf7ca6699ea7dbf47b2bf31602e3ae2a8b8fbb1595d58d0e94ddb1970f1ff1087b83946f0169af025c0d4e346cb81f66a8b5f4c878c9f226587c8b2c

data/lib/flex_args/version.rb

@@ -2,8 +2,7 @@
 
 class FlexArgs
   module Version
-    VERSION="0.0.1"
-    
+    VERSION="0.1.0"
   end
 end
 # SPDX-License-Identifier: AGPL-3.0-or-later

data/lib/flex_args.rb

@@ -67,6 +67,33 @@ require 'ostruct'
 #   parse(%w[escaped:1,a,,b,c]).values => {escaped: [1, "a,b", "c"]}
 # ```
 #
+# #### Multiple Values
+#
+# This is an _alternative_ way to get a list of values
+#
+# ```spec # Multiple Values => Lists
+#   parse(%w[list:1 list:2 hello list:3]).values => {list: [1, 2, 3]}
+# ```
+#
+# ### Advanced Features
+#
+# More advanced features are set with methods on the the instance
+# before invoking `parse`.
+#
+# These features are
+#
+#   - Aliased flags
+#   - Defaults
+#   - Constraints
+#      - allowed
+#      - required
+#      - domain checks
+#      - format checks
+#   - Custom Transformations
+#   - Semantic Checks (v0.2)
+#
+# and they are documented in the rdocs of the corresponding methods
+#
 class FlexArgs
 
   ESCAPED_COMMA = "a4ey8NGnXIVhsV" 
@@ -76,24 +103,58 @@ class FlexArgs
   SINGLE_FLAG = %r{\A -- (.*) \z}x
   VALUE = %r{\A ([[:alpha:]][[:alnum:]_]+) : (.*) \z}x
 
-  attr_reader :args, :flags, :positionals, :result, :values
+  attr_reader :alias_definitions, :flags, :positionals, :result, :values
 
-  def parse
+  def parse(args)
+    init_values
     args.each { parse_arg it }
     result
   end
 
+  ##
+  #
+  # ## Aliases are defined by passing a hash
+  #
+  # The key of the hash is the alias and it will be defined as an alias
+  # to the value of the hash for **each** grapheme of the key, here is
+  # how that works
+  #
+  # ```spec # Aliases
+  #   parser = FlexArgs
+  #     .new
+  #     .aliases(hu: :help, v: :version)
+  #
+  #   expect(parser.parse(%w[-uv]).flags).to eq(Set.new(%i[help version]))
+  #   expect(parser.parse(%w[-h]).flags).to eq(Set.new(%i[help]))
+  # ```
+  #
+  def aliases(alias_definitions)
+    alias_definitions
+      .each do |key, value|
+        key.to_s.grapheme_clusters.each { define_alias it, value }
+      end
+    self
+  end
+
   private
-  def initialize(args)
-    @args = args
-    @positionals = []
-    @flags = Set.new
-    @values = Hash.new
+  def initialize
+    @alias_definitions = Hash.new
+    init_values
+  end
+
+  def add_flags(shorts)
+    shorts.each do
+      flag = alias_definitions.fetch(it, it)
+      flags << flag
+    end
   end
 
   def add_value(matches)
     matches => [key, value]
-    values.update(key.to_sym => cast_all(value))
+    values
+      .update(key.to_sym => cast_all(value)) do |k, o, n|
+        Array(o) << n
+      end
   end
 
   def cast(value)
@@ -116,13 +177,24 @@ class FlexArgs
     values.one? ? values.first : values
   end
 
+  def define_alias(short, long)
+    alias_definitions.update(short => long)
+  end
+
+  def init_values
+    @positionals = []
+    @flags = Set.new
+    @values = Hash.new
+  end
+
+
   def parse_arg(arg)
     # require "debug"; binding.break
     case arg
     when SINGLE_FLAG
       flags << Regexp.last_match[1]
     when MANY_FLAGS
-      @flags += Regexp.last_match[1].grapheme_clusters
+      add_flags(Regexp.last_match[1].grapheme_clusters)
     when VALUE
       add_value(Regexp.last_match)
     else

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: flex_args
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors:
 - Robert Dober