interchangeable 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1bcdfc0e991f5e031d0aaf71b7b400ef9fbd1898
-  data.tar.gz: ad3ab4c86e1d49bc83c77bfc1a8d863650839455
+  metadata.gz: ac7c4148785998ed665d7ca26b07171dbbc83aac
+  data.tar.gz: d26b48301c864f75206661fe235f00c96a7482f8
 SHA512:
-  metadata.gz: bbfd378812d261597c0ac4687a6cd042213179249d74c85c1ec6a840b904a522a7b99c86cc9b2fdb503cadc11d1cd752ac5e9d79c481d17d2aece003ee8a0196
-  data.tar.gz: 0c4153e30f694cc19c61aeeba39ea2cb541d6ff429ecc980883892c3b290146d7d9f3a237771b358e94605231fcfa8ba10c630946311770a36e661b1e8ba92a2
+  metadata.gz: 0da66a26a9c9b051cf21fb9566200fe5c54b09d66377977e31b3d5f20671ef78886b430c927884cdf00a571ad5843cffd5725981957d5b2559be8b8eff638ea2
+  data.tar.gz: ab5c714337289c4f5a03184991dfc264b30878993913670e6b00539734ba51dd8c9bd139f5d3940e307fee53482cffae9843c15edba091bf031a4679a065b034

data/README.md

@@ -16,7 +16,7 @@ can become
 
 ```ruby
 class MyApi
-  interchangeable_instance_method :api_key
+  interchangeable_method :api_key
 end
 ```
 
@@ -24,8 +24,48 @@ Elsewhere in your application, you can define the method like so:
 
 ```ruby
   Interchangeable.define MyApi, :api_key { 'anything' }
+
+  MyApi.new.api_key # 'anything'
+
 ```
 
+You can also provide a default implementation that can be overridden elsewhere:
+
+```ruby
+class MyApi
+  interchangeable_method(:api_key) { 'abc' }
+end
+
+MyApi.new.api_key # 'abc'
+```
+
+**But why bother doing this?**
+
+Interchangeable will provide you a list of the methods you have defined, as well as some helpful information.
+
+```ruby
+class MyApi
+  interchangeable_describe "this is an apple"
+  interchangeable_method :apple
+  
+  interchangeable_describe "this is an orange"
+  interchangeable_method(:orange) { 'orange' }
+  
+  interchangeable_describe "this is a banana"
+  interchangeable_method :banana
+end
+
+Interchangeable.define(MyApi, :banana) { 'banana' }
+
+
+Interchangeable.methods # [<target=MyApi, method_name=:apple,  implemented=false, default=false, description="this is an apple">,
+                        #  <target=MyApi, method_name=:orange, implemented=true,  default=true,  description="this is an orange">,
+                        #  <target=MyApi, method_name=:banana, implemented=true,  default=false, description="this is a banana">]
+
+```
+
+This information can be helpful if you have a reusable system with many interchangeable parts.
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/interchangeable/version.rb

@@ -1,3 +1,3 @@
 module Interchangeable
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/lib/interchangeable.rb

@@ -29,10 +29,13 @@ module Interchangeable
     end
 
     def define the_class, method_name, &block
-      the_class.instance_eval do
+      entry = Interchangeable.methods.select { |x| x.target == the_class && x.method_name && method_name }.first
+      unless entry
+        entry = Interchangeable.methods.select { |x| x.target == the_class.singleton_class && x.method_name && method_name }.first
+      end
+      entry.target.instance_eval do
         define_method method_name, &block
       end
-      entry = Interchangeable.methods.select { |x| x.target == the_class && x.method_name && method_name }.first
       entry.implemented = true
       entry.default     = false
     end

data/spec/interchangeable_spec.rb

@@ -13,7 +13,7 @@ describe Interchangeable do
       ["Yawn", "applesauce", "make sure this works"],
     ].map { |x| Struct.new(:class_name, :method_name, :description).new(*x) }.each do |example|
 
-      describe "noting the method on a class" do
+      describe "noting the instance method on a class" do
 
         before do
           eval("class #{example.class_name}
@@ -166,6 +166,47 @@ describe Interchangeable do
 
       end
 
+      describe "noting the class-level method on a class" do
+
+        before do
+          eval("class #{example.class_name}
+                  class << self
+                    interchangeable_describe \"#{example.description}\"
+                    interchangeable_method :#{example.method_name}
+                  end
+                end")
+        end
+
+        describe "methods" do
+
+          it "should create an entry" do
+            Interchangeable.methods.count.must_equal 1
+          end
+
+          it "should return the target as a singleton class" do
+            Interchangeable.methods.first.target.must_equal eval(example.class_name).singleton_class
+          end
+
+        end
+
+        describe "defining the method later" do
+
+          let(:the_return_value) { Object.new }
+
+          before do
+            object = the_return_value
+            Interchangeable.define(eval(example.class_name), eval(":#{example.method_name}")) { object }
+          end
+
+          it "should stamp the method on the object" do
+            instance = eval(example.class_name)
+            instance.send(example.method_name.to_sym).must_be_same_as the_return_value
+          end
+
+        end
+
+      end
+
     end
 
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: interchangeable
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Darren Cauthon
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-08 00:00:00.000000000 Z
+date: 2014-10-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler