help_parser 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9580ecb3144e3be88b6961efc2e1edae53964c01
-  data.tar.gz: 8924fbd437d234ab59ce1f1bc319be6f9287b93d
+  metadata.gz: 5b2c52b4521273e3423cf52dbb22b9f475fedade
+  data.tar.gz: 67c4807edaa755306f43b30ca85cf0400250a8d6
 SHA512:
-  metadata.gz: d4f0bc72cefd932f76302436d2f898267169a7fc847af683d225333d8d2a7423e9919266b69e03e3168604b6683c4ee1fedbd930d90c837b914f6a601203dac3
-  data.tar.gz: e0af58d61f6825f2e72615a3fafc352a3f8b7296b5cfa0f559e3ed5092eaaf8ac9fc2b9306146e292200e9fd77281d2dd0e6595f2d582635b23e9a3f3064e75b
+  metadata.gz: be5f3fde5967198c766bf2e6dfcdfd084476d6843ae43b0f76243753c8ddb7e498d509d10f2f0fba33d78c07f39bd43159d5a0a000b5347f3ad8794224873b34
+  data.tar.gz: a07a636b9c9f0c5b482fcd7a2442c01d680d601854f1822954071778945308df2f76e438c86ca53d102db203a378b6f01bc75363aca5b4095fa8fe70ea5ae5e0

data/History.txt

@@ -1 +1,3 @@
 === 0.0.0 / 2013-12-04
+=== 1.0.2 / 2013-12-13 12:22:05 -0800
+773a9196081c53bd8c90252bdfae7db7  pkg/help_parser-1.0.2.gem

data/Manifest.txt

@@ -1,7 +1,6 @@
 History.txt
 Manifest.txt
 README.rdoc
-Rakefile
 TODO.txt
 examples/command_suite
 examples/implementation_error_duplicate_key
@@ -14,10 +13,13 @@ features/step_definitions/help_parser_steps.rb
 features/suite.feature
 help_parser.gemspec
 lib/help_parser.rb
+lib/help_parser/errors.rb
+lib/help_parser/functions.rb
+lib/help_parser/help_exception.rb
 lib/help_parser/help_parser.rb
+lib/help_parser/implementation_error.rb
+lib/help_parser/usage_error.rb
+lib/help_parser/usage_exception.rb
 lib/help_parser/version.rb
-tasks/gemspecker.rb
-tasks/manifester.rb
-tasks/syntaxer.rb
-tasks/unit_tests.rb
+lib/help_parser/version_exception.rb
 test/help_parser.rb

data/TODO.txt

@@ -0,0 +1,3 @@
+== File List
+
+

data/help_parser.gemspec

@@ -1,14 +1,14 @@
 Gem::Specification.new do |s|
 
   s.name     = 'help_parser'
-  s.version  = '1.0.2'
+  s.version  = '1.1.0'
 
   s.homepage = 'https://github.com/carlosjhr64/help_parser'
 
   s.author   = 'CarlosJHR64'
   s.email    = 'carlosjhr64@gmail.com'
 
-  s.date     = '2013-12-13'
+  s.date     = '2013-12-16'
   s.licenses = ['MIT']
 
   s.description = <<DESCRIPTION
@@ -27,7 +27,6 @@ SUMMARY
 History.txt
 Manifest.txt
 README.rdoc
-Rakefile
 TODO.txt
 examples/command_suite
 examples/implementation_error_duplicate_key
@@ -40,13 +39,21 @@ features/step_definitions/help_parser_steps.rb
 features/suite.feature
 help_parser.gemspec
 lib/help_parser.rb
+lib/help_parser/errors.rb
+lib/help_parser/functions.rb
+lib/help_parser/help_exception.rb
 lib/help_parser/help_parser.rb
+lib/help_parser/implementation_error.rb
+lib/help_parser/usage_error.rb
+lib/help_parser/usage_exception.rb
 lib/help_parser/version.rb
-tasks/gemspecker.rb
-tasks/manifester.rb
-tasks/syntaxer.rb
-tasks/unit_tests.rb
+lib/help_parser/version_exception.rb
 test/help_parser.rb
