ns-options 0.3.1 → 0.4.0

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2011-Present Collin Redding, Kelly Redding and Team Insight
+
+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/{README.markdown → README.md}

@@ -89,6 +89,28 @@ App.settings.server # => NoMethodError
 App.settings.data.server # => 127.0.0.1:1234
 ```
 
+### Less Verbose Definitions
+
+As an alternative to the above definition syntax, you can use an alternate less-verbose syntax:
+* `opts` for `options`
+* `opt` for `option`
+* `ns`  for `namespace`
+
+```ruby
+module App
+  include NsOptions
+
+  opts :settings do
+    opt :root, Pathname
+    opt :stage
+
+    ns :other_stuff do
+      opt :something
+    end
+  end
+end
+```
+
 #### With Classes
 
 Using `NsOptions` on a `Class` uses namespaces to create separate sets of options for every instance of your class created. This allows every instance to have different values for the set of options and not interfere with each other. For example with the following:
@@ -287,7 +309,44 @@ class Root < Pathname
 end
 ```
 
-With the revised `initialize` method, `NsOptions` will have no problems coercing values for your the type class. In some cases the above solution may not work for you, but don't worry. See the _Option Rules_ section for another way to solve this, specifically about the args rule. For an example of a custom type class, the included `NsOptions::Boolean` can be looked at. This is a special case, but it works as a type class with `NsOptions`.
+With the revised `initialize` method, `NsOptions` will have no problems coercing values for the type class. In some cases the above solution may not work for you, but don't worry. See the _Option Rules_ section for another way to solve this, specifically about the args rule. For an example of a custom type class, the included `NsOptions::Boolean` can be looked at. This is a special case, but it works as a type class with `NsOptions`.
+
+### Custom type class return values
+
+It may be useful to use a custom type class as a silent value handler.  You don't necessarily care that this option is some handler class - you just want flexible ways to set its value and get a meaningful return value when you read it.
+
+When reading option values, NsOptions will first check and see if the option value responds to the `returned_value` method.  If it does, NsOptions will return that value instead of the instance of the type class.  If not it will return the type class instance as normal.
+
+The included `NsOptions::Boolean` handler class does just this to ensure it always returns either `true` or `false`.  Here is another example:
+
+```ruby
+class HostedAt
+  # sanitized :hosted_at config
+  #  remove any trailing '/'
+  #  ensure single leading '/'
+
+  def initialize(value)
+    @hosted_at = value.sub(/\/+$/, '').sub(/^\/*/, '/')
+  end
+
+  def returned_value
+    @hosted_at
+  end
+end
+
+class Thing
+  include NsOptions
+
+  options :is do
+    option :hosted_at, HostedAt
+  end
+end
+
+thing = Thing.new
+thing.is.hosted_at  # => nil
+thing.is.hosted_at = "path/to/resource/"
+thing.is.hosted_at  # => "/path/to/resource"
+```
 
 ### Ruby Classes As A Type Class
 
@@ -314,7 +373,7 @@ Example.stuff.float = "5.0"
 Example.stuff.float # => 5.0, same as Float("5.0")
 ```
 
-`Symbol`, `Hash` and `Array` work, but ruby doesn't provide a built in type casting for these.
+`Symbol`, `Hash` and `Array` work, but ruby doesn't provide built in type casting for these.
 
 ```ruby
 Example.stuff.symbol = "awesome"
@@ -358,6 +417,8 @@ App.settings.required_set? # => true
 
 To check if an option is set it will simply check if the value is not `nil`. If you are using a custom type class though, you can define an `is_set?` method and this will be used to check if an option is set.
 
+The built in `required_set?` method checks to see if all the options for the namespace that have been marked `:required => true` are set.  It does not recursively check any child namespaces.
+
 #### Args
 
 Another rule that you can specify is args. This allows you to pass more arguments to a type class.
