Needle is a new dependency injection (a.k.a. "inversion of control") container for Ruby.
Project Page/Downloads: http://rubyforge.org/projects/needle
User Manual (work in progress): http://needle.rubyforge.org
API Documentation: http://needle.rubyforge.org/api
Needle Wiki: http://needle.rubyforge.org/wiki/wiki.pl
This release (0.6) is the second public release. It is, in general, NOT backwards compatible with software written against Needle 0.5 (you were, after all, warned that this might happen).
Needle is currently considered experimental software. You are encouraged to download it and try it out, but be warned that subsequent releases of Needle may change the API in non-backwards-compatible ways. This trend will continue until the release of Needle 1.0, at which point Needle will be considered "stable".
Please report any bugs. The bug tracker on the project page are a good place to do so, or you can just email me (jgb3@email.byu.edu). Additionally, you might consider taking advantage of the following resources:
Bug Reports: http://rubyforge.org/tracker/?atid=1642&group_id=410&func=browse
Forums: http://rubyforge.org/forum/?group_id=410
Mailing List: http://rubyforge.org/mailman/listinfo/needle-discuss
Feature Requests: http://rubyforge.org/tracker/?atid=1645&group_id=410&func=browse
···
------------------
Changes in 0.6
------------------
* Added benchmarks.
* Removed Container#register!.
* Added Container#define and Container#define!. Container#define! works just like Container#register! used to. Container#define is similar to #define!, but does not use instance_eval (thanks for the suggestion, Jim).
* Service constructor blocks may accept two parameters: the container, and the service point itself.
* Container#namespace (and friends) no longer acts like "mkdir -p".
* Added QueryableMutex for detecting cycles in dependencies.
* Changed implementation of service models to use instantiation pipelines.
* Added many new service models (prototype_initialize, threaded, singleton_deferred_initialize, etc.)
* Added Jim Weirich's "DI in Ruby" article to documentation.
------------------
Examples
------------------
Using #register:
require 'needle'
registry = Needle::Registry.new
registry.register( :adder ) { Adder.new }
registry.register( :calc ) do |r|
calc = Calculator.new
calc.adder = r.adder
calc
end
calc = registry.calc
p calc.add( 5, 6 )
Using #define!:
registry.define! do
adder { Adder.new }
calc do
c = Calculator.new
c.adder = adder
c
end
end
Using #define:
registry.define do |b|
b.adder { Adder.new }
b.calc do
c = Calculator.new
c.adder = b.adder
c
end
end
--
Jamis Buck
jgb3@email.byu.edu
http://www.jamisbuck.org/jamis