-)
+  )
+
+  s.add_development_dependency 'rainbow', '~> 1.1', '>= 1.1.4'
+  s.add_development_dependency 'test-unit', '~> 2.5', '>= 2.5.5'
+  s.requirements << 'requires json in development'
+  s.requirements << 'requires open3 in development'
 
 end

data/lib/help_parser.rb

@@ -1,2 +1,9 @@
 require 'help_parser/version.rb'
+require 'help_parser/usage_exception'
+require 'help_parser/help_exception'
+require 'help_parser/version_exception'
+require 'help_parser/implementation_error'
+require 'help_parser/usage_error'
+require 'help_parser/errors'
+require 'help_parser/functions'
 require 'help_parser/help_parser.rb'

data/lib/help_parser/errors.rb

@@ -0,0 +1,17 @@
+module HELP_PARSER
+  # Used to *include* in a class.
+  module Errors
+    # HelpParser#usage_error will have make the HelpParser
+    # object raise a UsageError error with the given message.
+    def usage_error(msg)
+      raise UsageError, [msg, self]
+    end
+
+    # HelpParser#implementation_error will have make the
+    # HelpParser object raise a UsageError error with the
+    # given message.
+    def implementation_error(msg)
+      raise ImplementationError, [msg, self]
+    end
+  end
+end

data/lib/help_parser/functions.rb

@@ -0,0 +1,62 @@
+module HELP_PARSER
+  # I'm wrapping class functions in a Function module.
+  # Used to *extend* a class.
+  module Functions
+
+    # HelpParser.to_value
+    def to_value(string)
+      case string
+      when /^-?\d+$/
+        return string.to_i
+      when /^-?\d+\.\d+$/
+        return string.to_f
+      when /,/
+        return string.split(',').map{|s| to_value(s)}
+      end
+      return string
+    end
+
+    # HelpParser.str2sym converts String keys to
+    # Symbol.  Symbol keys can have '-', but it's cumbersome
+    # notation:
+    #    :"a-b"
+    # So I translate it to underscore:
+    #    :a_b
+    def str2sym(str)
+      str.gsub('-','_').to_sym
+    end
+
+    # HelpParser.parse parses the @argv for command line
+    # options, shifting them out, and passes on the key-value
+    # pairs to the block.  The keys are translated to their
+    # short version if available, and the values are converted
+    # to their best interpreted form as per Funtion.to_value.
+    # Furthermore, no-key values are negated.
+    def parse(argv, obj, &block)
+      while argv[0] and argv[0][0]=='-'
+        option = argv.shift[1..-1]
+        if option[0]=='-'
+          loption, value = option[1..-1].split('=', 2)
+          if loption=~/no-(\w.*)$/
+            loption = $1
+            if value
+              raise UsageError, ["no-key should not have value: no-#{loption}=#{value}", obj]
+            end
+            value = false
+          end
+          if value.nil?
+            value = true
+            block.call loption, value
+          else
+            block.call loption, self.to_value(value)
+          end
+        else
+          # These are single character options...
+          option.each_char do |c|
+            block.call c, true
+          end
+        end
+      end
+    end
+  end
+end

data/lib/help_parser/help_exception.rb

@@ -0,0 +1,16 @@
+module HELP_PARSER
+  # HelpException is a type of UsageException, where the
+  # user asks for help in the command line options.  The
+  # raise in a class method is as follows:
+  #    raise HelpException, self
+  # The object that raised the exception will be available
+  # as:
+  #    $!.obj
+  # The message will be the help text:
+  #    $!.message == $!.obj.help # => true
+  class HelpException < UsageException
+    def initialize(help_parser)
+      super([help_parser.help, help_parser])
+    end
+  end
+end

data/lib/help_parser/help_parser.rb

@@ -1,285 +1,128 @@
 module HELP_PARSER
+  class HelpParser < Hash
+    include Errors
+    extend  Functions
 
