dim 0.9

data/.gitignore

@@ -0,0 +1,3 @@
+.project_env.rc
+.togglerc
+.gem

data/.rspec

@@ -0,0 +1 @@
+-I. -I/Users/jim/working/git/rspec-given/lib --color

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.2@dim --create

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2004, 2010 Jim Weirich
+
+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.md

@@ -0,0 +1,16 @@
+# DIM: Dependency Injection - Minimal
+
+DIM is Jim Weirich's minimalistic dependency injection framework,
+maintained in Gem form by [Mike Subelsky](http://subelsky.com).
+For more background information, read Jim's [Dependency Injection](http://onestepback.org/articles/depinj/dim/dim_rb.html))
+slides.
+
+# License
+
+DIM is available under the MIT license (see the file MIT-LICENSE for
+details).
+
+# More Information:
+
+Read [this](http://onestepback.org/articles/depinj/appendixa.html) for
+more information about using DIM.

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby"
+
+require 'rake/clean'
+require 'rake/testtask'
+
+task :default => :spec
+
+task :spec do
+  sh "rspec spec"
+end

data/dim.gemspec

@@ -0,0 +1,21 @@
+require './lib/dim/version'
+
+Gem::Specification.new do |s|
+  s.name = %q{dim}
+  s.version = Dim::VERSION
+  s.authors = ["Jim Weirich", "Mike Subelsky"]
+  s.date = Time.now.utc.strftime("%Y-%m-%d")
+  s.email = %q{mike@subelsky.com}
+  s.extra_rdoc_files = [
+    "README.md"
+  ]
+  s.files = `git ls-files`.split("\n")
+  s.homepage = %q{http://github.com/subelsky/dim}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.5.0}
+  s.summary = %q{Minimalistic dependency injection framework}
+  s.description = %q{Minimalistic dependency injection framework}
+  s.test_files = `git ls-files spec`.split("\n")
+  s.add_development_dependency 'rspec'
+end

data/lib/dim.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/env ruby
+#--
+# Copyright 2004, 2005, 2010 by Jim Weirich (jim.weirich@gmail.com).
+# All rights reserved.
+#
+# This software is available under the MIT license.  See the
+# MIT-LICENSE file for details.
+#++
+#
+# = Dependency Injection - Minimal (DIM)
+#
+# The DIM module provides a minimal dependency injection framework for
+# Ruby programs.
+#
+# Example:
+#
+#   require 'dim'
+#
+#   container = Dim::Container.new
+#   container.register(:log_file) { "logfile.log" }
+#   container.register(:logger) { |c| FileLogger.new(c.log_file) }
+#   container.register(:application) { |c|
+#     app = Application.new
+#     app.logger = c.logger
+#     app
+#   }
+#
+#   c.application.run
+#
+module Dim
+  # Thrown when a service cannot be located by name.
+  class MissingServiceError < StandardError; end
+
+  # Thrown when a duplicate service is registered.
+  class DuplicateServiceError < StandardError; end
+
+  # Dim::Container is the central data store for registering services
+  # used for dependency injuction.  Users register services by
+  # providing a name and a block used to create the service.  Services
+  # may be retrieved by asking for them by name (via the [] operator)
+  # or by selector (via the method_missing technique).
+  #
+  class Container
+    attr_reader :parent
+
+    # Create a dependency injection container.  Specify a parent
+    # container to use as a fallback for service lookup.
+    def initialize(parent=nil)
+      @services = {}
+      @cache = {}
+      @parent = parent || Container
+    end
+
+    # Register a service named +name+.  The +block+ will be used to
+    # create the service on demand.  It is recommended that symbols be
+    # used as the name of a service.
+    def register(name, &block)
+      if @services[name]
+        fail DuplicateServiceError, "Duplicate Service Name '#{name}'"
+      end
+      @services[name] = block
+    end
+
+    # Lookup a service by name.  Throw an exception if no service is
+    # found.
+    def [](name)
+      @cache[name] ||= service_block(name).call(self)
+    end
+
+    # Lookup a service by message selector.  A service with the same
+    # name as +sym+ will be returned, or an exception is thrown if no
+    # matching service is found.
+    def method_missing(sym, *args, &block)
+      self[sym]
+    end
+
+    # Return the block that creates the named service.  Throw an
+    # exception if no service creation block of the given name can be
+    # found in the container or its parents.
+    def service_block(name)
+      @services[name] || @parent.service_block(name)
+    end
+
+    # Searching for a service block only reaches the Container class
+    # when all the containers in the hierarchy search chain have no
+    # entry for the service.  In this case, the only thing to do is
+    # signal a failure.
+    def self.service_block(name)
+      fail(MissingServiceError, "Unknown Service '#{name}'")
+    end
+  end
+end

data/lib/dim/version.rb

@@ -0,0 +1,3 @@
+module Dim
+  VERSION = "0.9"
+end

data/spec/dim_spec.rb

@@ -0,0 +1,165 @@
+require 'dim'
+require 'rspec/given'
+
+class ConsoleAppender
+end
+
+class Logger
+  attr_accessor :appender
+end
+
+class MockDB
+end
+
+class RealDB
+  attr_accessor :username, :password
+  def initialize(username, password)
+    @username, @password = username, password
+  end
+end
+
+class App
+  attr_accessor :logger, :db
+  def initialize(logger=nil)
+    @logger = logger
+  end
+end
+
+describe Dim::Container do
+  let(:container) { Dim::Container.new }
+
+  Scenario "creating objects" do
+    Given { container.register(:app) { App.new } }
+    Then  { container.app.should be_a(App) }
+  end
+
+  Scenario "returning the same object every time" do
+    Given { container.register(:app) { App.new } }
+    Given(:app)  { container.app }
+    Then { container.app.should be(app) }
+  end
+
+  Scenario "contructing dependent objects" do
+    Given { container.register(:app) { |c| App.new(c.logger) } }
+    Given { container.register(:logger) { Logger.new } }
+    Given(:app) { container.app }
+    Then { app.logger.should be(container.logger) }
+  end
+
+  Scenario "constructing dependent objects with setters" do
+    Given {
+      container.register(:app) { |c|
+        App.new.tap { |obj|
+          obj.db = c.database
+        }
+      }
+    }
+    Given { container.register(:database) { MockDB.new } }
+    Given(:app) { container.app }
+
+    Then { app.db.should be(container.database) }
+  end
+
+  Scenario "constructing multiple dependent objects" do
+    Given {
+      container.register(:app) { |c|
+        App.new(c.logger).tap { |obj|
+          obj.db = c.database
+        }
+      }
+    }
+    Given { container.register(:logger) { Logger.new } }
+    Given { container.register(:database) { MockDB.new } }
+    Given(:app) { container.app }
+    Then { app.logger.should be(container.logger) }
+    Then { app.db.should be(container.database) }
+  end
+
+  Scenario "constructing chains of dependencies" do
+    Given { container.register(:app) { |c| App.new(c.logger) } }
+    Given {
+      container.register(:logger) { |c|
+        Logger.new.tap { |obj|
+          obj.appender = c.logger_appender
+        }
+      }
+    }
+    Given { container.register(:logger_appender) { ConsoleAppender.new } }
+    Given { container.register(:database) { MockDB.new } }
+    Given(:logger) { container.app.logger }
+
+    Then { logger.appender.should be(container.logger_appender) }
+  end
+
+  Scenario "constructing literals" do
+    Given { container.register(:database) { |c| RealDB.new(c.username, c.userpassword) } }
+    Given { container.register(:username) { "user_name_value" } }
+    Given { container.register(:userpassword) { "password_value" } }
+    Given(:db) { container.database }
+
+    Then { db.username.should == "user_name_value" }
+    Then { db.password.should == "password_value" }
+  end
+
+  describe "Errors" do
+    Scenario "missing services" do
+      Then {
+        lambda {
+          container.undefined_service_name
+        }.should raise_error(Dim::MissingServiceError, /undefined_service_name/)
+      }
+    end
+
+    Scenario "duplicate service names" do
+      Given { container.register(:duplicate_name) { 0 } }
+      Then {
+        lambda {
+          container.register(:duplicate_name) { 0 }
+        }.should raise_error(Dim::DuplicateServiceError, /duplicate_name/)
+      }
+    end
+  end
+
+  describe "Parent/Child Container Interaction" do
+    Given(:parent) { container }
+    Given(:child) { Dim::Container.new(parent) }
+
+    Given { parent.register(:cell) { :parent_cell } }
+    Given { parent.register(:gene) { :parent_gene } }
+    Given { child.register(:gene) { :child_gene } }
+
+    Scenario "reusing a service from the parent" do
+      Then { child.cell.should == :parent_cell }
+    end
+
+    Scenario "overiding a service from the parent" do
+      Then "the child service overrides the parent" do
+        child.gene.should == :child_gene
+      end
+    end
+
+    Scenario "wrapping a service from a parent" do
+      Given { child.register(:cell) { |c| [c.parent.cell] } }
+      Then { child.cell.should == [:parent_cell] }
+    end
+
+    Scenario "overriding an indirect dependency" do
+      Given { parent.register(:wrapped_cell) { |c| [c.cell] } }
+      Given { child.register(:cell) { :child_cell } }
+      Then { child.wrapped_cell.should == [:child_cell] }
+    end
+
+    Scenario "parent / child service conflicts from parents view" do
+      Then { parent.gene.should == :parent_gene }
+    end
+
+    Scenario "child / child service name conflicts" do
+      Given(:other_child) { Dim::Container.new(parent) }
+      Given { other_child.register(:gene) { :other_child_gene } }
+
+      Then { child.gene.should == :child_gene }
+      Then { other_child.gene.should == :other_child_gene }
+    end
+  end
+
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: dim
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: "0.9"
+platform: ruby
+authors: 
+- Jim Weirich
+- Mike Subelsky
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-08 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Minimalistic dependency injection framework
+email: mike@subelsky.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- .gitignore
+- .rspec
+- .rvmrc
+- MIT-LICENSE
+- README.md
+- Rakefile
+- dim.gemspec
+- lib/dim.rb
+- lib/dim/version.rb
+- spec/dim_spec.rb
+has_rdoc: true
+homepage: http://github.com/subelsky/dim
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Minimalistic dependency injection framework
+test_files: 
+- spec/dim_spec.rb