help_parser 6.4.1 → 8.0.210917

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5de4ecf5cd21b847dbc1a490db6a2efdee61aa9119fb6777f3e97d079100c6d0
-  data.tar.gz: bfad9916f32a6a135fe15c6b88c632495aece7977690cec7c1a1de0268e48be9
+  metadata.gz: 89d031ef15e33460fc4f23ccec23cc98f01cb9808fd77bb478c63be6a638f034
+  data.tar.gz: 9521262caa0b0a1617fc52bdeec42c4e305a4fc4ce34c5871128c64eecf5aae7
 SHA512:
-  metadata.gz: 7d6f037aba6739da35f14f9353d4a76a4f1f0ea7b0434f3f384b5d315b9d34eac9929091a6b7af3a5c44bcfe83e0adc66746da106ca8118c86cf6026d2734a1e
-  data.tar.gz: 15d9a0683093fc50229984dac9624cacfc513014734a6e062c99b428ece46a108c02f3069ad33afacc6a5c1f4c71e335cb7939d748428b22922d0d50954963f3
+  metadata.gz: 4e6c0faa99fd04e8b8e2f289b0f1894538747defaeb557400b36904f7c330961b9cc068aa8bdbe06493f8339af19cd4397cfdca9e1f82bc20ddbf84b91553955
+  data.tar.gz: 135b86c92d72faa5b49cdfedd7b6c66a9e568e592ae5b8afc86c612efa23020c828acb45693435d5f5349679f61a963bac81041da6d6bdae9549c1ab2de3214b

data/README.md

@@ -1,78 +1,130 @@
-# Help Parser VI: Tweeker
+# Help Parser VIII: Helpland
 
