How do you get a ruby gem into the include path for "require"

Question

I am creating what I expect to be ruby gem. Anyone have a good link to a tutorial on converting a simple library or plugin to a gem? Also, especially, what is the process that Ruby uses to allow the require to find gems? It seems to be something more than putting the files in the gem path (or is my configuration screwed up?).

Thanks

Answer 1

It's actually not to hard to do this manually. Let's say you have a library whatever.rb that you want to distribute as a gem.

1. make a directory lib and put a copy of whatever.rb in lib/whatever.rb.
2. make a file whatever.gemspec, and put the following in there, filling in the appropriate values:

   
    Gem::Specification.new do |spec|
      spec.name = 'the-name-of-your-gem'
      spec.version ='0.0.1'
   
      # this is important - it specifies which files to include in the gem.
      spec.files = ["lib/whatever.rb"]
   
      # optional, but useful to your users
      spec.summary = "A more longwinded description of your gem"
      spec.author = 'Your Name'
      spec.email = '[email protected]'
      spec.homepage = 'http://www.yourpage.com'
   
      # you did document with RDoc, right?
      spec.has_rdoc = true
   
      # if you have a ruby forge project
      spec.rubyforge_project = 'your-project-name-on-rubyforge'
   
      # if you have any dependencies on other gems, list them thusly
      spec.add_dependency('hpricot')
      spec.add_dependency('log4r', '>= 1.0.5')
    end
   

3. now, to build the gem, use the gem build command:

   % gem build whatever.gemspec
   Successfully built RubyGem
   Name: the-name-of-your-gem
   Version: 0.0.1
   File: the-name-of-your-gem-0.0.1.gem
   %
   

4. You can test locally by using gem install the-name-of-your-gem-0.0.1.gem To use your library in a script then, simply do the following at the top:

   
   require 'rubygems' # puts gem libraries in the require path
   require 'whatever' # loads your library
   

For more on what the various settings in the gemspec file, check the GemSpec Reference.

Personally, I use rubygems a lot to package executable scripts as well, and find it very handy for that.