require 'rubygems'

Question

I have seen many samples of Ruby code with this line (for example, http://www.sinatrarb.com/). What is purpose of this require?

# require 'rubygems'
require 'sinatra'
get '/hi' do
  "Hello world!"
end

In all cases the code works without this line.

Answer 1

It is often superfluous. It will allow you to require specific versions of particular gems though, with the gem command.

http://docs.rubygems.org/read/chapter/4

Answer 2

require 'rubygems' will adjust the Ruby loadpath allowing you to successfully require the gems you installed through rubygems, without getting a LoadError: no such file to load -- sinatra.

From the rubygems-1.3.6 documentation:

When RubyGems is required, Kernel#require is replaced with our own which is capable of loading gems on demand.

When you call require 'x', this is what happens:

• If the file can be loaded from the existing Ruby loadpath, it is.

• Otherwise, installed gems are searched for a file that matches. If it's found in gem 'y', that gem is activated (added to the loadpath).

The normal require functionality of returning false if that file has already been loaded is preserved.

See the documentation for Kernel#require to understand why this is necessary.