-* [github](https://www.github.com/carlosjhr64/Ruby-HelpParser)
+* [VERSION 8.0.210917](https://github.com/carlosjhr64/help_parser/releases)
+* [github](https://www.github.com/carlosjhr64/help_parser)
 * [rubygems](https://rubygems.org/gems/help_parser)
 
 ## DESCRIPTION:
-Welcome to the best Help Parser of all!
-Tweeker!
-Which do you find most helpful?
-Hard?
-I prefer easy.
 
-## SYNOPSIS:
-
-    require "pp"
-    require "help_parser"
-
-    HELP = <<-HELP
-    # <= Hash here, parser skips
-    # The Awesome Command.
-    Usage:
-      awesome [:options+] <args>+
-      awesome :alternate <arg=NAME>
-    Options:
-      -v --version       \t Give version and quit
-      -h --help          \t Give help and quit
-      -s --long          \t Short long synonyms
-      --name=NAME        \t Typed
-      --number 5         \t Defaulted
-      --value=FLOAT 1.23 \t Typed and Defaulted
-      -a --all=YN y      \t Short, long, typed, and defaulted
-    Alternate:
-      -V                 \t Just short
-    Types:
-      NAME  /^[A-Z][a-z]+$/
-      FLOAT /^\\d+\\.\\d+$/
-      YN    /^[YNyn]$/
-    Exclusive:
-      version help       \t Tells parser these are exclusive keys
-    # <= Hash here, parser breaks out
-    # Notes #
-    Blah blah blah
-    HELP
-
-    VERSION = "6.4.1"
-
-    # Macros:
-    HelpParser.string(name)  # for options.name    : String
-    HelpParser.strings(args) # for options.args    : Array(String)
-    HelpParser.float(value)  # for options.value   : Float
-    HelpParser.int?(number)  # for options.number? : Int32 | Nil
-
-    HelpParser.run(VERSION, HELP) do |options|
-      hash = options._hash
-      pp hash # to inspect the hash
-
-      pp options.name  if hash["name"]?
-      pp options.args  if hash["args"]?
-      pp options.value if hash["value"]?
-      pp options.number?
-    end
-
-Well, what do you think?
-PERFECT!
-
-## New for 6.4.0:
-
-* Automates $VERBOSE=true on --verbose
-* Reports typos you may have on options usage
-
-## New for 6.1.0:
-
-Running your `awesome` command with the `--help` flag will also check your help text for errors,
-on top of giving the help text. Otherwise, the parser no longer checks for help text errors.
+Welcome to Help Parser!  
+Do you have your help text?  
+Let's parse!
 
 ## INSTALL:
 
-    $ sudo gem install help_parser
+```console
+$ gem install help_parser
+```
+
+## SYNOPSIS:
+<!-- The following PREVIEW has been approved for ALL PROGRAMMERS by CarlosJHR64.
+For the README validator that checks against me lying....
+```ruby
+unless File.basename($PROGRAM_NAME) == 'party'
+  # For example's sake say
+  $PROGRAM_NAME = 'party'
+  # and ARGV is
+  ARGV.concat ["-\-age", "-\-date=2020-09-07", 'touch', 'that']
+  # and proceed as if run as:
+  #     awesome -\-name=Doe -\-value  a b c
+end
+```
+The following gem has been rated
+| M | Mature |
+-->
+
+```ruby
+require "help_parser"
+
+HELP = <<-HELP
+# <= Hash here, parser skips
+# HelpParser: Party command example #
+Usage:
+  party :options+ [<args>+]
+  party [:alternate] <arg=FLOAT>
+  party literal <arg1=WORD> <arg2=WORD>
+Options:
+  -v --version       \t Give version and quit
+  -h --help          \t Give help and quit
+  -s --long          \t Short long synonyms
+  --touch that       \t Defaulted
+  --date=DATE        \t Typed
+  --age=INTEGER 80   \t Typed and Defaulted
+  -a --all=YN y      \t Short, long, typed, and defaulted
+  --to_be
+  --not_to_be
+  --rain
+  --water
+  --wet
+Exclusive:
+  to_be not_to_be    \t Tells parser these are mutually exclusive keys
+Inclusive:
+  date age           \t Tells parser any of these must include all of these
+Conditional:
+  rain water wet     \t Tells parser if first then all
+Alternate:
+  --invoke
+  --wut
+Types:
+  WORD    /^[A-Za-z]+$/
+  DATE    /^\\d\\d\\d\\d-\\d\\d-\\d\\d$/
+  INTEGER /^\\d+$/
+  FLOAT   /^\\d+\\.\\d+$/
+  YN      /^[YNyn]$/
+# <= Hash here, parser breaks out
+# Notes #
+I wouldn't touch that!
+HELP
+
+VERSION = "1.2.3"
+
+OPTIONS = HelpParser[VERSION, HELP] #~> HelpParser
+
+# Macros:
+HelpParser.strings?(:args)             # for OPTIONS.args      : Array(String) | Nil
+HelpParser.int?(:age)                  # for OPTIONS.age?      : Integer | Nil
+HelpParser.float(:arg)                 # for options.arg       : Float
+HelpParser.string(:arg1, :arg2, :arg3) # for OPTIONS.arg1, etc : String
+#=> [:arg1, :arg2, :arg3]
+
+## If run as:
+##   party --age --date=2020-09-07 touch that
+OPTIONS.age?                 #=> 80
+OPTIONS.age?.class           #=> Integer
+OPTIONS.args?                #=> ["touch", "that"]
+OPTIONS.args?.class          #=> Array
+OPTIONS.arg? and OPTIONS.arg #=> false
+OPTIONS.arg?.class           #=> FalseClass
+```
+
+## Features
+
+* `$DEBUG=true` on --debug
+* `$VERBOSE=true` on --verbose
+* -h and --help simultaneously will check help string for errors
+* `HelpParser::REDTTY[msg]` will red color output `msg` to `STDERR`.
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2021 CarlosJHR64
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/help_parser/completion.rb

@@ -3,29 +3,34 @@ module HelpParser
     def initialize(hash, specs)
       @hash,@specs = hash,specs
       @cache = NoDupHash.new
-      usage if @specs.has_key?(USAGE)
+      usage or diagnose  if @specs.has_key?(USAGE)
       pad
-      types
+      types  if @specs.has_key?(TYPES)
     end
 
+    # Which usage does the user's command options match?
     def usage
       @specs[USAGE].each do |cmd|
         begin
           i = matches(cmd)
           raise NoMatch unless @hash.size==i
           @cache.each{|k,v|@hash[k]=v} # Variables
-          return
+          return true # Good! Found matching usage.
         rescue NoMatch
           next
         ensure
           @cache.clear
         end
       end
+      return false # Bad! Did not match any of the expected usage.
+    end
 
+    # Diagnose user's usage.
+    def diagnose
       dict = {}
       @specs.each do |k,v|
-        next if [USAGE,TYPES,EXCLUSIVE].include? k
-        v.flatten.map{|_|_.scan(/\w+/).first}.each{|_|dict[_]=true}
+        next if RESERVED.include? k
+        v.flatten.map{_1.scan(/\w+/).first}.each{dict[_1]=true}
       end
       typos = @hash.keys.select{|k|k.is_a? String and not dict[k]}
       raise UsageError, MSG[UNRECOGNIZED, typos] unless typos.empty?
@@ -34,22 +39,25 @@ module HelpParser
     end
 
     def types
-      if t2r = HelpParser.t2r(@specs)
-        k2t = HelpParser.k2t(@specs)
-        @hash.each do |key,value|
-          next unless key.is_a?(String)
-          if type = k2t[key]
-            regex = t2r[type]
-            case value
-            when String
-              raise UsageError, "--#{key}=#{value} !~ #{type}=#{regex.inspect}" unless value=~regex
-            when Array
-              value.each do |string|
-                raise UsageError, "--#{key}=#{string} !~ #{type}=#{regex.inspect}" unless string=~regex
+      t2r,k2t = HelpParser.t2r(@specs),HelpParser.k2t(@specs)
+      @hash.each do |key,value|
+        next unless key.is_a?(String)
+        if type = k2t[key]
+          regex = t2r[type]
+          case value
+          when String
+            unless value=~regex
+              raise UsageError, "--#{key}=#{value} !~ #{type}=#{regex.inspect}"
+            end
+          when Array
+            value.each do |string|
+              unless string=~regex
+                raise UsageError,
+                  "--#{key}=#{string} !~ #{type}=#{regex.inspect}"
               end
-            else
-              raise UsageError, "--#{key} !~ #{type}=#{regex.inspect}"
             end
+          else
+            raise UsageError, "--#{key} !~ #{type}=#{regex.inspect}"
           end
         end
       end
@@ -74,7 +82,7 @@ module HelpParser
               elsif value = @hash[long]
                 @hash[short] = true
                 if value==true && !default.nil?
-                  @hash.delete(long)
+                  @hash.delete(long) # ArgvHash reset
                   @hash[long]=default
                 end
               end
@@ -83,7 +91,7 @@ module HelpParser
               long,default = first[2..(i-1)],second
               value = @hash[long]
               if value==true
-                @hash.delete(long)
+                @hash.delete(long) # ArgvHash reset
                 @hash[long] = default
               end
             end
@@ -103,7 +111,7 @@ module HelpParser
           end
           next
         elsif m=FLAG_GROUP.match(token)
-          group,plus = m['k'],m['p']
+          group,plus = m[:k],m[:p]
           key = keys[i]
           raise NoMatch if key.nil? || key.is_a?(Integer)
           list = @specs[group].flatten.select{|f|f[0]=='-'}.map{|f| F2K[f]}
@@ -118,7 +126,7 @@ module HelpParser
         elsif m=VARIABLE.match(token)
           key = keys[i]
           raise NoMatch unless key.is_a?(Integer)
-          variable,plus = m['k'],m['p']
+          variable,plus = m[:k],m[:p]
           if plus.nil?
             @cache[variable] = @hash[key]
           else

data/lib/help_parser/constants.rb

@@ -1,15 +1,19 @@
 module HelpParser
-  @@validate = false
-  def self.validate!
-    @@validate = true
-  end
-  def self.validate?
-    @@validate
-  end
+  V,VSN = 'v','version'
+  H,HLP = 'h','help'
+  VRBS,DBG = 'verbose','debug'
 
+  # reserved name
   USAGE = 'usage'
   TYPES = 'types'
   EXCLUSIVE = 'exclusive'
+  INCLUSIVE = 'inclusive'
+  CONDITIONAL = 'conditional'
+  FLAG_CLUMPS = [EXCLUSIVE,INCLUSIVE,CONDITIONAL]
+  RESERVED = [USAGE,TYPES,EXCLUSIVE,INCLUSIVE,CONDITIONAL]
+
+  # sections
+  SECTION_NAME = /^[A-Z]\w+:$/
 
   # usage
   FLAG       = /^[-][-]?(?<k>\w+)$/
@@ -23,13 +27,14 @@ module HelpParser
 
   # spec -w,? --w+
   SHORT_LONG         = /^[-](?<s>\w),?\s+[-][-](?<k>\w+)$/
-  SHORT_LONG_DEFAULT = /^[-](?<s>\w),?\s+[-][-](?<k>\w+)(=(?<t>[A-Z]+))?,?\s+(?<d>[^-\s]\S*)$/
+  SHORT_LONG_DEFAULT =
+    /^[-](?<s>\w),?\s+[-][-](?<k>\w+)(=(?<t>[A-Z]+))?,?\s+(?<d>[^-\s]\S*)$/
 
   # spec W+ /~/
   TYPE_DEF = /^(?<t>[A-Z]+),?\s+\/(?<r>\S+)\/$/
 
   # spec w+( w+)+
-  X_DEF = /^\w+( +\w+)+$/
+  X_DEF = /^\w+( +\w+)+$/ # for both exclusive and inclusive specs
 
   CSV = /,?\s+/
 
@@ -42,17 +47,19 @@ module HelpParser
   DUP_KEY             = 'Duplicate key'
   DUP_WORD            = 'Duplicate word'
   DUP_FLAG            = 'Duplicate flag'
-  DUP_X               = 'Duplicate exclusive spec'
+  DUP_X               = 'Duplicate exclusive/inclusive spec'
   UNSEEN_FLAG         = 'Undefined flag'
   INCONSISTENT        = 'Inconsistent use of variable'
   UNEXPECTED          = 'Unexpected string in help text'
   BAD_REGEX           = 'Bad regex'
   REDUNDANT           = 'Redundant'
   EXCLUSIVE_KEYS      = 'Exclusive keys'
+  INCLUSIVE_KEYS      = 'Inclusive keys'
+  CONDITIONAL_KEYS    = 'Conditional keys'
   UNBALANCED          = 'Unbalanced brackets'
   UNRECOGNIZED_TOKEN  = 'Unrecognized usage token'
   UNRECOGNIZED_TYPE   = 'Unrecognized type spec'
-  UNRECOGNIZED_X      = 'Unrecognized exclusive spec'
+  UNRECOGNIZED_X      = 'Unrecognized exclusive/inclusive spec'
   UNRECOGNIZED_OPTION = 'Unrecognized option spec'
   UNRECOGNIZED        = 'Unrecognized'
   UNDEFINED_SECTION   = 'Section not defined'
@@ -72,7 +79,9 @@ module HelpParser
   EXTRANEOUS_SPACES   = 'Extraneous spaces in help.'
 
   # lambda utilities
-  MSG = lambda{|msg,*keys| "\033[0;31m#{msg}:  #{keys.join(' ')}\033[0m"}
+  MSG = lambda{|msg,*keys| "#{msg}:  #{keys.join(' ')}"}
   F2K = lambda{|f| f[1]=='-' ? f[2..((f.index('=')||0)-1)] : f[1]}
-  RESERVED = lambda{|k| [USAGE,TYPES,EXCLUSIVE].include?(k)} # reserved
+  REDTTY = lambda{|msg,out=$stderr|
+    out.tty? ? out.puts("\033[0;31m#{msg}\033[0m"): out.puts(msg)
+  }
 end

data/lib/help_parser/exceptions.rb

@@ -10,9 +10,9 @@ module HelpParser
 
     def exit
       if @code > 0
-        STDERR.puts self.message
+        REDTTY[self.message]
       else
-        puts self.message
+        $stdout.puts self.message
       end
       Kernel.exit @code
     end
@@ -36,10 +36,10 @@ module HelpParser
   end
 
   class NoMatch < HelpParserException
-    # used to shortcircuit out
+    # used to short-circuit out
     def _init; @code = EX_SOFTWARE; end
 
-    # Forces it's owm message
+    # Forces it's own message
     def initialize
       super(NO_MATCH)
     end

data/lib/help_parser/k2t2r.rb

@@ -1,12 +1,16 @@
 module HelpParser
   def self.k2t(specs)
     k2t = NoDupHash.new
-    tokens = specs.select{|k,v| !(k==TYPES)}.values.flatten.select{|v|v.include?('=')}
+    tokens = specs.select{|k,v| !(k==TYPES)}.values.flatten
+      .select{|v|v.include?('=')}
     tokens.each do |token|
       if match = VARIABLE.match(token) || LONG.match(token)
-        name, type = match['k'], match['t']
-        k2t[name] = type if !k2t.has_key?(name)
-        raise HelpError, MSG[INCONSISTENT,name,type,k2t[name]] if !(type==k2t[name])
+        name, type = match[:k], match[:t]
+        if _=k2t[name]
+          raise HelpError, MSG[INCONSISTENT,name,type,_]  unless type==_
+        else
+          k2t[name] = type
+        end
       else
         # Expected these to be caught earlier...
         raise SoftwareError, MSG[UNEXPECTED,token]

data/lib/help_parser/macros.rb

@@ -20,7 +20,8 @@ module HelpParser
   class Options
     def #{name}?
       s = @hash['#{name}']
-      raise UsageError, MSG[NOT_STRING,'#{name}'] unless s.nil? || s.is_a?(String)
+      raise UsageError, MSG[NOT_STRING,'#{name}'] unless s.nil? ||
+        s.is_a?(String)
       return s
     end
   end
@@ -50,7 +51,8 @@ module HelpParser
   class Options
     def #{name}?
       a = @hash['#{name}']
-      raise UsageError, MSG[NOT_STRINGS,'#{name}'] unless a.nil? || a.is_a?(Array)
+      raise UsageError, MSG[NOT_STRINGS,'#{name}'] unless a.nil? ||
+        a.is_a?(Array)
       return a
     end
   end
@@ -100,7 +102,7 @@ module HelpParser
     def #{name}
       f = @hash['#{name}']
       raise unless f.is_a?(Array)
-      f.map{|_|_.to_f}
+      f.map{_1.to_f}
     rescue
       raise UsageError, MSG[#{NOT_FLOATS},'#{name}']
     end
@@ -118,7 +120,7 @@ module HelpParser
       f = @hash['#{name}']
       return nil unless f
       raise unless f.is_a?(Array)
-      f.map{|_|_.to_f}
+      f.map{_1.to_f}
     rescue
       raise UsageError, MSG[NOT_FLOATS,'#{name}']
     end
@@ -169,7 +171,7 @@ module HelpParser
     def #{name}
       f = @hash['#{name}']
       raise unless f.is_a?(Array)
-      f.map{|_|_.to_i}
+      f.map{_1.to_i}
     rescue
       raise UsageError, MSG[NOT_INTEGERS,'#{name}']
     end
@@ -187,7 +189,7 @@ module HelpParser
       f = @hash['#{name}']
       return nil unless f
       raise unless f.is_a?(Array)
-      f.map{|_|_.to_i}
+      f.map{_1.to_i}
     rescue
       raise UsageError, MSG[NOT_INTEGERS,'#{name}']
     end

data/lib/help_parser/options.rb

@@ -2,31 +2,45 @@ module HelpParser
   class Options
     def initialize(version, help, argv)
       @hash = HelpParser.parsea(argv)
-      if version && (@hash.has_key?('v') || @hash.has_key?('version'))
+      if version && (@hash.has_key?(V) || @hash.has_key?(VSN))
         # -v or --version
         raise VersionException, version
       end
       if help
-        # -h or --help
-        if @hash.has_key?('h') || _=@hash.has_key?('help')
-          begin
-            # validates help
-            HelpParser.parseh(help, true)
-          rescue HelpError
-            $stderr.puts $!
-          end if _
+        h = [H, HLP]
+        if h.any?{@hash.key? _1}
+          HelpParser.parseh(help, validate: true)  if h.all?{@hash.key? _1}
           raise HelpException, help
         end
-        specs = HelpParser.parseh(help, HelpParser.validate?)
+        specs = HelpParser.parseh(help)
         Completion.new(@hash, specs)
         if exclusive=specs[EXCLUSIVE]
-          exclusive.each{|xs| raise HelpParser::UsageError, MSG[EXCLUSIVE_KEYS,*xs] if @hash.keys.count{|k|xs.include?(k)}>1}
+          exclusive.each do |x|
+            count = x.count{@hash.key? _1}
+            raise HelpParser::UsageError, MSG[EXCLUSIVE_KEYS,*x] if count > 1
+          end
+        end
+        if inclusive=specs[INCLUSIVE]
+          inclusive.each do |i|
+            count = i.count{@hash.key? _1}
+            unless count==0 or count==i.length
+              raise HelpParser::UsageError, MSG[INCLUSIVE_KEYS,*i]
+            end
+          end
+        end
+        if conditional=specs[CONDITIONAL]
+          conditional.each do |c|
+            if @hash.key? c[0] and not c.all?{@hash.key? _1}
+              raise HelpParser::UsageError, MSG[CONDITIONAL_KEYS,*c]
+            end
+          end
         end
       end
-      $VERBOSE = true if @hash['verbose']==true
+      $VERBOSE = true if @hash[VRBS]==true
+      $DEBUG = true if @hash[DBG]==true
     end
 
-    def _hash
+    def to_h
       @hash
     end
 

data/lib/help_parser/parseh.rb

@@ -1,10 +1,10 @@
 module HelpParser
-  def self.parseh(help, validate=true)
+  def self.parseh(help, validate: false)
     specs,name = NoDupHash.new,''
     help.each_line do |line|
       line.chomp!
       next if line==''
-      if line=~/^[A-Z]\w+:$/
+      if line=~SECTION_NAME
         name = line[0..-2].downcase
         specs[name] = []
       else
@@ -15,29 +15,32 @@ module HelpParser
         raise HelpError, EXTRANEOUS_SPACES if validate and spec==''
         case name
         when USAGE
-          HelpParser.validate_line_chars(spec.chars) if validate
+          Validate.line_chars(spec.chars) if validate
           tokens = HelpParser.parseu(spec.chars)
-          HelpParser.validate_usage_tokens(tokens) if validate
-          specs[name].push tokens
+          Validate.usage_tokens(tokens) if validate
+          specs[USAGE].push tokens
         when TYPES
-          raise HelpError, MSG[UNRECOGNIZED_TYPE,spec] if validate and not spec=~TYPE_DEF
-          specs[name].push spec.split(CSV)
-        when EXCLUSIVE
-          raise HelpError, MSG[UNRECOGNIZED_X,spec] if validate and not spec=~X_DEF
+          if validate and not spec=~TYPE_DEF
+            raise HelpError, MSG[UNRECOGNIZED_TYPE,spec]
+          end
+          specs[TYPES].push spec.split(CSV)
+        when *FLAG_CLUMPS # EXCLUSIVE,INCLUSIVE,CONDITIONAL,...
+          if validate and not spec=~X_DEF
+            raise HelpError, MSG[UNRECOGNIZED_X,spec]
+          end
           specs[name].push spec.split(CSV)
         else
-          if validate and not [SHORT, LONG, SHORT_LONG, SHORT_LONG_DEFAULT].any?{|_|_=~spec}
-            raise HelpError, MSG[UNRECOGNIZED_OPTION,spec]
-          end
+          raise HelpError, MSG[UNRECOGNIZED_OPTION,spec] if validate and
+              not [SHORT, LONG, SHORT_LONG, SHORT_LONG_DEFAULT].any?{_1=~spec}
           specs[name].push spec.split(CSV)
         end
       end
     end
     if validate
-      HelpParser.validate_usage_specs(specs)
+      Validate.usage_specs(specs)
       if t2r = HelpParser.t2r(specs)
         k2t = HelpParser.k2t(specs)
-        HelpParser.validate_k2t2r(specs, k2t, t2r)
+        Validate.k2t2r(specs, k2t, t2r)
       end
     end
     return specs

data/lib/help_parser/{validations.rb → validate.rb}

@@ -1,5 +1,6 @@
 module HelpParser
-  def self.validate_line_chars(chars)
+module Validate
+  def self.line_chars(chars)
     count = 0
     chars.each do |c|
       if c=='['
@@ -12,7 +13,7 @@ module HelpParser
     raise HelpError, MSG[UNBALANCED,chars.join] unless count==0
   end
 
-  def self.validate_usage_tokens(tokens)
+  def self.usage_tokens(tokens)
     words = []
     tokens.flatten.each do |token|
       match = token.match(FLAG)     ||
@@ -20,24 +21,28 @@ module HelpParser
               token.match(VARIABLE) ||
               token.match(FLAG_GROUP)
       raise HelpError, MSG[UNRECOGNIZED_TOKEN,token] unless match
-      words.push match['k'] # key
+      words.push match[:k] # key
     end
     words.each_with_index do |word,i|
       raise HelpError, MSG[DUP_WORD,word] unless i==words.rindex(word)
     end
   end
 
-  def self.validate_usage_specs(specs)
-    option_specs = specs.select{|a,b| !RESERVED[a]}
+  def self.usage_specs(specs)
+    option_specs = specs.select{|a,b| not RESERVED.include? a}
     flags = option_specs.values.flatten.select{|f|f[0]=='-'}.map{|f| F2K[f]}
-    if exclusive=specs[EXCLUSIVE]
-      seen = {}
-      exclusive.each do |xs|
-        k = xs.sort.join(' ').to_sym
-        raise HelpError, MSG[DUP_X,k] if seen[k]
-        seen[k] = true
-        xs.each do |x|
-          raise HelpError, MSG[UNSEEN_FLAG, x] unless flags.include?(x)
+    FLAG_CLUMPS.each do |k|
+      if a=specs[k]
+        seen = {}
+        a.each do |xs|
+          k = xs.sort.join(' ').to_sym
+          if seen[k] or not xs.length==xs.uniq.length
+            raise HelpError, MSG[DUP_X,k]
+          end
+          seen[k] = true
+          xs.each do |x|
+            raise HelpError, MSG[UNSEEN_FLAG, x] unless flags.include?(x)
+          end
         end
       end
     end
@@ -49,7 +54,7 @@ module HelpParser
     unless specs_usage.nil?
       specs_usage.flatten.each do |token|
         if match = token.match(FLAG_GROUP)
-          key = match['k']
+          key = match[:k]
           raise HelpError, MSG[UNDEFINED_SECTION,key] unless specs[key]
           group.push(key)
         end
@@ -57,12 +62,12 @@ module HelpParser
     end
     specs.each do |key,tokens|
       raise HelpError, MSG[MISSING_CASES,key] unless tokens.size>0
-      next if specs_usage.nil? or RESERVED[key]
+      next if specs_usage.nil? or RESERVED.include? key
       raise HelpError, MSG[MISSING_USAGE,key] unless group.include?(key)
     end
   end
 
-  def self.validate_k2t2r(specs, k2t, t2r)
+  def self.k2t2r(specs, k2t, t2r)
     a,b = k2t.values.uniq.sort,t2r.keys.sort
     unless a==b
       c = (a+b).uniq.select{|x|!(a.include?(x) && b.include?(x))}
@@ -80,8 +85,11 @@ module HelpParser
         long = long_type[2..(i-1)]
         type = long_type[(i+1)..-1]
         regex = t2r[type]
-        raise HelpError, MSG[BAD_DEFAULT,long,default,type,regex.inspect] unless regex=~default
+        unless regex=~default
+          raise HelpError, MSG[BAD_DEFAULT,long,default,type,regex.inspect]
+        end
       end
     end
   end
 end
+end

data/lib/help_parser.rb

@@ -1,17 +1,17 @@
-require_relative './help_parser/constants'
-require_relative './help_parser/exceptions'
-require_relative './help_parser/aliases'
-require_relative './help_parser/parsea'
-require_relative './help_parser/validations'
-require_relative './help_parser/parseu'
-require_relative './help_parser/parseh'
-require_relative './help_parser/k2t2r'
-require_relative './help_parser/completion'
-require_relative './help_parser/options'
-require_relative './help_parser/macros'
+require_relative 'help_parser/constants'
+require_relative 'help_parser/exceptions'
+require_relative 'help_parser/aliases'
+require_relative 'help_parser/parsea'
+require_relative 'help_parser/parseu'
+require_relative 'help_parser/parseh'
+require_relative 'help_parser/k2t2r'
+require_relative 'help_parser/completion'
+require_relative 'help_parser/options'
+require_relative 'help_parser/macros'
 
 module HelpParser
-  VERSION = '6.4.1'
+  VERSION = '8.0.210917'
+  autoload :Validate, 'help_parser/validate'
 
   def self.[](
     version = nil,
@@ -21,16 +21,6 @@ module HelpParser
   rescue HelpParserException => exception
     exception.exit
   end
-
-  def self.run(
-    version = nil,
-    help    = nil,
-    argv    = [File.basename($0)]+ARGV)
-    options = Options.new(version, help, argv)
-    yield options
-  rescue HelpParserException => exception
-    exception.exit
-  end
 end
 
 # Requires:

metadata

@@ -1,21 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: help_parser
 version: !ruby/object:Gem::Version
-  version: 6.4.1
+  version: 8.0.210917
 platform: ruby
 authors:
-- carlosjhr64
-autorequire: 
+- CarlosJHR64
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-09-09 00:00:00.000000000 Z
+date: 2021-09-17 00:00:00.000000000 Z
 dependencies: []
-description: |
-  Welcome to the best Help Parser of all!
-  Tweeker!
-  Which do you find most helpful?
-  Hard?
-  I prefer easy.
+description: "Welcome to Help Parser!  \nDo you have your help text?  \nLet's parse!\n"
 email: carlosjhr64@gmail.com
 executables: []
 extensions: []
@@ -34,12 +29,12 @@ files:
 - lib/help_parser/parsea.rb
 - lib/help_parser/parseh.rb
 - lib/help_parser/parseu.rb
-- lib/help_parser/validations.rb
-homepage: https://github.com/carlosjhr64/Ruby-HelpParser
+- lib/help_parser/validate.rb
+homepage: https://github.com/carlosjhr64/help_parser
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -54,11 +49,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]'
-rubyforge_project: 
-rubygems_version: 2.7.7
-signing_key: 
+- 'ruby: ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-linux]'
+rubygems_version: 3.2.22
+signing_key:
 specification_version: 4
-summary: Welcome to the best Help Parser of all! Tweeker! Which do you find most helpful?
-  Hard? I prefer easy.
+summary: Welcome to Help Parser!   Do you have your help text?   Let's parse!
 test_files: []