parameters 0.1.9 → 0.2.0

metadata

@@ -1,68 +1,17 @@
 --- !ruby/object:Gem::Specification 
 name: parameters
 version: !ruby/object:Gem::Version 
-  version: 0.1.9
+  version: 0.2.0
 platform: ruby
 authors: 
 - Postmodern
 autorequire: 
 bindir: bin
-cert_chain: 
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDQDCCAiigAwIBAgIBADANBgkqhkiG9w0BAQUFADBGMRgwFgYDVQQDDA9wb3N0
-  bW9kZXJuLm1vZDMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
-  ARkWA2NvbTAeFw0wOTA2MDMwNDU5MDNaFw0xMDA2MDMwNDU5MDNaMEYxGDAWBgNV
-  BAMMD3Bvc3Rtb2Rlcm4ubW9kMzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYK
-  CZImiZPyLGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
-  1wvANkTDHFgVih5XLjuTwTZjgBq1lBGybXJiH6Id1lY2JOMqM5FB1DDHVvvij94i
-  mJabN0zkzu6VKWC70y0IwOxY7CPokr0eFdK/D0y7mCq1P8QITv76i2YqAl0eYqIt
-  W+IhIkANQ7E6uMZIZcdnfadC6lPAtlKkqtd9crvRbFgr6e3kyflmohbRnTEJHoRd
-  7SHHsybE6DSn7oTDs6XBTNrNIn5VfZA0z01eeos/+zBm1zKJOK2+/7xtLLDuDU9G
-  +Rd+ltUBbvxUrMNZmDG29pnmN2xTRH+Q8HxD2AxlvM5SRpK6OeZaHV7PaCCAVZ4L
-  T9BFl1sfMvRlABeGEkSyuQIDAQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIE
-  sDAdBgNVHQ4EFgQUKwsd+PqEYmBvyaTyoL+uRuk+PhEwDQYJKoZIhvcNAQEFBQAD
-  ggEBAB4TvHsrlbcXcKg6gX5BIb9tI+zGkpzo0Z7jnxMEcNO7NGGwmzafDBI/xZYv
-  xkRH3/HXbGGYDOi6Q6gWt5GujSx0bOImDtYTJTH8jnzN92HzEK5WdScm1QpZKF1e
-  cezArMbxbSPaosxTCtG6LQTkE28lFQsmFZ5xzouugS4h5+LVJiVMmiP+l3EfkjFa
-  GOURU+rNEMPWo8MCWivGW7jes6BMzWHcW7DQ0scNVmIcCIgdyMmpscuAEOSeghy9
-  /fFs57Ey2OXBL55nDOyvN/ZQ2Vab05UH4t+GCxjAPeirzL/29FBtePT6VD44c38j
-  pDj+ws7QjtH/Qcrr1l9jfN0ehDs=
-  -----END CERTIFICATE-----
+cert_chain: []
 
-date: 2010-01-30 00:00:00 -08:00
+date: 2010-02-18 00:00:00 -08:00
 default_executable: 
 dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rubyforge
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 2.0.3
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: gemcutter
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.3.0
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: hoe-yard
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.1.2
-    version: 
 - !ruby/object:Gem::Dependency 
   name: rspec
   type: :development
@@ -83,70 +32,53 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.5.3
     version: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 2.5.0
-    version: 
-description: |-
-  Parameters allows you to add annotated variables to your classes which may
-  have configurable default values.
-email: 
-- postmodern.mod3@gmail.com
+description: Parameters allows you to add annotated variables to your classes which may have configurable default values.
+email: postmodern.mod3@gmail.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- Manifest.txt
-- History.rdoc
+- ChangeLog.md
+- LICENSE.txt
+- README.md
 files: 
-- History.rdoc
-- Manifest.txt
-- README.rdoc
+- .gitignore
+- .specopts
+- .yardopts
+- ChangeLog.md
+- LICENSE.txt
+- README.md
 - Rakefile
 - lib/parameters.rb
