parameters 0.1.7 → 0.1.8

data/History.txt

@@ -1,3 +1,13 @@
+=== 0.1.8 / 2009-09-21
+
+* Require Hoe >= 2.3.3.
+* Require YARD >= 0.2.3.5.
+* Require RSpec >= 1.2.8.
+* Use 'hoe/signing' for signed RubyGems.
+* Moved to YARD based documentation.
+* Added YARD handlers for documenting parameter method calls.
+* All specs pass on JRuby 1.3.1.
+
 === 0.1.7 / 2009-07-19
 
 * Renamed Parameters#initialize_parameters to

data/Manifest.txt

@@ -15,6 +15,16 @@ lib/parameters/instance_param.rb
 lib/parameters/param.rb
 lib/parameters/parameters.rb
 lib/parameters/version.rb
+lib/parameters/yard.rb
+lib/parameters/yard/handlers.rb
+lib/parameters/yard/handlers/ruby.rb
+lib/parameters/yard/handlers/ruby/eval_block_handler.rb
+lib/parameters/yard/handlers/ruby/metaclass_eval_handler.rb
+lib/parameters/yard/handlers/ruby/parameter_handler.rb
+lib/parameters/yard/handlers/ruby/legacy.rb
+lib/parameters/yard/handlers/ruby/legacy/eval_block_handler.rb
+lib/parameters/yard/handlers/ruby/legacy/metaclass_eval_handler.rb
+lib/parameters/yard/handlers/ruby/legacy/parameter_handler.rb
 tasks/spec.rb
 spec/spec_helper.rb
 spec/classes/test_parameters.rb

data/README.txt

@@ -17,6 +17,7 @@ have configurable default values.
 * Change default values of parameters.
 * Give descriptions to parameters.
 * Set parameters en-mass.
+* Parse strings of the form +name=value+ into a Hash of parameters.
 
 == EXAMPLES:
 
@@ -36,22 +37,34 @@ have configurable default values.
   
   end
   
+  # Create an object with default values for all parameters
   oct = Octagon.new
   oct.x # => 0
   oct.y # => 0.5
   oct.opacity # => 0.25
   
+  # Create an object with the given parameter values.
   oct = Octagon.new(:radius => 10)
   oct.radius # => 10
   oct.opacity # => 0.7
   
+  # Set parameter values of a class
   Octagon.radius = 33
   Octagon.opacity = 0.3
   
+  # Create an object with parameter defaulte values inherited from the
+  # class parameters
   oct = Octagon.new
   oct.radius # => 33
   oct.opacity # => 0.3
 
