Module | Kernel |
In: |
lib/rubygems/custom_require.rb
lib/rubygems.rb |
require | -> | gem_original_require |
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. |