+- lib/parameters/class_methods.rb
+- lib/parameters/class_param.rb
 - lib/parameters/exceptions.rb
 - lib/parameters/exceptions/missing_param.rb
 - lib/parameters/exceptions/param_not_found.rb
 - lib/parameters/extensions.rb
 - lib/parameters/extensions/meta.rb
 - lib/parameters/extensions/meta/object.rb
-- lib/parameters/parser.rb
-- lib/parameters/class_param.rb
 - lib/parameters/instance_param.rb
 - lib/parameters/param.rb
-- lib/parameters/class_methods.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/parameter_handler.rb
-- lib/parameters/yard/handlers/ruby/legacy.rb
-- lib/parameters/yard/handlers/ruby/legacy/parameter_handler.rb
-- spec/spec_helper.rb
-- spec/classes/test_parameters.rb
+- parameters.gemspec
+- spec/class_param_spec.rb
 - spec/classes/custom_parameters.rb
 - spec/classes/inherited_parameters.rb
 - spec/classes/other_parameters.rb
-- spec/parser_spec.rb
+- spec/classes/test_parameters.rb
+- spec/instance_param_spec.rb
 - spec/parameters_spec.rb
+- spec/spec_helper.rb
 has_rdoc: yard
-homepage: http://parameters.rubyforge.org/
+homepage: http://github.com/postmodern/parameters
 licenses: []
 
 post_install_message: 
 rdoc_options: 
-- --protected
-- --title
-- Parameters Documentation
-- --quiet
+- --charset=UTF-8
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -163,10 +95,17 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: []
 
-rubyforge_project: parameters
+rubyforge_project: 
 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.
-test_files: []
-
+summary: Allows you to add annotated variables to your classes
+test_files: 
+- spec/parameters_spec.rb
+- spec/spec_helper.rb
+- spec/class_param_spec.rb
+- spec/instance_param_spec.rb
+- spec/classes/inherited_parameters.rb
+- spec/classes/test_parameters.rb
+- spec/classes/custom_parameters.rb
+- spec/classes/other_parameters.rb

data/History.rdoc

@@ -1,73 +0,0 @@
-=== 0.1.9 / 2009-01-30
-
-* Require RSpec >= 1.3.0.
-* Require YARD >= 0.5.3.
-* Added {Parameters::ClassMethods}.
-
-=== 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
-  Parameters#initialize_params.
-* Adjust spacing in the output of ClassParam#to_s
-  and InstanceParam#to_s.
-* Specifically check if the instance variable is nil
-  before initializing it to the default value of the parameter.
-* Handle default value callbacks in Parameters#parameter.
-* Check the arity of all default value callbacks, before
-  passing self to them.
-* Parameters#require_params now specifically tests if
-  the instance variable of the parameter is nil.
-* Added more specs.
-
-=== 0.1.6 / 2009-05-11
-
-* Fixed a bug in Parameters.params= and Parameters#params=, where they
-  were not handling Parameters::ClassParam or Parameters::InstanceParam
-  objects properly.
-* Added more specs.
-
-=== 0.1.5 / 2009-05-06
-
-* Added Parameters::Parser for parsing parameter values passed in from
-  the command-line or the web.
-* Changed Parameters::MissingParam and Parameters::ParamNotFound to
-  inherit from StandardError.
-* All specs pass on Ruby 1.9.1-p0.
-
-=== 0.1.4 / 2009-01-17
-
-* All specs now pass with RSpec 1.1.12.
-* All specs pass on Ruby 1.9.1-rc1.
-
-=== 0.1.3 / 2009-01-14
-
-* Allow the use of lambdas to generate the default values of parameters.
-* Fixed typos in the README.txt.
-
-=== 0.1.2 / 2009-01-06
-
-* When printing parameter values, print the inspected version of the value.
-
-=== 0.1.1 / 2008-12-27
-
-* Added the require_params helper method.
-* Added print_params methods for displaying parameters of a class or an
-  object.
-
-=== 0.1.0 / 2008-12-03
-
-* Initial release.
-* Added Parameters.params= and Parameters#params= methods.
-* Allow Parameters#initialize to accept a Hash of parameter values.
-* Added more specs.
-