@@ -387,7 +448,6 @@ Mix in NsOptions::Proxy to any module/class to make it proxy a namespace.  This
 
 ```ruby
 module Something
-  include NsOptions
   include NsOptions::Proxy
 
   # define options directly
@@ -431,27 +491,40 @@ module Something
 end
 ```
 
-## License
+### Proxy initialization
 
-Copyright (c) 2011 Collin Redding and Team Insight
+Mixing in Proxy with mixin a default initializer for you as well.  This initializer allows you to call `new` on your proxy, passing it a hash of key-values.  These key values will be applied to the proxy using the `Namespace#apply` logic.  This allows you to use Proxy objects as option types and maintain the option type-casting and defaulting behavior.
 
-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:
+A Module example
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+```ruby
+module Things
+  include NsOptions::Proxy
 
-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.
+  option :one
+  option :two
+end
+
+# proxy defines a `new` method that takes a hash arg and
+# applies it to the proxy
+t = Thing.new(:one => 1, :two => 2, :three => 3)
+
+# the values have been applied
+t.to_hash  # => {:one => 1, :two => 2, :three => 3}
+```
+
+# A Class example
+
+```
+class Thing
+  include NsOptions::Proxy
+
+  option :one
+  option :two
+end
+
+# proxy defines an `initialize` method that takes a hash arg and
+# applies it to the proxy
+t = Thing.new(:one => 1, :two => 2, :three => 3)
+t.to_hash  # => {:one => 1, :two => 2, :three => 3}
+```

data/lib/ns-options/boolean.rb

@@ -11,6 +11,18 @@ module NsOptions
       @actual = self.convert(new_value)
     end
 
+    def ==(other_boolean)
+      if other_boolean.kind_of?(Boolean)
+        self.actual == other_boolean.actual
+      else
+        self.actual == other_boolean
+      end
+    end
+
+    def returned_value
+      self.actual
+    end
+
     protected
 
     def convert(value)

data/lib/ns-options/has_options.rb

@@ -13,11 +13,13 @@ module NsOptions
 
     module DSL
 
-      # This is the main DSL method for creating a namespace of options for your class/module. This
-      # will define a class method for both classes and modules and an additional instance method
-      # for classes. The namespace is then created and returned by calling the class method version.
-      # For classes, the instance method will build an entirely new namespace from the class level
-      # namespace. This is so when you define options at the class level:
+      # This is the main DSL method for creating a namespace of options for your
+      # class/module. This will define a class method for both classes and
+      # modules and an additional instance method for classes. The namespace is
+      # then created and returned by calling the class method version.  For
+      # classes, the instance method will build an entirely new namespace from
+      # the class level namespace. This is so when you define options at the
+      # class level:
       #
       # class Something
       #   include NsOptions
@@ -26,35 +28,23 @@ module NsOptions
       #   end
       # end
       #
-      # the namespaces at the instance level still get all the defined options, but are completely
-      # separate objects from the class and other instances. Modules only deal with a single
-      # namespace at the module level.
+      # the namespaces at the instance level still get all the defined options,
+      # but are completely separate objects from the class and other instances.
+      # Modules only deal with a single namespace at the module level.
+
+      # The options method takes three args:
+      # * `name` : what to name the defined methods for accessing the namespace
+      # * `key`  : (optional) what to key the created namespace objects with
+      #            - defaults to `name`
+      #            - useful if persisting namespaces into some key-value store
+      # * `block`: (optional) a predefined set of nested options and namespaces
+
       def options(name, key = nil, &block)
         NsOptions::Helper.advisor.is_this_namespace_ok?(name, caller)
-        key ||= name.to_s
-        method_definitions = <<-CLASS_METHOD
-
-          def self.#{name}(&block)
-            @#{name} ||= NsOptions::Namespace.new('#{key}', &block)
-          end
-
-        CLASS_METHOD
-        if self.kind_of?(Class)
-          method_definitions += <<-INSTANCE_METHOD
-
-            def #{name}(&block)
-              unless @#{name}
-                @#{name} = NsOptions::Namespace.new('#{key}', &block)
-                @#{name}.options.build_from(self.class.#{name}.options, @#{name})
-              end
-              @#{name}
-            end
-
-          INSTANCE_METHOD
-        end
-        self.class_eval(method_definitions)
+        NsOptions::Helper.define_root_namespace_methods(self, name, key)
         self.send(name, &block)
       end