-  # **UsageError** is an error when the user passed command
-  # line options that are inconsistent with expectations.
-  # The raise in a class method is as follows:
-  #    raise UsageError, [message, self]
-  # The object that raised the error will be available as:
-  #    $!.obj
-  class UsageError < StandardError
-    attr_accessor :obj
-    def initialize(array)
-      self.obj = array.pop
-      msg = array.pop
-      super(msg)
+    def parse(&block)
+      HelpParser.parse(@argv, self, &block)
     end
-  end
-  # **ImplementationError** is an error due to a
-  # inconsistent help text.  The raise in a class method is
-  # as follows:
-  #    raise ImplementationError, [message, self]
-  # The object that raised the error will be available as:
-  #    $!.obj
-  class ImplementationError < StandardError
-    attr_accessor :obj
-    def initialize(array)
-      self.obj = array.pop
-      msg = array.pop
-      super(msg)
-    end
-  end
-
-  # UsageException is an actual exception to normal flow.
-  # For example, when a user asks for help or version
-  # number in the command line options.  The raise in a
-  # class method is as follows:
-  #    raise UsageException, [message, self]
-  # The object that raised the exception will be available
-  # as:
-  #    $!.obj
-  class UsageException < Exception
-    attr_accessor :obj
-    def initialize(array)
-      self.obj = array.pop
-      msg = array.pop
-      super(msg)
-    end
-  end
-
-  # HelpException is a type of UsageException, where the
-  # user asks for help in the command line options.  The
-  # raise in a class method is as follows:
-  #    raise HelpException, self
-  # The object that raised the exception will be available
-  # as:
-  #    $!.obj
-  # The message will be the help text:
-  #    $!.message == $!.obj.help # => true
-  class HelpException < UsageException
-    def initialize(help_parser)
-      super([help_parser.help, help_parser])
-    end
-  end
-
-  # VersionException is a type of UsageException, where the
-  # user asks for version in the command line options.  The
-  # raise in a class method is as follows:
-  #    raise VersionException, self
-  # The object that raised the exception will be available
-  # as:
-  #    $!.obj
-  # The message will be the version text:
-  #    $!.message == $!.obj.version # => true
-  class VersionException < UsageException
-    def initialize(help_parser)
-      super([help_parser.version, help_parser])
-    end
-  end
-
-  module Errors
-    # HelpParser#usage_error will have make the HelpParser
-    # object raise a UsageError error with the given message.
-    def usage_error(msg)
-      raise UsageError, [msg, self]
-    end
-
-    # HelpParser#implementation_error will have make the
-    # HelpParser object raise a UsageError error with the
-    # given message.
-    def implementation_error(msg)
-      raise ImplementationError, [msg, self]
-    end
-  end
 
-class HelpParser < Hash
-include Errors
 
-  # I'm wrapping class functions in a Function module.
-  module Function
+    # HelpParser.new(version, help, argv=ARGV, dict={})
+    # Not necessarily in that order, see the code.
+    attr_reader :version, :help, :dict
+    def initialize(*parameters)
+      super()
 
-    # I'm wrapping Function's helper functions in a Private
-    # module.
-    module Private
-      # HelpParser::Function::Private.to_value
-      def to_value(string)
-        case string
-        when /^-?\d+$/
-          return string.to_i
-        when /^-?\d+\.\d+$/
-          return string.to_f
-        when /,/
-          return string.split(',').map{|s| to_value(s)}
+      # Figure out what parameters you were given...
+      @argv      = parameters.detect{|parameter| parameter.class == Array} || ARGV
+      @dict      = parameters.detect{|parameter| parameter.class == Hash } || {}
+      parameters = parameters.select{|parameter| parameter.class == String}
+      @version   = parameters.shift
+      @help      = parameters.pop
+ 
+      raise "Need help" unless @help
+      raise "Need version" unless @version
+
+      # We ensure the following two mappings...
+      @dict[:help] = :h
+      @dict[:version] = :v
+
+      # Using the help for the options definition
+      @help.split("\n").select{|l|
+        (l=~/^\s*-/)
+      }.map{|l|
+        l.strip.split(/[,\s]+/)[0..1].select{|o|
+          o[0]=='-'
+        }.map{|o|
+          HelpParser.str2sym o.sub(/--?/,'').sub(/=.*$/,'')
+        }.reverse
+      }.each do |k,v|
+        unless @dict[k].nil?
+          # This is an implementation error.  The help text is inconsistent.
+          # Note that we may have been given @dict, and we're verifying the help.
+          implementation_error "#{k} redefinition from #{@dict[k]} to #{v}." unless @dict[k]==v
         end
