help_parser 7.0.200907 → 8.1.221206

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7df1feedeed249286efe5cd5f1e2cc187a91d348eab654d5a6f110292d0c3476
-  data.tar.gz: a3f142a3d2cf4c6bf038b25e3552dfc3f56bfbb3469749386994b0763ccaea4c
+  metadata.gz: 157ae793a16a5b92ca1633306080465fcd2e9671aaed67dc01fb47cb318f0824
+  data.tar.gz: cc72ed9f03c94ef2f5455897807a49ba69e79786ceae5daa3d158d3265e9a931
 SHA512:
-  metadata.gz: c3df75b2ae4640bc268e86774facbc7f60e74fda4d58c3262022e3a571cb3d716af2be92e7d1652e2ffa5469a1852da4a412e582141f155fe849f37e62d4e4dc
-  data.tar.gz: 447dfb4939662fec618c4c315f104785e1923a6a625b82ed028981a9ff98c35c9049b23586501c8bd06e244f21de8da4cec2c491bf815a17d3c2d38f93495e4e
+  metadata.gz: aea35622e25f8fd0cf84cc3115ce15b524440e698f516ebbd89188fa56d30c098dcc8711d61cee4b07aa7b77f935091222c2b0ff71465480d0e9cf76530810f5
+  data.tar.gz: 88a2613d9487be0b11e0da90bef805abc5fc1a7ca0012a97b32d5aa62540f382cc91e38b6714e4279bdba319475b323126625b4cf092e037742f30ba1c4ee22a

data/README.md

@@ -1,25 +1,30 @@
-# Help Parser VII: Deader
+# Help Parser VIII: Helpland
 