+      alias_method :opts, :options
 
     end
 

data/lib/ns-options/helper.rb

@@ -53,6 +53,35 @@ module NsOptions
       NsOptions::Helper::Advisor.new(namespace)
     end
 
+    def define_root_namespace_methods(define_on, name, key=nil)
+      key ||= name.to_s
+
+      # covers defining on Modules and at the class-level of Classes
+      method_definitions = <<-CLASS_METHOD
+
+        def self.#{name}(&block)
+          @#{name} ||= NsOptions::Namespace.new('#{key}', &block)
+        end
+
+      CLASS_METHOD
+
+      if define_on.kind_of?(Class)
+        # covers defining at the instance-level of Classes
+        method_definitions += <<-INSTANCE_METHOD
+
+          def #{name}(&block)
+            unless @#{name}
+              @#{name} = NsOptions::Namespace.new('#{key}', &block)
+              @#{name}.options.build_from(self.class.#{name}.options, @#{name})
+            end
+            @#{name}
+          end
+
+        INSTANCE_METHOD
+      end
+      define_on.class_eval(method_definitions)
+    end
+
   end
 
 end

data/lib/ns-options/namespace.rb

@@ -37,6 +37,7 @@ module NsOptions
       NsOptions::Helper.define_option_methods(self, option)
       option
     end
+    alias_method :opt, :option
 
     # Define a namespace under this namespace. Firstly, a new key is constructured from this current
     # namespace's key and the name for the new namespace. The namespace is then added to the
@@ -60,6 +61,7 @@ module NsOptions
       NsOptions::Helper.define_namespace_methods(self, name)
       namespace
     end
+    alias_method :ns, :namespace
 
     # The opposite of #to_hash. Takes a hash representation of options and namespaces and mass
     # assigns option values.

data/lib/ns-options/option.rb

@@ -26,7 +26,13 @@ module NsOptions
     # if reading a lazy_proc, call the proc and return its coerced return val
     # otherwise, just return the stored value
     def value
-      self.lazy_proc?(@value) ? self.coerce(@value.call) : @value
+      if self.lazy_proc?(@value)
+        self.coerce(@value.call)
+      elsif @value.respond_to?(:returned_value)
+        @value.returned_value
+      else
+        @value
+      end
     end
 
     # if setting a lazy_proc, just store the proc off to be called when read

data/lib/ns-options/proxy.rb

@@ -1,20 +1,38 @@
+require 'ns-options'
+
 module NsOptions::Proxy
 
   # Mix this in to any module or class to make it proxy a namespace
   # this means you can interact with the module/class/class-instance as
-  # if it were a namespace object itself.  For example:
+  # if it were a namespace object itself.
 
   NAMESPACE = "__proxy_options__"
 
   class << self
 
     def included(receiver)
-      receiver.class_eval do
-        include NsOptions
-        options(NAMESPACE)
+      NsOptions::Helper.define_root_namespace_methods(receiver, NAMESPACE)
+      receiver.class_eval { extend ProxyMethods }
+      receiver.class_eval { include ProxyMethods } if receiver.kind_of?(Class)
+
+      # default initializer method
+
+      if receiver.kind_of?(Class)
+        receiver.class_eval do
+
+          def initialize(configs={})
+            self.apply(configs || {})
+          end
+
+        end
+      else # Module
+        receiver.class_eval do
+
+          def self.new(configs={})
+            self.apply(configs || {})
+          end
 
-        extend ProxyMethods
-        include ProxyMethods
+        end
       end
     end
 
@@ -22,7 +40,44 @@ module NsOptions::Proxy
 
   module ProxyMethods
 
