[ANN] Needle 0.6.0

[Jamis Buck]

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 ([email protected]).
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