-* [VERSION 7.0.200907](https://github.com/carlosjhr64/Ruby-HelpParser/releases)
-* [github](https://www.github.com/carlosjhr64/Ruby-HelpParser)
+* [VERSION 8.1.221206](https://github.com/carlosjhr64/help_parser/releases)
+* [github](https://www.github.com/carlosjhr64/help_parser)
 * [rubygems](https://rubygems.org/gems/help_parser)
 
 ## DESCRIPTION:
 
-Can't help YOU???
-You're not the first to say that...
+Welcome to Help Parser!  
+Do you have your help text?  
+Let's parse!
 
-I will parse your help!
+## INSTALL:
+
+```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) == 'deader'
+unless File.basename($PROGRAM_NAME) == 'party'
   # For example's sake say
-  $PROGRAM_NAME = 'deader'
+  $PROGRAM_NAME = 'party'
   # and ARGV is
-  ARGV.concat ["-\-age", "-\-date=2020-09-07", 'invoke', 'the', 'command']
+  ARGV.concat ["-\-age", "-\-date=2020-09-07", 'touch', 'that']
   # and proceed as if run as:
   #     awesome -\-name=Doe -\-value  a b c
 end
@@ -28,34 +33,35 @@ The following gem has been rated
 | M | Mature |
 -->
 
-> Who ever you are, you were meant to find me today...
-> there is no turning back!
-> Above all, don't invoke the command!
-
 ```ruby
 require "help_parser"
 
 HELP = <<-HELP
 # <= Hash here, parser skips
-# HelpParser: Deader command example #
+# HelpParser: Party command example #
 Usage:
-  deader :options+ [<args>+]
-  deader [:alternate] <arg=FLOAT>
-  deader literal <arg1=WORD> <arg2=WORD> <arg3=WORD>
+  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
-  --command invoke   \t Defaulted
+  --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
@@ -67,7 +73,7 @@ Types:
   YN      /^[YNyn]$/
 # <= Hash here, parser breaks out
 # Notes #
-Don't invoke the command.
+I wouldn't touch that!
 HELP
 
 VERSION = "1.2.3"
@@ -82,30 +88,27 @@ HelpParser.string(:arg1, :arg2, :arg3) # for OPTIONS.arg1, etc : String
 #=> [:arg1, :arg2, :arg3]
 
 ## If run as:
-##   deader --age --date=2020-09-07 invoke the command
-OPTIONS.age                  #=> 80
-OPTIONS.args                 #=> ["invoke", "the", "command"]
+##   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
 ```
 
-YOU HAVE INVOKED THE COMMAND...
-YOUR HELP BELONGS TO ME!!!
-
 ## Features
 
-* $DEBUG=true on --debug
-* $VERBOSE=true on --verbose
+* `$DEBUG=true` on --debug
+* `$VERBOSE=true` on --verbose
 * -h and --help simultaneously will check help string for errors
-
-## INSTALL:
-
-    $ sudo gem install help_parser
+* `HelpParser::REDTTY[msg]` will red color output `msg` to `$stderr`.
 
 ## LICENSE:
 
 (The MIT License)
 
-Copyright (c) 2020 CarlosJHR64
+Copyright (c) 2022 CarlosJHR64
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/help_parser/completion.rb

@@ -28,9 +28,14 @@ module HelpParser
     # Diagnose user's usage.
     def diagnose
       dict = {}
-      @specs.each do |k,v|
-        next if RESERVED[k]
-        v.flatten.map{|_|_.scan(/\w+/).first}.each{|_|dict[_]=true}
+      @specs.each do |section,list|
+        next if RESERVED.include? section
+        list.flatten.select{_1[0]=='-'}.each do |key_type|
+          key_type.scan(/\w+/) do |key|
+            dict[key]=true
+            break
+          end
+        end
       end
       typos = @hash.keys.select{|k|k.is_a? String and not dict[k]}
       raise UsageError, MSG[UNRECOGNIZED, typos] unless typos.empty?
@@ -46,10 +51,15 @@ module HelpParser
           regex = t2r[type]
           case value
           when String
-            raise UsageError, "--#{key}=#{value} !~ #{type}=#{regex.inspect}" unless value=~regex
+            unless value=~regex
+              raise UsageError, "--#{key}=#{value} !~ #{type}=#{regex.inspect}"
+            end
           when Array
             value.each do |string|
-              raise UsageError, "--#{key}=#{string} !~ #{type}=#{regex.inspect}" unless string=~regex
+              unless string=~regex
+                raise UsageError,
+                  "--#{key}=#{string} !~ #{type}=#{regex.inspect}"
+              end
             end
           else
             raise UsageError, "--#{key} !~ #{type}=#{regex.inspect}"
@@ -61,7 +71,7 @@ module HelpParser
     def pad
       # Synonyms and defaults:
       @specs.each do |section,options|
-        next if section==USAGE || section==TYPES
+        next if RESERVED.any?{section==_1}
         options.each do |words|
           next unless words.size>1
           first,second,default = words[0],words[1],words[2]
@@ -90,6 +100,8 @@ module HelpParser
                 @hash[long] = default
               end
             end
+          else
+            raise SoftwareError, MSG[UNEXPECTED, words]
           end
         end
       end
@@ -106,22 +118,22 @@ 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)
+          raise NoMatch unless key.is_a? String
           list = @specs[group].flatten.select{|f|f[0]=='-'}.map{|f| F2K[f]}
           raise NoMatch unless list.include?(key)
           unless plus.nil?
             loop do
               key = keys[i+1]
-              break if key.nil? || key.is_a?(Integer) || !list.include?(key)
+              break unless key.is_a?(String) and list.include?(key)
               i+=1
             end
           end
         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,8 +1,19 @@
 module HelpParser
+  VSN = ['v','version']
+  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 = /^(?<name>[A-Z]\w+):$/
 
   # usage
   FLAG       = /^[-][-]?(?<k>\w+)$/
@@ -16,7 +27,8 @@ 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*)$/
 
   # spec W+ /~/
   TYPE_DEF = /^(?<t>[A-Z]+),?\s+\/(?<r>\S+)\/$/
@@ -43,6 +55,7 @@ module HelpParser
   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'
@@ -68,6 +81,7 @@ module HelpParser
   # lambda utilities
   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,INCLUSIVE].include?(k)} # reserved
-  REDTTY = lambda{|msg,out=$stderr| out.tty? ? out.puts("\033[0;31m#{msg}\033[0m"): out.puts(msg)}
+  REDTTY = lambda{|msg,out=$stderr|
+    out.tty? ? out.puts("\033[0;31m#{msg}\033[0m"): out.puts(msg)
+  }
 end

data/lib/help_parser/k2t2r.rb

@@ -1,10 +1,14 @@
 module HelpParser
+  # k2t is an acronym for the "key to type" mapping
   def self.k2t(specs)
     k2t = NoDupHash.new
-    tokens = specs.select{|k,v| !(k==TYPES)}.values.flatten.select{|v|v.include?('=')}
+    # If specs section is not a RESERVED section, it's an options list.
+    tokens = specs.select{|k,v| k==USAGE or not RESERVED.include?(k)}
+      # Tokens associating a key to a type.
+      .values.flatten.select{|v|v.include?('=')}
     tokens.each do |token|
       if match = VARIABLE.match(token) || LONG.match(token)
-        name, type = match['k'], match['t']
+        name, type = match[:k], match[:t]
         if _=k2t[name]
           raise HelpError, MSG[INCONSISTENT,name,type,_]  unless type==_
         else
@@ -18,6 +22,7 @@ module HelpParser
     return k2t
   end
 
+  # t2r is an acronym for "type to regexp"
   def self.t2r(specs)
     if types = specs[TYPES]
       t2r = NoDupHash.new

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
@@ -64,9 +66,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}
-      f = @hash['#{name}']
-      raise if f.nil?
-      f.to_f
+      @hash['#{name}']&.to_f or raise
     rescue
       raise UsageError, MSG[NOT_FLOAT,'#{name}']
     end
@@ -81,9 +81,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}?
-      f = @hash['#{name}']
-      f = f.to_f if f
-      return f
+      @hash['#{name}']&.to_f
     rescue
       raise UsageError, MSG[NOT_FLOAT,'#{name}']
     end
@@ -98,9 +96,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}
-      f = @hash['#{name}']
-      raise unless f.is_a?(Array)
-      f.map{|_|_.to_f}
+      @hash['#{name}'].map{_1.to_f}
     rescue
       raise UsageError, MSG[#{NOT_FLOATS},'#{name}']
     end
@@ -115,10 +111,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}?
-      f = @hash['#{name}']
-      return nil unless f
-      raise unless f.is_a?(Array)
-      f.map{|_|_.to_f}
+      @hash['#{name}']&.map{_1.to_f}
     rescue
       raise UsageError, MSG[NOT_FLOATS,'#{name}']
     end
@@ -133,9 +126,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}
-      f = @hash['#{name}']
-      raise if f.nil?
-      f.to_i
+      @hash['#{name}']&.to_i or raise
     rescue
       raise UsageError, MSG[NOT_INTEGER,'#{name}']
     end
@@ -150,9 +141,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}?
-      f = @hash['#{name}']
-      f = f.to_i if f
-      return f
+      @hash['#{name}']&.to_i
     rescue
       raise UsageError, MSG[NOT_INTEGER,'#{name}']
     end
@@ -167,9 +156,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}
-      f = @hash['#{name}']
-      raise unless f.is_a?(Array)
-      f.map{|_|_.to_i}
+      @hash['#{name}'].map{_1.to_i}
     rescue
       raise UsageError, MSG[NOT_INTEGERS,'#{name}']
     end
@@ -184,10 +171,7 @@ module HelpParser
       code = <<-CODE
   class Options
     def #{name}?
-      f = @hash['#{name}']
-      return nil unless f
-      raise unless f.is_a?(Array)
-      f.map{|_|_.to_i}
+      @hash['#{name}']&.map{_1.to_i}
     rescue
       raise UsageError, MSG[NOT_INTEGERS,'#{name}']
     end

data/lib/help_parser/options.rb

@@ -2,36 +2,44 @@ 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 && VSN.any?{@hash.has_key? _1}
         # -v or --version
         raise VersionException, version
       end
       if help
-        h = ['h', 'help']
-        if h.any?{|_|@hash.key?_}
-          HelpParser.parseh(help, validate: true)  if h.all?{|_|@hash.key?_}
+        if HLP.any?{@hash.key? _1}
+          HelpParser.parseh(help, validate: true)  if HLP.all?{@hash.key? _1}
           raise HelpException, help
         end
         specs = HelpParser.parseh(help)
         Completion.new(@hash, specs)
         if exclusive=specs[EXCLUSIVE]
           exclusive.each do |x|
-            count = @hash.keys.count{|k|x.include?(k)}
+            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 = @hash.keys.count{|k|i.include?(k)}
-            raise HelpParser::UsageError, MSG[INCLUSIVE_KEYS,*i] unless count==0 or count==i.length
+            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
-      $DEBUG = true if @hash['debug']==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

@@ -4,8 +4,8 @@ module HelpParser
     help.each_line do |line|
       line.chomp!
       next if line==''
-      if line=~/^[A-Z]\w+:$/
-        name = line[0..-2].downcase
+      if md = SECTION_NAME.match(line)
+        name = md[:name].downcase
         specs[name] = []
       else
         next if name==''
@@ -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.balanced_brackets(spec.chars) if validate
           tokens = HelpParser.parseu(spec.chars)
-          HelpParser.validate_usage_tokens(tokens) if validate
+          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
+          if validate and not spec=~TYPE_DEF
+            raise HelpError, MSG[UNRECOGNIZED_TYPE,spec]
+          end
           specs[TYPES].push spec.split(CSV)
-        when EXCLUSIVE,INCLUSIVE
-          raise HelpError, MSG[UNRECOGNIZED_X,spec] if validate and not spec=~X_DEF
+        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/parseu.rb

@@ -1,4 +1,8 @@
 module HelpParser
+  # Chars := String.split(/\t/,2).first.strip.chars
+  # Token := String=~/^[^ \[\]]$/
+  # Note that emergent Token is String=~/^[^\s\[\]]$/
+  # Tokens := Array(Token|Tokens)
   def self.parseu(chars)
     tokens,token = [],''
     while c = chars.shift

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

@@ -1,5 +1,6 @@
 module HelpParser
-  def self.validate_line_chars(chars)
+module Validate
+  def self.balanced_brackets(chars)
     count = 0
     chars.each do |c|
       if c=='['
@@ -12,30 +13,29 @@ 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)     ||
-              token.match(LITERAL)  ||
-              token.match(VARIABLE) ||
-              token.match(FLAG_GROUP)
-      raise HelpError, MSG[UNRECOGNIZED_TOKEN,token] unless match
-      words.push match['k'] # key
+      raise HelpError, MSG[UNRECOGNIZED_TOKEN,token] unless
+      [FLAG,LITERAL,VARIABLE,FLAG_GROUP]
+      .detect{_=token.match(_1) and words.push(_[:k])}
     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]}
-    flags = option_specs.values.flatten.select{|f|f[0]=='-'}.map{|f| F2K[f]}
-    [EXCLUSIVE,INCLUSIVE].each do |k|
+  def self.usage_specs(specs)
+    flags = specs.select{|a,b| not RESERVED.include? a}.values.flatten
+           .select{|f|f[0]=='-'}.map{|f| F2K[f]}
+    FLAG_CLUMPS.each do |k|
       if a=specs[k]
         seen = {}
         a.each do |xs|
           k = xs.sort.join(' ').to_sym
-          raise HelpError, MSG[DUP_X,k] if seen[k] or not xs.length==xs.uniq.length
+          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)
@@ -51,7 +51,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
@@ -59,19 +59,19 @@ 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))}
       raise HelpError, MSG[UNCOMPLETED_TYPES,c.join(',')]
     end
     specs.each do |section,tokens|
-      next if section==USAGE || section==TYPES
+      next if RESERVED.include? section
       tokens.each do |words|
         next if words.size<2
         default = words[-1]
@@ -82,8 +82,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 = '7.0.200907'
+  VERSION = '8.1.221206'
+  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,20 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: help_parser
 version: !ruby/object:Gem::Version
-  version: 7.0.200907
+  version: 8.1.221206
 platform: ruby
 authors:
-- carlosjhr64
+- CarlosJHR64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-07 00:00:00.000000000 Z
+date: 2022-12-06 00:00:00.000000000 Z
 dependencies: []
-description: |
-  Can't help YOU???
-  You're not the first to say that...
-
-  I will parse your help!
+description: "Welcome to Help Parser!  \nDo you have your help text?  \nLet's parse!\n"
 email: carlosjhr64@gmail.com
 executables: []
 extensions: []
@@ -33,8 +29,8 @@ 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: {}
@@ -53,9 +49,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.7.1p83 (2020-03-31 revision a0c7c23c9c) [x86_64-linux]'
-rubygems_version: 3.1.2
+- 'ruby: ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [aarch64-linux]'
+rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
-summary: Can't help YOU??? You're not the first to say that...
+summary: Welcome to Help Parser!   Do you have your help text?   Let's parse!
 test_files: []