-    # just proxy to the NAMESPACE created when Proxy was mixed in
+    # pass thru namespace methods to the proxied NAMESPACE handler
+
+    def option(*args, &block)
+      __proxy_options__.option(*args, &block)
+    end
+    alias_method :opt, :option
+
+    def namespace(*args, &block)
+      __proxy_options__.namespace(*args, &block)
+    end
+    alias_method :ns, :namespace
+
+    def apply(*args, &block)
+      __proxy_options__.apply(*args, &block)
+    end
+
+    def to_hash(*args, &block)
+      __proxy_options__.to_hash(*args, &block)
+    end
+
+    def each(*args, &block)
+      __proxy_options__.each(*args, &block)
+    end
+
+    def define(*args, &block)
+      __proxy_options__.define(*args, &block)
+    end
+
+    def required_set?(*args, &block)
+      __proxy_options__.required_set?(*args, &block)
+    end
+
+    def valid?(*args, &block)
+      __proxy_options__.valid?(*args, &block)
+    end
+
+    # for everything else, send to the proxied NAMESPACE handler
+    # at this point it really just enables setting dynamic options
 
     def method_missing(meth, *args, &block)
       if (po = self.__proxy_options__) && po.respond_to?(meth.to_s)

data/lib/ns-options/version.rb

@@ -1,3 +1,3 @@
 module NsOptions
-  VERSION = "0.3.1"
+  VERSION = "0.4.0"
 end

data/test/integration/app_test.rb

@@ -61,8 +61,7 @@ module App
     subject{ @module.settings.sub }
 
     should "have set the run_commands option" do
-      assert_kind_of NsOptions::Boolean, subject.run_commands
-      assert_equal @run, subject.run_commands.actual
+      assert_equal @run, subject.run_commands
     end
   end
 

data/test/integration/proxy_test.rb

@@ -0,0 +1,41 @@
+require 'assert'
+
+require 'ns-options/assert_macros'
+require 'test/support/proxy'
+
+class SomeProxyIntTests < Assert::Context
+  include NsOptions::AssertMacros
+
+  desc "the integration test proxy module"
+  setup do
+    @proxy = SomeProxy
+  end
+  subject { @proxy }
+
+  should have_option :some, SomeProxy::SomeThing, {
+    :default => {:value1 => 1}
+  }
+
+  should have_option :some_prime, SomeProxy::SomeThing, {
+    :default => {:value1 => 'one'}
+  }
+
+  should have_option :stuff, :default => []
+
+end
+
+class SomeProxySomeThingTests < SomeProxyIntTests
+  desc ":some option"
+  setup do
+    @proxy_some = @proxy.some
+  end
+  subject { @proxy_some }
+
+  should have_namespace :more
+  should have_options :value1, :value2
+
+  should "have its :value1 defaulted" do
+    assert_equal 1, subject.value1
+  end
+
+end

data/test/integration/user_test.rb

@@ -79,8 +79,7 @@ class User
     end
 
     should "have set show_messages" do
-      assert_kind_of NsOptions::Boolean, subject.show_messages
-      assert_equal false, subject.show_messages.actual
+      assert_equal false, subject.show_messages
     end
 
     should "have set the font_size" do

data/test/support/proxy.rb

@@ -0,0 +1,21 @@
+module SomeProxy
+  include NsOptions::Proxy
+
+  class SomeThing
+    include NsOptions::Proxy
+
+    opt :value1
+    opt :value2
+
+    ns :more do
+      opt :other1
+      opt :other2
+    end
+
+  end
+
+  opt :some, SomeThing, :default => { :value1 => 1 }
+  opt :some_prime, SomeThing, :default => { :value1 => 'one' }
+  opt :stuff, :default => []
+
+end

data/test/unit/ns-options/boolean_test.rb

@@ -9,7 +9,17 @@ class NsOptions::Boolean
     end
     subject{ @boolean }
 