data/Manifest.txt

@@ -1,31 +0,0 @@
-History.rdoc
-Manifest.txt
-README.rdoc
-Rakefile
-lib/parameters.rb
-lib/parameters/exceptions.rb
-lib/parameters/exceptions/missing_param.rb
-lib/parameters/exceptions/param_not_found.rb
-lib/parameters/extensions.rb
-lib/parameters/extensions/meta.rb
-lib/parameters/extensions/meta/object.rb
-lib/parameters/parser.rb
-lib/parameters/class_param.rb
-lib/parameters/instance_param.rb
-lib/parameters/param.rb
-lib/parameters/class_methods.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/parameter_handler.rb
-lib/parameters/yard/handlers/ruby/legacy.rb
-lib/parameters/yard/handlers/ruby/legacy/parameter_handler.rb
-spec/spec_helper.rb
-spec/classes/test_parameters.rb
-spec/classes/custom_parameters.rb
-spec/classes/inherited_parameters.rb
-spec/classes/other_parameters.rb
-spec/parser_spec.rb
-spec/parameters_spec.rb

data/README.rdoc

@@ -1,91 +0,0 @@
-= Parameters
-
-* http://parameters.rubyforge.org/
-* http://github.com/postmodern/parameters/
-* Postmodern (postmodern.mod3 at gmail.com)
-
-== DESCRIPTION:
-
-Parameters allows you to add annotated variables to your classes which may
-have configurable default values.
-
-== FEATURES:
-
-* Give parameters default values.
-  * Default values maybe either objects or lambdas used to generate the
-    default value.
-* Change default values of parameters.
-* Give descriptions to parameters.
-* Set parameters en-mass.
-* Parse strings of the form <tt>name=value</tt> into a Hash of parameters.
-
-== EXAMPLES:
-
-  class Octagon
-  
-    include Parameters
-  
-    parameter :x, :default => 0
-  
-    parameter :y, :default => 0.5
-  
-    parameter :radius, :description => 'The radius of the Octagon'
-
-    parameter :opacity,
-              :default => lambda { rand },
-              :description => 'The opacity of the Octagon'
-  
-  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)
-
-== INSTALL:
-
-  $ sudo gem install parameters
-
-== LICENSE:
-
-The MIT License
-
-Copyright (c) 2008-2010 Hal Brodigan
-
-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/parameters/parser.rb

@@ -1,136 +0,0 @@
-require 'uri'
-
-module Parameters
-  module Parser
-    #
-    # @return [Array]
-    #   The parameter patterns and their parsers.
-    #
-    def Parser.formats
-      @@parameters_parser_formats ||= []
-    end
-
-    #
-    # 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|
-        block.call(format[:pattern],format[:parser])
-      end
-    end
-
-    #
-    # 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({
-        :pattern => pattern,
-        :parser => block
-      })
-    end
-
-    #
-    # 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|
-        if value.match(pattern)
-          return parser.call(value)
-        end
-      end
-
-      return value
-    end
-
-    #
-    # 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)
-
-      value = Parser.parse_value(value) if value
-      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("\\'","'")
-    }
-    Parser.recognize(/^[a-zA-Z][a-zA-Z0-9]*:\/\//) { |value| URI(value) }
-    Parser.recognize('false') { |value| false }
-    Parser.recognize('true') { |value| true }
-    Parser.recognize(/^[0-9]+$/) { |value| value.to_i }
-    Parser.recognize(/^0[0-7]+$/) { |value| value.oct }
-    Parser.recognize(/^0x[0-9a-fA-F]+$/) { |value| value.hex }
-
-  end
-end