conject 0.1.1 → 0.1.2

data/CHANGELOG

@@ -1,7 +1,12 @@
+Conject v0.1.2
+  * Aliasing objects via 'is', eg: context.configure_objects album: { is: "and_justice_for_all" }
+Conject v0.1.1
+  * canonical private accessors for module-scoped object
+
 Conject v0.1.0
   * All objects now have a public accessor object_context
-	* provide_with_objects can be used like construct_with, except it sets up lazy use-time resolution of dependencies
-	* ObjectContext#put now raises if you accidentally re-register an object with the same name
+  * provide_with_objects can be used like construct_with, except it sets up lazy use-time resolution of dependencies
+  * ObjectContext#put now raises if you accidentally re-register an object with the same name
 
 Conject v0.0.9
   * Classes with module namespaces can now refer to collaborators in construct_with by omitting the full path corresponding to the object namespace
@@ -16,17 +21,17 @@ Conject v0.0.6
 
 Conject v0.0.5
   * ObjectContext.configure_objects 
-	* ... support :cache => false for objects, causing them to be non-singletons in context
-	* ... support :construct => lambda do |name, context| Something.new end
+  * ... support :cache => false for objects, causing them to be non-singletons in context
+  * ... support :construct => lambda do |name, context| Something.new end
 
 Conject v0.0.4
   * Bug fixes / support for dealing with inheritance, ie, objects that inherit
-	from Conjected objects etc
+  from Conjected objects etc
 
 Conject v0.0.3
-	* ObjectContext now caches self reference with key 'this_object_context'
-	allowing context injection into objects
+  * ObjectContext now caches self reference with key 'this_object_context'
+  allowing context injection into objects
 
 Conject v0.0.1
-	* Automatic Type 1 object construction
-	* Nested ObjectContexts
+  * Automatic Type 1 object construction
+  * Nested ObjectContexts

data/README.md

@@ -90,4 +90,17 @@ subcontexts thereof.  It also means that they will be preferred over any objects
 All classes built within an ObjectContext are able to reference the context directly via the private accessor method "#object_context", which 
 is available as early as the call to #initialize.
 
+# Aliasing #
+The following will cause one object to be fulfilled by another.  In this case, 'album' is not expected to be built
+as an instance of the Album class, but rather will be set up as another name for 'and_justice_for_all':
+
+    context.configure_objects album: { is: 'and_justice_for_all' }
+
+Both 'album' and 'and_justice_for_all' will be built in the context when 'album' is first requested.
+This is more or less expressive shorthand for:
+
+    context['album'] = context['and_justice_for_all'] 
+
+...EXCEPT that it's a lazy approach: using 'is' means nothing actually gets built or set in the context before it
+is requested or composed into another object.
 

data/lib/conject/object_factory.rb

@@ -7,7 +7,14 @@ module Conject
       object = nil
       config = object_context.get_object_config(name)
       lambda_constructor = config[:construct]
-      if lambda_constructor
+      alias_for = config[:is]
+      if alias_for
+        begin
+          object = object_context.get(alias_for)
+        rescue Exception => ex
+          raise "(When attempting to fill alias '#{name}' with actual object '#{alias_for}') #{ex.message}"
+        end
+      elsif lambda_constructor
         case lambda_constructor.arity
         when 0
           object = lambda_constructor[]

data/lib/conject/version.rb

@@ -1,3 +1,3 @@
 module Conject
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/spec/acceptance/dev/is_spec.rb

@@ -0,0 +1,33 @@
+require File.expand_path(File.dirname(__FILE__) + "/../../spec_helper")
+
+describe "':is'" do
+  subject { new_object_context }
+
+  before do
+    append_test_load_path "basic_composition"
+    require 'ride_the_lightning'
+    require 'and_justice_for_all'
+  end
+
+  after do
+    restore_load_path
+  end
+
+  it "lets you alias one object for another" do
+    subject.configure_objects :album => { :is => :and_justice_for_all }
+    album = subject[:album]
+
+    album.should be
+    album.class.should == AndJusticeForAll
+    album.object_id.should == subject[:and_justice_for_all].object_id
+  end
+
+  it "provides good error message for missing target" do
+    subject.configure_objects :album => { :is => :mule_variations }
+
+    lambda do subject[:album] end.should raise_error(/when attempting to fill alias 'album'.*could not find.*MuleVariations/i)
+  end
+
+
+end
+

data/spec/conject/object_factory_spec.rb

@@ -113,6 +113,20 @@ describe Conject::ObjectFactory do
           lambda do subject.construct_new(:the_two_many_params, object_context) end.should raise_error(/constructor lambda takes 0, 1 or 2 params/i)
         end
       end
+    end
+
+    describe "'is' aliasing" do
+      let(:object_config) do { :is => :specific_object  } end
+      let(:specific_object) do "the specific object" end
+      
+      before do
+        object_context.should_receive(:get_object_config).with(:generic_object).and_return(object_config)
+        object_context.should_receive(:get).with(:specific_object).and_return(specific_object)
+      end
+
+      it "specifies that the configured object should be 'built' by pulling its target object from the object context" do
+        subject.construct_new(:generic_object, object_context).should == specific_object
+      end
 
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: conject
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-09 00:00:00.000000000 Z
+date: 2013-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -117,6 +117,7 @@ files:
 - scratch/sample.rb
 - scratch/special_construct.rb
 - spec/acceptance/dev/README
+- spec/acceptance/dev/is_spec.rb
 - spec/acceptance/dev/provide_with_objects_spec.rb
 - spec/acceptance/regression/README
 - spec/acceptance/regression/basic_composition_spec.rb
@@ -197,7 +198,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3653383717893701942
+      hash: -606989410081679107
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -206,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 3653383717893701942
+      hash: -606989410081679107
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24
@@ -215,6 +216,7 @@ specification_version: 3
 summary: Enable Guice-like dependency injection and contextual object interactions.
 test_files:
 - spec/acceptance/dev/README
+- spec/acceptance/dev/is_spec.rb
 - spec/acceptance/dev/provide_with_objects_spec.rb
 - spec/acceptance/regression/README
 - spec/acceptance/regression/basic_composition_spec.rb