-    should have_accessors :actual
+    should have_accessor :actual
+    should have_reader   :returned_value
+
+    should "return its handled value with the `actual` method" do
+      assert_equal true, subject.actual
+    end
+
+    should "return its handled value with the `returned_value` method" do
+      assert_equal true, subject.returned_value
+    end
+
   end
 
   class WithTruthyValuesTest < BaseTest
@@ -80,4 +90,22 @@ class NsOptions::Boolean
     end
   end
 
+  class ComparatorTests < BaseTest
+    desc "when comparing for equality"
+    setup do
+      @true_bool   = NsOptions::Boolean.new true
+      @false_bool  = NsOptions::Boolean.new false
+    end
+
+    should "compare with other booleans" do
+      assert_equal NsOptions::Boolean.new(1), @true_bool
+      assert_equal NsOptions::Boolean.new(0), @false_bool
+    end
+
+    should "compare with true and false" do
+      assert_equal true, @true_bool
+      assert_equal false, @false_bool
+    end
+  end
+
 end

data/test/unit/ns-options/has_options_test.rb

@@ -16,7 +16,7 @@ module NsOptions::HasOptions
     end
     subject{ @instance }
 
-    should have_class_methods :options
+    should have_class_methods :options, :opts
 
   end
 

data/test/unit/ns-options/helper_test.rb

@@ -9,15 +9,19 @@ module NsOptions::Helper
     end
     subject{ @module }
 
-    should have_instance_methods :find_and_define_namespace, :find_and_define_option,
-      :define_namespace_methods, :define_option_methods, :advisor
-      
+    should have_instance_method :find_and_define_namespace
+    should have_instance_method :find_and_define_option
+    should have_instance_method :define_namespace_methods
+    should have_instance_method :define_option_methods
+    should have_instance_method :advisor
+    should have_instance_method :define_root_namespace_methods
+
     should "return an instance of NsOptions::Helper::Advisor with a call to #advisor" do
       advisor = subject.advisor(NsOptions::Namespace.new("something"))
       assert_instance_of NsOptions::Helper::Advisor, advisor
     end
   end
-  
+
   class FindAndDefineOptionTest < BaseTest
     desc "find_and_define_option method"
     setup do
@@ -26,14 +30,14 @@ module NsOptions::Helper
       @result = @module.find_and_define_option(@namespace, @option.name)
     end
     subject{ @namespace }
-    
+
     should "have defined reader/writer methods for the option and returned the option" do
       assert_respond_to @option.name, subject
       assert_respond_to "#{@option.name}=", subject
       assert_equal @option, @result
     end
-  end 
-  
+  end
+
   class FindAndDefineNamespaceTest < BaseTest
     desc "find_and_define_namespace method"
     setup do
@@ -42,7 +46,7 @@ module NsOptions::Helper
       @result = @module.find_and_define_namespace(@namespace, :else)
     end
     subject{ @namespace }
-    
+
     should "have defined reader method for the namespace and returned the namespace" do
       assert_respond_to :else, subject
       assert_equal subject.options.get_namespace(:else), @result

data/test/unit/ns-options/namespace_test.rb

@@ -11,7 +11,10 @@ class NsOptions::Namespace
     subject{ @namespace }
 
     should have_accessors :metaclass, :options
-    should have_instance_methods :option, :namespace, :required_set?, :define, :apply, :valid?
+    should have_instance_methods :option, :opt
+    should have_instance_methods :namespace, :ns
+    should have_instance_methods :required_set?, :valid?
+    should have_instance_methods :define, :apply
     should have_instance_methods :to_hash, :each
 
     should "have set it's metaclass accessor" do

data/test/unit/ns-options/option_test.rb

@@ -17,18 +17,23 @@ class NsOptions::Option
     should "have set the name" do
       assert_equal "stage", subject.name
     end
+
     should "have set the type class" do
       assert_equal String, subject.type_class
     end
+
     should "have set the rules" do
       assert_equal(@rules, subject.rules)
     end
+
     should "have defaulted value based on the rules" do
       assert_equal subject.rules[:default], subject.value
     end
+
     should "return true with a call to #required?" do
       assert_equal true, subject.required?
     end
+
     should "allow setting the value to nil" do
       subject.value = nil
       assert_nil subject.value
@@ -151,11 +156,13 @@ class NsOptions::Option
       subject.value = new_value
       assert_equal new_value, subject.value
     end
+
     should "allow setting it's value with a string and convert it" do
       new_value = "13.4"
       subject.value = new_value
       assert_equal new_value.to_f, subject.value
     end
+
     should "allow setting it's value with an integer and convert it" do
       new_value = 1
       subject.value = new_value
@@ -183,6 +190,7 @@ class NsOptions::Option
       subject.value = value
       assert_equal object_class.new.to_sym, subject.value
     end
+
     should "error on anything that doesn't define #to_sym" do
       assert_raises(NoMethodError) do
         subject.value = true
@@ -334,6 +342,68 @@ class NsOptions::Option
     end
   end
 
+  class WithReturnValueTests < BaseTest
+    setup do
+      # test control values
+      @string    = NsOptions::Option.new(:string, String)
+      @symbol    = NsOptions::Option.new(:symbol, Symbol)
+      @integer   = NsOptions::Option.new(:integer, Integer)
+      @float     = NsOptions::Option.new(:float, Float)
+      @hash      = NsOptions::Option.new(:hash, Hash)
+      @array     = NsOptions::Option.new(:array, Array)
+      @proc      = NsOptions::Option.new(:proc, Proc)
+      @lazy_proc = NsOptions::Option.new(:lazy_proc)
+
+      # custom return value
+      class HostedAt
+        # sanitized :hosted_at config
+        #  remove any trailing '/'
+        #  ensure single leading '/'
+
+        def initialize(value)
+          @hosted_at = value.sub(/\/+$/, '').sub(/^\/*/, '/')
+        end
+
+        def returned_value
+          @hosted_at
+        end
+      end
+
+      @hosted_at = NsOptions::Option.new(:hosted_at, HostedAt)
+    end
+
+    should "return values normally when no `returned_value` is specified" do
+      @string.value = "test"
+      assert_equal "test", @string.value
+
+      @symbol.value = :test
+      assert_equal :test, @symbol.value
+
+      @integer.value = 1
+      assert_equal 1, @integer.value
+
+      @float.value = 1.1
+      assert_equal 1.1, @float.value
+
+      @hash.value = {:test => 'test'}
+      assert_equal({:test => 'test'}, @hash.value)
+
+      @array.value = ['test']
+      assert_equal ['test'], @array.value
+
+      @proc.value = Proc.new { 'test' }
+      assert_kind_of Proc, @proc.value
+
+      @lazy_proc.value = Proc.new { 'lazy test' }
+      assert_equal 'lazy test', @lazy_proc.value
+    end
+
+    should "should honor `returned_value` when returning option values" do
+      @hosted_at.value = "path/to/resource/"
+      assert_equal '/path/to/resource', @hosted_at.value
+    end
+  end
+
   class WithArgsTest < BaseTest
     desc "with args rule"
     setup do

data/test/unit/ns-options/proxy_test.rb

@@ -8,15 +8,22 @@ module NsOptions::Proxy
     def self.proxy_a_namespace
       Assert::Macro.new do
         should "create a default namespace to proxy to" do
-          assert_respond_to NAMESPACE, subject
-          assert_kind_of NsOptions::Namespace, subject.send(NAMESPACE)
+          assert_respond_to '__proxy_options__', subject
+          assert_kind_of NsOptions::Namespace, subject.send('__proxy_options__')
         end
 
-        should "respond to namespace methods" do
-          assert_respond_to :option, subject
-          assert_respond_to :namespace, subject
-          assert_respond_to :to_hash, subject
-          assert_respond_to :each, subject
+        should "respond to proxied namespace methods" do
+          assert_respond_to :option,        subject
+          assert_respond_to :opt,           subject
+          assert_respond_to :namespace,     subject
+          assert_respond_to :ns,            subject
+          assert_respond_to :apply,         subject
+          assert_respond_to :to_hash,       subject
+          assert_respond_to :each,          subject
+          assert_respond_to :define,        subject
+          assert_respond_to :inspect,       subject
+          assert_respond_to :required_set?, subject
+          assert_respond_to :valid?,        subject
         end
 
         should "create options directly" do
@@ -41,22 +48,45 @@ module NsOptions::Proxy
     desc "when mixed in to a module"
     setup do
       @mod = Module.new do
-        include NsOptions
         include NsOptions::Proxy
+
+        option :test
       end
     end
     subject { @mod }
 
     should proxy_a_namespace
 
+    should "allow building from a hash of key-values" do
+      subject.new('test' => 1, 'more' => 2)
+
+      assert_equal 1, subject.test
+      assert_equal 2, subject.more
+    end
+
+    should "take `new` method overrides" do
+      @newmod = Module.new do
+        include NsOptions::Proxy
+
+        def self.new
+          # nothing
+        end
+      end
+
+      assert_raises ArgumentError do
+        @newmod.new('test' => 1, 'more' => 2)
+      end
+    end
+
   end
 
   class ClassTests < BaseTests
     desc "when mixed into a class"
     setup do
       @cls = Class.new do
-        include NsOptions
         include NsOptions::Proxy
+
+        option :test
       end
     end
 
@@ -72,6 +102,27 @@ module NsOptions::Proxy
     subject { @cls.new }
     should proxy_a_namespace
 
+    should "allow building from a hash of key-values" do
+      thing = @cls.new(:test => 1, :more => 2)
+
+      assert_equal 1, thing.test
+      assert_equal 2, thing.more
+    end
+
+    should "take init method overrides" do
+      @newcls = Class.new do
+        include NsOptions::Proxy
+
+        def initialize
+          # nothing
+        end
+      end
+
+      assert_raises ArgumentError do
+        @newcls.new('test' => 1, 'more' => 2)
+      end
+    end
+
   end
 
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: ns-options
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 15
   prerelease: 
   segments: 
   - 0
-  - 3
-  - 1
-  version: 0.3.1
+  - 4
+  - 0
+  version: 0.4.0
 platform: ruby
 authors: 
 - Collin Redding
@@ -15,10 +15,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-01-30 00:00:00 Z
+date: 2012-05-21 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   type: :development
+  prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -29,11 +30,11 @@ dependencies:
         - 0
         - 7
         version: "0.7"
-  prerelease: false
-  name: assert
   version_requirements: *id001
+  name: assert
 - !ruby/object:Gem::Dependency 
   type: :development
+  prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -44,9 +45,8 @@ dependencies:
         - 0
         - 1
         version: "0.1"
-  prerelease: false
-  name: assert-mocha
   version_requirements: *id002
+  name: assert-mocha
 description: Define and use namespaced options with a clean interface.
 email: 
 - collin.redding@reelfx.com
@@ -59,7 +59,8 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
-- README.markdown
+- LICENSE
+- README.md
 - Rakefile
 - lib/ns-options.rb
 - lib/ns-options/assert_macros.rb
@@ -78,9 +79,11 @@ files:
 - ns-options.gemspec
 - test/helper.rb
 - test/integration/app_test.rb
+- test/integration/proxy_test.rb
 - test/integration/user_test.rb
 - test/irb.rb
 - test/support/app.rb
+- test/support/proxy.rb
 - test/support/user.rb
 - test/unit/ns-options/assert_macros_test.rb
 - test/unit/ns-options/boolean_test.rb
@@ -128,9 +131,11 @@ summary: Define and use namespaced options with a clean interface.
 test_files: 
 - test/helper.rb
 - test/integration/app_test.rb
+- test/integration/proxy_test.rb
 - test/integration/user_test.rb
 - test/irb.rb
 - test/support/app.rb
+- test/support/proxy.rb
 - test/support/user.rb
 - test/unit/ns-options/assert_macros_test.rb
 - test/unit/ns-options/boolean_test.rb