strop 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f104516e3a61250be80d317bb041ab59f8e39fadf0fd2b4aefe18de8af90165
-  data.tar.gz: b55d4717c195ec9373b495b933758435eb764fd4f51073761a45456e2de47784
+  metadata.gz: c021ef142a7a5155da860f70e400c232afdf91bfe2b160d4bf12fd44356714b9
+  data.tar.gz: ba3a9549ff23d7636d09f4eece2aad318490b2143b78f0af86bd7e0178e75885
 SHA512:
-  metadata.gz: 1e629cc1a18457b54482398d8d1578d787f57ddd182c627a076f2ce7d2be9c639be3c893734422d0a23cd2be5fa2a534c527888f1437d1474a527078f5365a63
-  data.tar.gz: 8ef9f135caede03849470cd17ee470c8440b34838736bc100ef5c41502e41b35d7c99caa18c6f832edeeac72c9c67f6c926b03cc6d393f0679d34609ac8f112f
+  metadata.gz: ef12ddce52bac421a5a9320bd07b554bbb1ead04a4f0b7627e43ba835ac9c90bc9a7262d74fdbc4dad23e1cb834180575e60b5eb4a4d2c25aac54f57bcf4f24e
+  data.tar.gz: edb2a597fd1fff45d38b90c2b62c97b06742055c0f3ec9d12c5220c0dbf1ab80bcc595388db2a4b1183e71c5b3e2b894f4948ab0c77e9e9983f0a56320dd93c8

data/README.md

@@ -58,10 +58,11 @@ puts Strop.parse_help(help_text).to_s(:case)
 ## Result members (Array of Opt, Arg, Sep)
 
 ```ruby
-res.opts     # all Opt objects
-res.args     # all Arg objects
-res.rest     # args after -- separator
-res["flag"]  # find opt by name
+res.opts      # all Opt objects
+res.args      # all Arg objects
+res.rest      # args after -- separator
+res["flag"]   # find opt by name
+res[["flag"]] # find all opts matching name
 
 opt = res.opts.first
 arg = res.args.first
@@ -73,6 +74,7 @@ opt.no?      # true if --no-foo variant used
 opt.yes?     # opposite of `no?`
 arg.value    # positional argument
 arg.arg      # same as .value, useful for pattern matching
+arg.to_s     # implicit string conversion (same as .value)
 Sep          # -- end of options marker; Const, not instantiated
 ```
 
@@ -118,6 +120,7 @@ cmd -fVAL, --foo=VAL                  # attached values
 cmd -f VAL, --foo VAL                 # separate values
 cmd --foo val -- --bar                # --bar becomes positional after --
 cmd --intermixed args and --options   # flexible ordering
+cmd --ver                             # partial matching (--ver matches --verbose if unique)
 ```
 
 ## Manual option declaration building
@@ -141,6 +144,7 @@ Optdecl["foo_bar"]                    # --foo_bar: but not in strings.
 ```ruby
 optlist = Optlist[optdecl1, optdecl2] # combine decls into optlist
 optlist["f"]                          # lookup by name
+optlist["fl"]                         # partial match (finds "flag" if unique)
 ```
 
 ## Argument requirements

data/lib/strop/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Strop
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/strop.rb

@@ -30,7 +30,18 @@ module Strop
   # Optlist[decl1, decl2] #=> [Optdecl(...), Optdecl(...)]
   class Optlist < Array # a list of Optdecls
     def self.from_help(doc) = Strop.parse_help(doc) #=> Optlist[decl, ...] # Build from help text
-    def [](k, ...) = [String, Symbol].any?{ it === k } ? self.find{ it.names.member? k.to_s } : super(k, ...)
+
+    def [](k, ...)
+      case k
+      in String | Symbol
+        s = k.to_s
+        found = find{ it.names.member? s } and return found
+        found, *others = select{ it.names.any?{ it.start_with? s }} if s[1]
+        found if found && others.empty?
+      else super(k, ...)
+      end
+    end
+
     def to_s(as=:plain)
       case as
       when :plain then join("\n")
@@ -58,6 +69,7 @@ module Strop
   Arg = Data.define :value, :arg do
     def initialize(value:) = super(value:, arg: value)
     alias to_s value
+    alias to_str value
   end
 
   # Parsed option with declaration, invocation name, value, and negation state. Used internally. Seen as member of Result.
@@ -73,7 +85,7 @@ module Strop
   end
 
   # Const for parsed `--` end of option markers. Seen as member of Result.
-  Sep = :end_marker
+  Sep = :sep
 
   # Parse result containing options, arguments, and separators; Returned by `parse`
   # Result[opt1, arg1, Sep] #=> [Opt(...), Arg(...), Sep]
@@ -83,7 +95,8 @@ module Strop
     def opts = Result.new(select { Opt === it })
     def [](k, ...)
       case k
-      when String, Symbol then find{ Opt === it && it.decl.names.member?(k.to_s) }
+      in [String | Symbol => name] then opts.select{ it.decl.names.include? name.to_s }
+      in String | Symbol           then find{ Opt === it && it.decl.names.member?(k.to_s) }
       else super(k, ...)
       end
     end
@@ -123,7 +136,7 @@ module Strop
     res = Result.new
     ctx = :top
     name, token, opt = nil
-    rx_value = /\A[^-]|\A\z/ # not an opt
+    rx_value = /\A[^-]|\A-?\z/ # not an opt
     loop do
       case ctx
       in :end then return res.concat tokens.map{ Arg[it] } # opt parsing ended, rest is positional args

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: strop
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Caio Chassot