-        return string
+        @dict[k]=v
       end
-    end
-    extend Private
 
-    # HelpParser::Function.str2sym converts String keys to
-    # Symbol.  Symbol keys can have '-', but it's cumbersome
-    # notation:
-    #    :"a-b"
-    # So I translate it to underscore:
-    #    :a_b
-    def str2sym(str)
-      str.gsub('-','_').to_sym
-    end
-
-    # HelpParser#parse parses the @argv for command line
-    # options, shifting them out, and passes on the key-value
-    # pairs to the block.  The keys are translated to their
-    # short version if available, and the values are converted
-    # to their best interpreted form as per Funtion.to_value.
-    # Furthermore, no-key values are negated.
-    def parse(argv, obj, &block)
-      while argv[0] and argv[0][0]=='-'
-        option = argv.shift[1..-1]
-        if option[0]=='-'
-          loption, value = option[1..-1].split('=', 2)
-          if loption=~/no-(\w.*)$/
-            loption = $1
-            if value
-              raise UsageError, ["no-key should not have value: no-#{loption}=#{value}", obj]
-            end
-            value = false
-          end
-          if value.nil?
-            value = true
-            block.call loption, value
-          else
-            block.call loption, Function.to_value(value)
+      # Values must be terminal states, that is for example:
+      # if :version => :v, then :v => nil.
+      terminals = []
+      @dict.each do |k,v|
+        next if v.nil?
+        if @dict.has_key?(v)
+          unless @dict[v].nil?
+            implementation_error "Expected terminal #{v}:  #{k} => #{v} => #{@dict[v]}"
           end
         else
-          # These are single character options...
-          option.each_char do |c|
-            block.call c, true
-          end
+          terminals.push(v)
         end
       end
-    end
-  end
-  extend Function
-
-  def parse(&block)
-    HelpParser.parse(@argv, self, &block)
-  end
-
-
-  # HelpParser.new(version, help, argv=ARGV, dict={})
-  # Not necessarily in that order, see the code.
-  attr_reader :version, :help, :dict
-  def initialize(*parameters)
-    super()
-
-    # Figure out what parameters you were given...
-    @argv      = parameters.detect{|parameter| parameter.class == Array} || ARGV
-    @dict      = parameters.detect{|parameter| parameter.class == Hash } || {}
-    parameters = parameters.select{|parameter| parameter.class == String}
-    @version   = parameters.shift
-    @help      = parameters.pop
- 
-    raise "Need help" unless @help
-    raise "Need version" unless @version
-
-    # We ensure the following two mappings...
-    @dict[:help] = :h
-    @dict[:version] = :v
-
-    # Using the help for the options definition
-    @help.split("\n").select{|l|
-      (l=~/^\s*-/)
-    }.map{|l|
-      l.strip.split(/[,\s]+/)[0..1].select{|o|
-        o[0]=='-'
-      }.map{|o|
-        HelpParser.str2sym o.sub(/--?/,'').sub(/=.*$/,'')
-      }.reverse
-    }.each do |k,v|
-      unless @dict[k].nil?
-        # This is an implementation error.  The help text is inconsistent.
-        # Note that we may have been given @dict, and we're verifying the help.
-        implementation_error "#{k} redefinition from #{@dict[k]} to #{v}." unless @dict[k]==v
+      terminals.each{|v| @dict[v] = nil}
+
+      # Parsing command line options
+      parse do |opt, value|
+        key = HelpParser.str2sym opt
+        # Translate key to the terminal key.
+        key = @dict[key] unless @dict[key].nil?
+        # Ensure user only uses the defined keys.
+        usage_error "not a valid option:  #{opt}" unless @dict.has_key?(key)
+        # As we parse ARGV, we should only be setting keys once.
+        usage_error "duplicate command line option:  #{opt}" if self.has_key?(key)
+        self[key] = value
       end
