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:

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.