codeine 0.0.1 → 0.0.2

data/examples/flexible.rb

@@ -21,11 +21,13 @@ module BarModule
 end
 
 
-container_foo = Codeine.container_for(FooModule)
-container_foo.register(:logger){"the fancy logger for FooModule"}
+Codeine.configure(FooModule) do |c|
+  c.register(:logger){"the fancy logger for FooModule"}
+end
 
-container_bar = Codeine.container_for(BarModule)
-container_bar.register(:logger){"the simple logger for BarModule"}
+Codeine.configure(BarModule) do |c|
+  c.register(:logger){"the simple logger for BarModule"}
+end
 
 
 FooModule::A.new 

data/examples/simple.rb

@@ -2,7 +2,9 @@ $LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
 require 'codeine'
 
 Codeine.activate
-Codeine.register(:logger){"some logger"}
+Codeine.configure do |c|
+  c.register(:logger){"some logger"}
+end
 
 module FooModule
   class A

data/lib/codeine.rb

@@ -29,6 +29,14 @@ module Codeine
     end
     alias :[] :get
 
+    def configure(mod=nil, &block)
+      if mod.nil? 
+        default_container.configure(&block)
+      else
+        container_for(mod).configure(&block)
+      end
+    end
+
   end
 
   module Utility

data/lib/codeine/container.rb

@@ -29,5 +29,9 @@ module Codeine
     def filter(pattern, &block)
       filters.push :pattern => pattern, :block => block
     end
+
+    def configure
+      yield self
+    end
   end
 end

data/lib/codeine/version.rb

@@ -1,3 +1,3 @@
 module Codeine
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/readme.markdown

@@ -3,44 +3,53 @@ Codeine
 
 A simple dependency injector for ruby projects.
 
-Despite how flexible ruby is, and despite the insistence of a large part of the community, I frequently run into the need on larger projects to centrally manage my dependencies.  I end up building something like Codeine for each one, so I decided to build it one more time and re-use it.
+Despite how flexible ruby is, and the insistence of [some seriously smart people](http://weblog.jamisbuck.org/2008/11/9/legos-play-doh-and-programming), I frequently run into the need on larger projects to centrally manage my dependencies.  I end up building something like Codeine for each one, so I decided to build it one more time and re-use it.
+
+It turns out I agree with basically [everything Alexey Petrushin wrote here](http://ruby-lang.info/blog/you-underestimate-the-power-of-ioc-3fh)
+
 
 Usage
 -----
 
 Codeine can operate as either a global or module-local dependency container.  Using it globally is the least flexible, but presents the simplest syntax.
 
-    require 'codeine'
-    Codeine.register(:logger){Logger.new}
+```ruby
+require 'codeine'
+Codeine.register(:logger){Logger.new}
 
-    class Foo
-      codeine_inject :logger
-      
-      def initialize
-        logger.log "Initialized..."
-      end
-    end
+class Foo
+  codeine_inject :logger
+  
+  def initialize
+    logger.log "Initialized..."
+  end
+end
+```
 
 
 For library code, and for larger projects, it's probably a better idea to segregate the containers.
 
-    require 'codeine'
+```ruby
+require 'codeine'
 
 
-    module ProjectA
-      class Foo
-        codeine_inject :logger
+module ProjectA
+  class Foo
+    codeine_inject :logger
 
-        def initialize
-          logger.log "Initialized..."
-        end
-      end
+    def initialize
+      logger.log "Initialized..."
     end
+  end
+end
+
+Codeine.configure(ProjectA) do
+  c.register(:logger){Logger.new}
+end
 
-    container = Codeine.container_for(ProjectA)
-    container.register(:logger){Logger.new}
+foo = ProjectA::Foo.new
+```
 
-    foo = ProjectA::Foo.new
+The container bound to the ProjectA module will only service injection requests from classes/modules that reside within it
 
 
-The the container bound to the ProjectA module will only service injection requests from classes/modules that reside within it

data/spec/container_spec.rb

@@ -52,4 +52,13 @@ describe Codeine::Container do
     end
   end
 
+  describe "#configure" do
+    it "should accept a block and yield self" do
+      container.configure do |c|
+        c.register(:foo) {"bar"}  
+      end
+      container.get(:foo).should == "bar"
+    end
+  end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: codeine
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-10-08 00:00:00.000000000Z
+date: 2011-10-10 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &13428680 !ruby/object:Gem::Requirement
+  requirement: &16349240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,7 +21,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *13428680
+  version_requirements: *16349240
 description: A really simple, partitionable, ruby-flavored dependency injector
 email:
 - tim.ariyeh@gmail.com