Module Kernel
In: lib/rubygems/custom_require.rb
lib/rubygems.rb

Methods

gem  

External Aliases

require -> gem_original_require

Public Instance methods

Adds a Ruby Gem to the $LOAD_PATH. Before a Gem is loaded, its required Gems are loaded. If the version information is omitted, the highest version Gem of the supplied name is loaded. If a Gem is not found that meets the version requirement and/or a required Gem is not found, a Gem::LoadError is raised. More information on version requirements can be found in the Gem::Version documentation.

The gem directive should be executed before any require statements (otherwise rubygems might select a conflicting library version).

You can define the environment variable GEM_SKIP as a way to not load specified gems. You might do this to test out changes that haven‘t been installed yet. Example:

  GEM_SKIP=libA:libB ruby-I../libA -I../libB ./mycode.rb
gem:[String or Gem::Dependency] The gem name or dependency instance.
version_requirement:[default=">= 0"] The version requirement.
return:[Boolean] true if the Gem is loaded, otherwise false.
raises:[Gem::LoadError] if Gem cannot be found, is listed in GEM_SKIP, or version requirement not met.

[Validate]