-      @dict[k]=v
-    end
 
-    # Values must be terminal states, that is for example:
-    # if :version => :v, then :v => nil.
-    terminals = []
-    @dict.each do |k,v|
-      next if v.nil?
-      if @dict.has_key?(v)
-        unless @dict[v].nil?
-          implementation_error "Expected terminal #{v}:  #{k} => #{v} => #{@dict[v]}"
+      # The parse takes all options to its terminal value.
+      # Now set the synonims...
+      @dict.each do |synonim, terminal|
+        next if terminal.nil?
+        if self.has_key?(terminal)
+          # I did not mean for the synonyms to have been set yet, so if I do,
+          # I have a bug somewhere.
+          raise "unexpected key overwrite" if self.has_key?(synonim)
+          self[synonim] = self[terminal]
         end
-      else
-        terminals.push(v)
       end
-    end
-    terminals.each{|v| @dict[v] = nil}
 
-    # Parsing command line options
-    parse do |opt, value|
-      key = HelpParser.str2sym opt
-      # Translate key to the terminal key.
-      key = @dict[key] unless @dict[key].nil?
-      # Ensure user only uses the defined keys.
-      usage_error "not a valid option:  #{opt}" unless @dict.has_key?(key)
-      # As we parse ARGV, we should only be setting keys once.
-      usage_error "duplicate command line option:  #{opt}" if self.has_key?(key)
-      self[key] = value
+      # Did the user ask for help or version?
+      raise HelpException,    self if self[:h]==true
+      raise VersionException, self if self[:v]==true
     end
 
-    # The parse takes all options to its terminal value.
-    # Now set the synonims...
-    @dict.each do |synonim, terminal|
-      next if terminal.nil?
-      if self.has_key?(terminal)
-        # I did not mean for the synonyms to have been set yet, so if I do,
-        # I have a bug somewhere.
-        raise "unexpected key overwrite" if self.has_key?(synonim)
-        self[synonim] = self[terminal]
-      end
+    # HelpParser#defaults is a helper method to []
+    def defaults(symbol, default1, default2=default1)
+      type = (default2 || default1).class
+      a = self[symbol]
+      value = (a.nil?)? default1 : a
+      value = default2 if value==true
+      # !value is true if value is false or nil.
+      usage_error "type error: #{symbol} needs to be #{type}" unless !value or value.class == type
+      return value
     end
 
-    # Did the user ask for help or version?
-    raise HelpException,    self if self[:h]==true
-    raise VersionException, self if self[:v]==true
-  end
-
-  # HelpParser#defaults is a helper method to []
-  def defaults(symbol, default1, default2=default1)
-    type = (default2 || default1).class
-    a = self[symbol]
-    value = (a.nil?)? default1 : a
-    value = default2 if value==true
-    # !value is true if value is false or nil.
-    usage_error "type error: #{symbol} needs to be #{type}" unless !value or value.class == type
-    return value
-  end
-
-  # HelpParser#defaults! is used to replace value with a
-  # default in the hash, self.
-  def defaults!(symbol, default1, default2)
-    self[symbol] = defaults(symbol, default1, default2)
-  end
+    # HelpParser#defaults! is used to replace value with a
+    # default in the hash, self.
+    def defaults!(symbol, default1, default2)
+      self[symbol] = defaults(symbol, default1, default2)
+    end
 
-  # HelpParser#[k, default1=nil, default2=nil]
-  # Basically, for #[k, default1, default2]:
-  #    value = help_parser[k]
-  #    case value
-  #      when nil  then default1
-  #      when true then default2
-  #      else value
-  #    end
-  # For #[k, default1]:
-  #    value = help_parser[k] || default1
-  # For #[k]:
-  #    help_parser[k]
-  # Raises a UsageError if the value is not of the expected
-  # type as given by the last default.
-  def [](k, *defaults12)
-    (defaults12.length==0)? super(k) : defaults(k, *defaults12)
+    # HelpParser#[k, default1=nil, default2=nil]
+    # Basically, for #[k, default1, default2]:
+    #    value = help_parser[k]
+    #    case value
+    #      when nil  then default1
+    #      when true then default2
+    #      else value
+    #    end
+    # For #[k, default1]:
+    #    value = help_parser[k] || default1
+    # For #[k]:
+    #    help_parser[k]
+    # Raises a UsageError if the value is not of the expected
+    # type as given by the last default.
+    def [](k, *defaults12)
+      (defaults12.length==0)? super(k) : defaults(k, *defaults12)
+    end
   end
 end
-end

data/lib/help_parser/implementation_error.rb

@@ -0,0 +1,16 @@
+module HELP_PARSER
+  # **ImplementationError** is an error due to a
+  # inconsistent help text.  The raise in a class method is
+  # as follows:
+  #    raise ImplementationError, [message, self]
+  # The object that raised the error will be available as:
+  #    $!.obj
+  class ImplementationError < StandardError
+    attr_accessor :obj
+    def initialize(array)
+      self.obj = array.pop
+      msg = array.pop
+      super(msg)
+    end
+  end
+end

data/lib/help_parser/usage_error.rb

@@ -0,0 +1,16 @@
+module HELP_PARSER
+  # **UsageError** is an error when the user passed command
+  # line options that are inconsistent with expectations.
+  # The raise in a class method is as follows:
+  #    raise UsageError, [message, self]
+  # The object that raised the error will be available as:
+  #    $!.obj
+  class UsageError < StandardError
+    attr_accessor :obj
+    def initialize(array)
+      self.obj = array.pop
+      msg = array.pop
+      super(msg)
+    end
+  end
+end

data/lib/help_parser/usage_exception.rb

@@ -0,0 +1,18 @@
+module HELP_PARSER
+  # UsageException is an actual exception to normal flow.
+  # For example, when a user asks for help or version
+  # number in the command line options.  The raise in a
+  # class method is as follows:
+  #    raise UsageException, [message, self]
+  # The object that raised the exception will be available
+  # as:
+  #    $!.obj
+  class UsageException < Exception
+    attr_accessor :obj
+    def initialize(array)
+      self.obj = array.pop
+      msg = array.pop
+      super(msg)
+    end
+  end
+end

data/lib/help_parser/version.rb

@@ -1,3 +1,3 @@
 module HELP_PARSER
-  VERSION = '1.0.2'
+  VERSION = '1.1.0'
 end

data/lib/help_parser/version_exception.rb

@@ -0,0 +1,16 @@
+module HELP_PARSER
+  # VersionException is a type of UsageException, where the
+  # user asks for version in the command line options.  The
+  # raise in a class method is as follows:
+  #    raise VersionException, self
+  # The object that raised the exception will be available
+  # as:
+  #    $!.obj
+  # The message will be the version text:
+  #    $!.message == $!.obj.version # => true
+  class VersionException < UsageException
+    def initialize(help_parser)
+      super([help_parser.version, help_parser])
+    end
+  end
+end

data/test/help_parser.rb

@@ -1,5 +1,5 @@
 require 'test/unit'
-require 'help_parser/help_parser'
+require 'help_parser'
 
 class Test_HELP_PARSER_HelpParser < Test::Unit::TestCase
   include HELP_PARSER
@@ -142,7 +142,7 @@ class Test_HELP_PARSER_HelpParser < Test::Unit::TestCase
 
   def test_008_to_value
     [['1', Integer], ['1.0', Float], ['One', String], ['1,2.0,Three', Array]].each do |string, type|
-      value = HelpParser::Function.to_value(string)
+      value = HelpParser.to_value(string)
       assert( value.kind_of?(type) )
     end
   end

metadata

