Needle-Extras: Services for Needle
Needle-Extras is a collection of additional services that may be used with the Needle dependency injection container for Ruby (needle.rubyforge.org).
Downloading
You may download Needle-Extras from Needle’s RubyForge project, at rubyforge.org/projects/needle. Needle-Extras is distributed both as a RubyGem, and as a Ruby library. It is also available from the RPA.
Installation
Needle-Extras is distributed as a gem, which makes it extremely easy to download, install, and use. However, it requires that you have RubyGems installed, first.
Assuming you have RubyGems installed, all you have to do is:
gem --remote-install needle-extras
This will install the latest version of Needle-Extras.
Needle-Extras is also distributed as a Ruby library. It’s not as easy to install this way, but it works. Simply grab the latest Needle-Extras package from the website, untar it, and install it by typing:
ruby setup.rb
Or, if you want a little more control over the installation:
ruby setup.rb --help
This will show you the options that are available to you, and then you can do each stage of the installation manually:
ruby setup.rb config ruby setup.rb setup ruby setup.rb install
Manual
For more information about Needle-Extras, see the Needle-Extras manual at needle.rubyforge.org/extras.
For more information about Needle, such as an overview and tutorials, see the Needle manual at needle.rubyforge.org.
Credits
Thanks go to:
- Matz, for creating Ruby in the first place.
- Christian Neukirchen for the prototype implementation of attr_inject.
License
Needle-Extras is copyright © 2004 Jamis Buck. It is open-source software, and may be redistributed under the terms of the BSD or Ruby licenses. The texts of these licences are included in the Needle-Extras distribution, under the doc subdirectory.
The Needle-Extras manual and all software used to build it are distributed under the Attribution-ShareAlike 1.0 Creative Commons license. Distribute it and modify it all you want, but give me credit and distribute your changes under an identical license.