+  # Parse user given name=value parameter strings
+  oct.params = Parameters::Parser.parse(ARGV)
+
+== REQUIREMENTS:
+
+* {YARD}[http://yard.soen.ca/] >= 0.2.3.5
+
 == INSTALL:
 
   $ sudo gem install parameters

data/Rakefile

@@ -4,12 +4,21 @@ require 'rubygems'
 require 'hoe'
 require 'hoe/signing'
 require './tasks/spec.rb'
-require './lib/parameters/version.rb'
+require './tasks/yard.rb'
 
 Hoe.spec('parameters') do
   self.rubyforge_name = 'parameters'
   self.developer('Postmodern','postmodern.mod3@gmail.com')
   self.remote_rdoc_dir = '/'
+  self.extra_deps = [
+    ['yard', '>=0.2.3.5']
+  ]
+
+  self.extra_dev_deps = [
+    ['rspec', '>=1.2.8']
+  ]
+
+  self.spec_extras = {:has_rdoc => 'yard'}
 end
 
 # vim: syntax=Ruby

data/lib/parameters/class_param.rb

@@ -7,8 +7,16 @@ module Parameters
     attr_accessor :value
 
     #
-    # Creates a new ClassParam object with the specified _name_,
-    # given _description_ and _value_.
+    # Creates a new ClassParam object.
+    #
+    # @param [Symbol, String] name
+    #   The name of the class parameter.
+    #
+    # @param [String, nil] description
+    #   The description of the class parameter.
+    #
+    # @param [Object, nil] value
+    #   The default value of the class parameter.
     #
     def initialize(name,description=nil,value=nil)
       super(name,description)
@@ -17,19 +25,21 @@ module Parameters
     end
 
     #
-    # Returns the String representation of the class param.
+    # @return [String]
+    #   The representation of the class param.
     #
     def to_s
-      text = "  #{@name}"
+      text = @name.to_s
 
       text << " [#{@value.inspect}]" if @value
-      text << "\t\t#{@description}" if @description
+      text << "\t#{@description}" if @description
 
       return text
     end
 
     #
-    # Inspects the class params value.
+    # @return [String]
+    #   Inspection of the class params value.
     #
     def inspect
       @value.inspect

data/lib/parameters/instance_param.rb

@@ -5,8 +5,17 @@ module Parameters
     attr_reader :object
 
     #
-    # Creates a new InstanceParam object with the specified _object_ and
-    # _name_, and the given _description_.
+    # Creates a new InstanceParam object.
+    #
+    # @param [Object] object
+    #   The object containing the instance variable for the instance
+    #   parameter.
+    #
+    # @param [Symbol, String] name
+    #   The name of the instance parameter.
+    #
+    # @param [String, nil] description
+    #   The description of the instance parameter.
     #
     def initialize(object,name,description=nil)
       super(name,description)
@@ -15,7 +24,8 @@ module Parameters
     end
 
     #
-    # Returns the value of the instance param.
+    # @return
+    #   The value of the instance param.
     #
     def value
       @object.instance_variable_get("@#{@name}".to_sym)
@@ -24,24 +34,32 @@ module Parameters
     #
     # Sets the value of the instance param.
     #
+    # @param [Object] value
+    #   The new value of the instance param.
+    #
+    # @return [Object]
+    #   The new value of the instance param.
+    #
     def value=(value)
       @object.instance_variable_set("@#{@name}".to_sym,value)
     end
 
     #
-    # Returns a String representation of the instance param.
+    # @return [String]
+    #   Representation of the instance param.
     #
     def to_s
-      text = "  #{@name}"
+      text = @name.to_s
 
       text << " [#{value.inspect}]" if value
-      text << "\t\t#{@description}" if @description
+      text << "\t#{@description}" if @description
 
       return text
     end
 
     #
-    # Inspects the instance params value.
+    # @return [String]
+    #   Inspection of the instance params value.
     #
     def inspect
       value.inspect

data/lib/parameters/param.rb

@@ -8,8 +8,13 @@ module Parameters
     attr_reader :description
 
     #
-    # Creates a new Param object with the specified _name_ and the given
-    # _description_.
+    # Creates a new Param object.
+    #
+    # @param [Symbol, String] name
+    #   The name of the parameter.
+    #
+    # @param [String, nil] description
+    #   The description of the parameter.
     #
     def initialize(name,description=nil)
       @name = name.to_sym

data/lib/parameters/parameters.rb

@@ -5,19 +5,23 @@ require 'parameters/exceptions'
 require 'parameters/extensions/meta'
 
 module Parameters
-  def self.included(base) # :nodoc:
+  def self.included(base)
     base.metaclass_eval do
       #
-      # Returns the +Hash+ of parameters for the class.
+      # @return [Hash]
+      #   Parameters for the class.
       #
       def params
         @params ||= {}
       end
 
       #
-      # Sets the values of the class parameters described in the
-      # _values_ +Hash+.
+      # Sets the values of the class parameters.
       #
+      # @param [Hash] values
+      #   The names and new values to set the class params to.
+      #
+      # @example
       #   Test.params = {:x => 5, :y => 2}
       #   # => {:x=>5, :y=>2}
       #
@@ -34,15 +38,24 @@ module Parameters
       end
 
       #
-      # Adds a new parameters with the specified _name_ and the given
-      # _options_ to the Class.
+      # Adds a new parameters to the class.
+      #
+      # @param [Symbol, String] name
+      #   The name of the new parameter.
+      #
+      # @param [Hash] options
+      #   Additional options.
       #
-      # _options_ may contain the following keys:
-      # <tt>:description</tt>:: The description of the parameter.
-      # <tt>:default</tt>:: The default value the parameter will have.
+      # @option options [String] :description
+      #   The description for the new parameter.
       #
+      # @option options [Object, Proc] :default
+      #   The default value for the new parameter.
+      #
+      # @example
       #   parameter 'var'
       #
+      # @example
       #   parameter 'var', :default => 3, :description => 'my variable' 
       #
       def parameter(name,options={})
@@ -66,9 +79,16 @@ module Parameters
       end
 
       #
-      # Returns the class parameter with the specified _name_. If no
-      # such class parameter exists, a ParamNotFound exception will be
-      # raised.
+      # Searches for the class parameter with the matching name.
+      #
+      # @param [Symbol, String] name
+      #   The class parameter name to search for.
+      #
+      # @return [ClassParam]
+      #   The class parameter with the matching _name_.
+      #
+      # @raise [ParamNotFound]
+      #   No class parameter with the specified _name_ could be found.
       #
       def get_param(name)
         name = name.to_sym
@@ -85,8 +105,9 @@ module Parameters
       end
 
       #
-      # Returns +true+ if a class parameters with the specified _name_
-      # exists, returns +false+ otherwise.
+      # @return [Boolean]
+      #   Specifies whether or not there is a class parameter with the
+      #   specified _name_.
       #
       def has_param?(name)
         name = name.to_sym
@@ -101,8 +122,10 @@ module Parameters
       end
 
       #
-      # Iterates over all class parameters, passing each one to the
-      # specified _block_.
+      # Iterates over the parameters of the class and it's ancestors.
+      #
+      # @yield [param]
+      #   The block that will be passed each class parameter.
       #
       def each_param(&block)
         ancestors.each do |ancestor|
@@ -115,38 +138,39 @@ module Parameters
       end
 
       #
-      # Returns the description of the class parameters with the
-      # specified _name_. If no such class parameter exists, a
-      # ParamNotFound exception will be raised.
+      # Returns the description of the class parameters with a given name.
+      #
+      # @return [String]
+      #   Description of the class parameter with the specified name.
+      #
+      # @raise [ParamNotFound]
+      #   No class parameter with the specified name could be found.
       #
       def describe_param(name)
         get_param(name).description
       end
 
       #
-      # Returns the value of the class parameters with the specified
-      # _name_. If no such class parameter exists, a ParamNotFound
-      # exception will be raised.
+      # Returns the value of the class parameters with a given name.
       #
-      def param_value(name)
-        get_param(name).value
-      end
-
+      # @return [Object]
+      #   Value of the class parameter with the specified name.
       #
-      # Print the class parameters to the given _output_ stream.
+      # @raise [ParamNotFound]
+      #   No class parameter with the specified name could be found.
       #
-      def print_params(output=STDOUT)
-        each_param do |param|
-          output.puts param
-        end
+      def param_value(name)
+        get_param(name).value
       end
     end
   end
 
   #
   # Initalizes the parameters of the object using the given
-  # _values_, which can override the default values of
-  # parameters.
+  # values, which can override the default values of parameters.
+  #
+  # @param [Hash] values
+  #   The names and values to initialize the instance parameters to.
   #
   def initialize_params(values={})
     self.class.each_param do |param|
@@ -185,15 +209,27 @@ module Parameters
   end
 
   #
-  # Adds a new parameters with the specified _name_ and the given
-  # _options_ to the object.
+  # Adds a new parameter to the object.
+  #
+  # @param [Symbol, String] name
+  #   The name for the new instance parameter.
+  #
+  # @param [Hash] options
+  #   Additional options.
   #
-  # _options_ may contain the following keys:
-  # <tt>:description</tt>:: The description of the parameter.
-  # <tt>:default</tt>:: The default value the parameter will have.
+  # @option options [String] :description
+  #   The description for the new parameter.
   #
+  # @option options [Object, Proc] :default
+  #   The default value for the new parameter.
+  #
+  # @return [InstanceParam]
+  #   The newly created instance parameter.
+  #
+  # @example
   #   obj.parameter('var')
   #
+  # @example
   #   obj.parameter('var',:default => 3, :description => 'my variable')
   #
   def parameter(name,options={})
@@ -234,22 +270,28 @@ module Parameters
   end
 
   #
-  # Returns a +Hash+ of the classes params.
+  # @return [Hash]
+  #   The parameteres of the class and it's ancestors.
   #
   def class_params
     self.class.params
   end
 
   #
-  # Returns a +Hash+ of the instance parameters.
+  # @return [Hash]
+  #   The instance parameters of the object.
   #
   def params
     @params ||= {}
   end
 
   #
-  # Sets the values of the parameters described in the _values_ +Hash+.
+  # Sets the values of existing parameters in the object.
+  #
+  # @param [Hash] values
+  #   The names and values to set the instance parameters to.
   #
+  # @example
   #   obj.params = {:x => 5, :y => 2}
   #   # => {:x=>5, :y=>2}
   #
@@ -268,17 +310,21 @@ module Parameters
   end
 
   #
-  # Iterates over each instance parameter, passing each one to the given
-  # _block_.
+  # Iterates over each instance parameter in the object.
+  #
+  # @yield [param]
+  #   The block that will be passed each instance parameter.
   #
   def each_param(&block)
     self.params.each_value(&block)
   end
 
   #
-  # Returns +true+ if the a parameter with the specified _name_ exists,
-  # returns +false+ otherwise.
+  # @return [Boolean]
+  #   Specifies whether or not there is a instance parameter with the
+  #   specified name.
   #
+  # @example
   #   obj.has_param?('rhost') # => true
   #
   def has_param?(name)
@@ -286,9 +332,18 @@ module Parameters
   end
 
   #
-  # Returns the parameter with the specified _name_. If no such parameter
-  # exists, a ParamNotFound exception will be raised.
+  # Searches for the instance parameter with a specific name.
+  #
+  # @param [Symbol, String] name
+  #   The name of the instance parameter to search for.
   #
+  # @return [InstanceParam]
+  #   The instance parameter with the specified name.
+  #
+  # @raise [ParamNotFound]
+  #   Could not find the instance parameter with the specified name.
+  #
+  # @example
   #   obj.get_param('var') # => InstanceParam
   #
   def get_param(name)
@@ -302,9 +357,18 @@ module Parameters
   end
 
   #
-  # Returns the description of the parameter with the specified _name_.
-  # If no such parameter exists, a ParamNotFound exception will be raised.
+  # Returns the description of the parameter with a specific name.
+  #
+  # @param [Symbol, String] name
+  #   The name of the instance parameter to search for.
+  #
+  # @return [String]
+  #   The description of the instance parameter.
+  #
+  # @raise [ParamNotFound]
+  #   Could not find the instance parameter with the specified name.
   #
+  # @example
   #   obj.describe_param('rhost') # => "remote host"
   #
   def describe_param(name)
@@ -312,30 +376,35 @@ module Parameters
   end
 
   #
-  # Returns the value of the parameter with the specified _name_. If no
-  # such parameter exists, a ParamNotFound exception will be raised.
+  # Returns the value of the parameter with a specific name.
   #
+  # @param [Symbol, String] name
+  #   The name of the instance parameter to search for.
+  #
+  # @return [Object]
+  #   The value of the instance parameter with the specified name.
+  #
+  # @raise [ParamNotFound]
+  #   Could not find the instance parameter with the specified name.
+  #
+  # @example
   #   obj.param_value('rhost') # => 80
   #
   def param_value(name)
     get_param(name).value
   end
 
-  #
-  # Print the instance parameters to the given _output_ stream.
-  #
-  def print_params(output=STDOUT)
-    each_param do |param|
-      output.puts param
-    end
-  end
-
   protected
 
   #
-  # Requires that the parameters with the specified _names_ have
-  # non +nil+ values. If a parameter with a +nil+ value is found
-  # a MissingParam exception will be raised.
+  # Requires that the instance parameters with specific names have
+  # non +nil+ values.
+  #
+  # @return [true]
+  #   All the instance parameters have non +nil+ values.
+  #
+  # @raise [MissingParam]
+  #   One of the instance parameters was not set.
   #
   def require_params(*names)
     names.each do |name|

data/lib/parameters/parser.rb

@@ -3,15 +3,25 @@ require 'uri'
 module Parameters
   module Parser
     #
-    # The Array of parameter patterns and their parsers.
+    # @return [Array]
+    #   The parameter patterns and their parsers.
     #
     def Parser.formats
       @@parameters_parser_formats ||= []
     end
 
     #
-    # Itereates over each parameter pattern and parser, passing them to the
-    # specified _block_.
+    # Itereates over each parameter pattern and parser.
+    #
+    # @yield [pattern, parser]
+    #   The block will be passed each parameter pattern and the associated
+    #   parser.
+    #
+    # @yieldparam [Regexp, String] pattern
+    #   The pattern to match recognize parameter values with.
+    #
+    # @yieldparam [Proc] parser
+    #   The parser for the parameter value.
     #
     def Parser.each_format(&block)
       Parser.formats.each do |format|
@@ -20,8 +30,17 @@ module Parameters
     end
 
     #
-    # Adds a new parameter _pattern_ using the specified _block_ as the
-    # parser.
+    # Adds a new parameter parser.
+    #
+    # @param [Regexp, String] pattern
+    #   The pattern to recognize parameter values with.
+    #
+    # @yield [value]
+    #   The block will be used as the parser for the recognized parameter
+    #   values.
+    #
+    # @yieldparam [String] value
+    #   The parameter value to parser.
     #
     def Parser.recognize(pattern,&block)
       Parser.formats.unshift({
@@ -31,9 +50,21 @@ module Parameters
     end
 
     #
-    # Parses the specified _value_ string and returns the native Ruby value.
-    # If the _value_ matches one of the patterns within +FORMATS+,
-    # then the associated parser will be used to parse the _value_.
+    # Recognizes and parses the given parameter value.
+    #
+    # @param [String] value
+    #   The parameter value to parse.
+    #
+    # @return [Object]
+    #   The parsed parameter value.
+    #
+    # @example
+    #   Parser.parse_value("0x1")
+    #   # => 1
+    #
+    # @example
+    #   Parser.parse_value("'mesg'")
+    #   # => "mesg"
     #
     def Parser.parse_value(value)
       Parser.each_format do |pattern,parser|
@@ -46,11 +77,19 @@ module Parameters
     end
 
     #
-    # Parses the specified _name_and_value_ string of the form
-    # "name=value" and extracts both the _name_ and the _value_, saving
-    # both the _name_ and _value_ within the +params+ Hash. If the
-    # extracted _value_ matches one of the patterns within +FORMATS+,
-    # then the associated parser will first parse the _value_.
+    # Parses the a parameter string of the form +name=value+.
+    #
+    # @param [String] name_and_value
+    #   The name and value parameter join with a +=+ character.
+    #
+    # @return [Hash{Symbol => Object}]
+    #   A singleton Hash containing the parameter name and it's value.
+    #
+    # @example
+    #   Parser.parse_param('var=2')
+    #   # => {:var=>2}
+    #
+    # @since 0.1.8
     #
     def Parser.parse_param(name_and_value)
       name, value = name_and_value.split('=',2)
@@ -59,6 +98,30 @@ module Parameters
       return {name.to_sym => value}
     end
 
+    #
+    # Parses one or more parameter strings of the form +name=value+.
+    #
+    # @param [Array<String>] names_and_values
+    #   The names and values of the parameters, joined by the +=+
+    #   character.
+    #
+    # @return [Hash{Symbol => Object}]
+    #   The names and values of the parameters.
+    #
+    # @example
+    #   Parser.parse(["x=2", "y=true"])
+    #   # => {:x=>2, :y=>true}
+    #
+    def Parser.parse(names_and_values)
+      params = {}
+
+      names_and_values.each do |name_and_value|
+        params.merge!(Parser.parse_param(name_and_value))
+      end
+
+      return params
+    end
+
     Parser.recognize(/^'(\\'|[^'])+'/) { |value|
       value[1...-1].gsub("\\'","'")
     }

data/lib/parameters/version.rb

@@ -1,3 +1,3 @@
 module Parameters
-  VERSION = '0.1.7'
+  VERSION = '0.1.8'
 end

data/lib/parameters/yard/handlers/ruby/eval_block_handler.rb

@@ -0,0 +1,18 @@
+require 'yard'
+
+module YARD
+  module Handlers
+    module Ruby
+      class EvalBlockHandler < YARD::Handlers::Ruby::Base
+
+        handles method_call(:module_eval), method_call(:class_eval), method_call(:instance_eval)
+
+        def process
+          if (block = statement.jump(:brace_block, :do_block).last)
+            parse_block(block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/parameters/yard/handlers/ruby/legacy/eval_block_handler.rb

@@ -0,0 +1,19 @@
+require 'yard/handlers/ruby/legacy/base'
+
+module YARD
+  module Handlers
+    module Ruby
+      module Legacy
+        class EvalBlockHandler < Base
+
+          handles /(\A|\.)(module|class|instance)_eval(\s+|\()/
+
+          def process
+            parse_block if statement.block
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/parameters/yard/handlers/ruby/legacy/metaclass_eval_handler.rb

@@ -0,0 +1,21 @@
+require 'yard/handlers/ruby/legacy/base'
+
+module YARD
+  module Handlers
+    module Ruby
+      module Legacy
+        class MetaclassEvalHandler < Base
+
+          handles /(\A|\.)metaclass_eval(\s+|\()/
+
+          def process
+            if statement.block
+              parse_block(:namespace => namespace, :scope => :class)
+            end
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/parameters/yard/handlers/ruby/legacy/parameter_handler.rb

@@ -0,0 +1,34 @@
+require 'yard'
+
+module YARD
+  module Handlers
+    module Ruby
+      module Legacy
+        class ParameterHandler < Base
+
+          handles /\Aparameter\s/
+
+            def process
+              nobj = namespace
+              mscope = scope
+              name = statement.tokens[2,1].to_s[1..-1]
+
+              register MethodObject.new(nobj, name, mscope) do |o|
+                o.visibility = :public
+                o.source = statement.source
+                o.signature = "def #{name}"
+              end
+
+              register MethodObject.new(nobj, "#{name}=", mscope) do |o|
+                o.visibility = :public
+                o.source = statement.source
+                o.signature = "def #{name}=(value)"
+                o.parameters = [['value', nil]]
+              end
+            end
+
+        end
+      end
+    end
+  end
+end

data/lib/parameters/yard/handlers/ruby/legacy.rb

@@ -0,0 +1,3 @@
+require 'parameters/yard/handlers/ruby/legacy/eval_block_handler'
+require 'parameters/yard/handlers/ruby/legacy/metaclass_eval_handler'
+require 'parameters/yard/handlers/ruby/legacy/parameter_handler'

data/lib/parameters/yard/handlers/ruby/metaclass_eval_handler.rb

@@ -0,0 +1,18 @@
+require 'yard'
+
+module YARD
+  module Handlers
+    module Ruby
+      class MetaclassEvalHandler < YARD::Handlers::Ruby::Base
+
+        handles method_call(:metaclass_eval)
+
+        def process
+          if (block = statement.jump(:brace_block, :do_block).last)
+            parse_block(block, :namespace => namespace, :scope => :class)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/parameters/yard/handlers/ruby/parameter_handler.rb

@@ -0,0 +1,38 @@
+require 'yard'
+
+module YARD
+  module Handlers
+    module Ruby
+      class ParameterHandler < Base
+
+        handles method_call(:parameter)
+
+        def process
+          obj = statement.parameters(false).first
+          nobj = namespace
+          mscope = scope
+          name = case obj.type
+                 when :symbol_literal
+                   obj.jump(:ident, :op, :kw, :const).source
+                 when :string_literal
+                   obj.jump(:string_content).source
+                 end
+
+          register MethodObject.new(nobj, name, mscope) do |o|
+            o.visibility = :public
+            o.source = statement.source
+            o.signature = "def #{name}"
+          end
+
+          register MethodObject.new(nobj, "#{name}=", mscope) do |o|
+            o.visibility = :public
+            o.source = statement.source
+            o.signature = "def #{name}=(value)"
+            o.parameters = [['value', nil]]
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/parameters/yard/handlers/ruby.rb

@@ -0,0 +1,4 @@
+require 'parameters/yard/handlers/ruby/eval_block_handler'
+require 'parameters/yard/handlers/ruby/metaclass_eval_handler'
+require 'parameters/yard/handlers/ruby/parameter_handler'
+require 'parameters/yard/handlers/ruby/legacy'

data/lib/parameters/yard/handlers.rb

@@ -0,0 +1 @@
+require 'parameters/yard/handlers/ruby'

data/lib/parameters/yard.rb

@@ -0,0 +1 @@
+require 'parameters/yard/handlers'

data/spec/parser_spec.rb

@@ -37,4 +37,11 @@ describe Parameters::Parser do
   it "should parse params of the form 'name=value'" do
     Parameters::Parser.parse_param('var1=test').should == {:var1 => 'test'}
   end
+
+  it "should parse multiple params" do
+    Parameters::Parser.parse(['var', 'var1=test']).should == {
+      :var => nil,
+      :var1 => 'test'
+    }
+  end
 end

data/tasks/spec.rb

@@ -6,4 +6,5 @@ Spec::Rake::SpecTask.new(:spec) do |t|
   t.spec_opts = ['--colour', '--format', 'specdoc']
 end
 
+task :test => :spec
 task :default => :spec

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: parameters
 version: !ruby/object:Gem::Version 
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors: 
 - Postmodern
@@ -30,9 +30,29 @@ cert_chain:
   pDj+ws7QjtH/Qcrr1l9jfN0ehDs=
   -----END CERTIFICATE-----
 
-date: 2009-07-19 00:00:00 -07:00
+date: 2009-09-25 00:00:00 -07:00
 default_executable: 
 dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.3.5
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.8
+    version: 
 - !ruby/object:Gem::Dependency 
   name: hoe
   type: :development
@@ -41,7 +61,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 2.3.2
+        version: 2.3.3
     version: 
 description: |-
   Parameters allows you to add annotated variables to your classes which may
@@ -74,6 +94,16 @@ files:
 - lib/parameters/param.rb
 - lib/parameters/parameters.rb
 - lib/parameters/version.rb
+- lib/parameters/yard.rb
+- lib/parameters/yard/handlers.rb
+- lib/parameters/yard/handlers/ruby.rb
+- lib/parameters/yard/handlers/ruby/eval_block_handler.rb
+- lib/parameters/yard/handlers/ruby/metaclass_eval_handler.rb
+- lib/parameters/yard/handlers/ruby/parameter_handler.rb
+- lib/parameters/yard/handlers/ruby/legacy.rb
+- lib/parameters/yard/handlers/ruby/legacy/eval_block_handler.rb
+- lib/parameters/yard/handlers/ruby/legacy/metaclass_eval_handler.rb
+- lib/parameters/yard/handlers/ruby/legacy/parameter_handler.rb
 - tasks/spec.rb
 - spec/spec_helper.rb
 - spec/classes/test_parameters.rb
@@ -82,7 +112,7 @@ files:
 - spec/classes/other_parameters.rb
 - spec/parser_spec.rb
 - spec/parameters_spec.rb
-has_rdoc: true
+has_rdoc: yard
 homepage: http://parameters.rubyforge.org/
 licenses: []
 
@@ -107,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: parameters
-rubygems_version: 1.3.4
+rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
 summary: Parameters allows you to add annotated variables to your classes which may have configurable default values.