@@ -1,15 +1,55 @@
 --- !ruby/object:Gem::Specification
 name: help_parser
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - CarlosJHR64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-13 00:00:00.000000000 Z
-dependencies: []
+date: 2013-12-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.4
+- !ruby/object:Gem::Dependency
+  name: test-unit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.5.5
 description: |
   _HelpParser_ - Parses your help text to define your command line options.
 email: carlosjhr64@gmail.com
@@ -21,7 +61,6 @@ files:
 - History.txt
 - Manifest.txt
 - README.rdoc
-- Rakefile
 - TODO.txt
 - examples/command_suite
 - examples/implementation_error_duplicate_key
@@ -34,12 +73,15 @@ files:
 - features/suite.feature
 - help_parser.gemspec
 - lib/help_parser.rb
+- lib/help_parser/errors.rb
+- lib/help_parser/functions.rb
+- lib/help_parser/help_exception.rb
 - lib/help_parser/help_parser.rb
+- lib/help_parser/implementation_error.rb
+- lib/help_parser/usage_error.rb
+- lib/help_parser/usage_exception.rb
 - lib/help_parser/version.rb
-- tasks/gemspecker.rb
-- tasks/manifester.rb
-- tasks/syntaxer.rb
-- tasks/unit_tests.rb
+- lib/help_parser/version_exception.rb
 - test/help_parser.rb
 homepage: https://github.com/carlosjhr64/help_parser
 licenses:
@@ -61,7 +103,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-requirements: []
+requirements:
+- requires json in development
+- requires open3 in development
 rubyforge_project: 
 rubygems_version: 2.0.3
 signing_key: 

data/Rakefile

@@ -1,94 +0,0 @@
-require 'find'
-
-module RakingTasks
-  def RakingTasks.git_tag_list
-    `git tag --list`.strip.split("\n")
-  end
-
-  def RakingTasks.git_status_porcelain
-    `git status --porcelain`.strip
-  end
-
-  def RakingTasks.gemspec_files
-    `ls ./*.gemspec 2> /dev/null`.strip.split("\n")
-  end
-
-  def RakingTasks.uniq_gemspec_file
-    gemspecs = RakingTasks.gemspec_files
-    raise "Gemspec file not found" if gemspecs.length == 0
-    raise "Mutiple gemspec files found" if gemspecs.length > 1
-    gemspecs.first
-  end
-
-  def RakingTasks.pkg_gem_files
-    `ls ./pkg/*.gem 2> /dev/null`.strip.split("\n")
-  end
-
-  def RakingTasks.gem_files
-    `ls ./*.gem 2> /dev/null`.strip.split("\n")
-  end
-
-  def RakingTasks.uniq_gem_file
-    gems = RakingTasks.gem_files
-    raise "Gem file not found" if gems.length == 0
-    raise "Multiple gem files found" if gems.length > 1
-    gems.first
-  end
-
-  def RakingTasks.gem_build
-    raise "Git status not clear" unless RakingTasks.git_status_porcelain.length == 0
-    gems = RakingTasks.gem_files
-    raise "Found gem files: #{gems.join(',')}" unless gems.length == 0
-    gemspec = RakingTasks.uniq_gemspec_file
-    system("gem build #{gemspec}")
-  end
-
-  def RakingTasks.load_existing_tasks
-    if Dir.exist?('./tasks')
-      Find.find('./tasks') do |fn|
-        require fn if fn=~/\.rb/
-      end
-    end
-  end
-end
-RakingTasks.load_existing_tasks
-
-desc 'By default, run git status'
-task :default do
-  system('git status')
-end
-
-desc 'Cucumbers tests'
-task :cucumber do
-  system('cucumber -f progress')
-end
-
-desc 'Runs all tests'
-task :'test-all' => [:syntaxer, :'unit-tests', :cucumber]
-
-desc 'Builds pre-release gem for testing, not published.'
-task :gem_build do
-  RakingTasks.gem_build
-end
-
-desc 'pushes to rubygems and git'
-task :publish, :version do |t, args|
-  version = args[:version]
-  tags = RakingTasks.git_tag_list
-  raise "#{version} in git tag list" if tags.include?(version)
-  RakingTasks.gem_build
-  gem = File.basename RakingTasks.uniq_gem_file
-  raise "#{version} did not match gem file" unless gem.include?(version)
-  pkgem = File.join('pkg', gem)
-  raise "pkg/#{gem} exists!?" if File.exist? pkgem
-  if system("gem push #{gem}")
-    File.rename(gem, pkgem)
-    File.open('./History.txt', 'a'){|fh| fh.puts "=== #{version} / #{Time.now}"}
-    File.open('./History.txt', 'a'){|fh| fh.puts `md5sum #{pkgem}`}
-    system("git commit -m '#{version}' ./History.txt")
-    system("git tag '#{version}'")
-    system('git push')
-  else
-    File.unlink(gem)
-  end
-end

data/tasks/gemspecker.rb

@@ -1,60 +0,0 @@
-#!/usr/bin/env ruby
-require 'date'
-
-module Gemspecker
-def self.task
-
-name        = File.basename(Dir.getwd)
-version     = File.read("lib/#{name}/version.rb").match(/\d+\.\d+\.\d+/)[0]
-date        = Date.today.to_s
-author      = `git config user.name`.strip
-email       = `git config user.email`.strip
-            # get the first readme, preferably rdoc.
-readme      = `ls README.rdoc README.txt README* 2> /dev/null`.split.first.strip
-description = File.read(readme).match(/DESCRIPTION:([^=]*)/i)[1].strip
-summary     = description.split(/\n\n/).first
-
-# ./name.gemspec
-File.open("./#{name}.gemspec", 'w') do |gemspec|
-
-### Gem Specification ####
-gemspec.puts <<EOT
-Gem::Specification.new do |s|
-
-  s.name     = '#{name}'
-  s.version  = '#{version}'
-
-  s.homepage = 'https://github.com/#{author.downcase}/#{name}'
-
-  s.author   = '#{author}'
-  s.email    = '#{email}'
-
-  s.date     = '#{date}'
-  s.licenses = ['MIT']
-
-  s.description = <<DESCRIPTION
-#{description}
-DESCRIPTION
-
-  s.summary = <<SUMMARY
-#{summary}
-SUMMARY
-
-  s.extra_rdoc_files = ['#{readme}']
-  s.rdoc_options     = ["--main", "#{readme}"]
-
-  s.require_paths = ["lib"]
-  s.files = %w(
-#{`git ls-files`})
-
-end
-EOT
-
-end
-end
-end
-
-desc "Create/Update gemspec"
-task :gemspecker do
-  Gemspecker.task
-end

data/tasks/manifester.rb

@@ -1,13 +0,0 @@
-#!/usr/bin/env ruby
-require 'date'
-
-module Manifester
-  def self.task
-    system('git ls-files > Manifest.txt')
-  end
-end
-
-desc "Creates/Updates Manifest"
-task :manifester do
-  Manifester.task
-end

data/tasks/syntaxer.rb

@@ -1,25 +0,0 @@
-#!/usr/bin/env ruby
-require 'find'
-require 'open3'
-require 'rainbow'
-
-module Syntaxer
-  def self.task
-    count = 0
-    Find.find('.') do |fn|
-      if fn=~/\.rb$/
-        stdout, stderr, process = Open3.capture3("ruby -c #{fn}")
-        unless process.exitstatus == 0
-          count += 1
-          puts stderr.chomp.color(:red)
-        end
-      end
-    end
-    puts "No syntax errors found.".color(:green) if count == 0
-  end
-end
-
-desc "Checks *.rb's syntax"
-task :syntaxer do
-  Syntaxer.task
-end

data/tasks/unit_tests.rb

@@ -1,18 +0,0 @@
-#!/usr/bin/env ruby
-require 'find'
-
-module UnitTests
-  def self.task
-    count = 0
-    Find.find('./test') do |fn|
-      if fn=~/\.rb$/
-        system("ruby -I ./lib #{fn} --verbose=progress")
-      end
-    end
-  end
-end
-
-desc "Runs unit tests"
-task :'unit-tests' do
-  UnitTests.task
-end