How to use a local gem in your Gemfile

Updated . Posted . Visible to the public. Repeats.

You can use local copies of gems in your Gemfile like this:

gem 'spreewald', path: '~/gems/spreewald'

As soon as you have bundled your project with the local copy of the gem, all code changes in the copy will be available on your project. So you can for example set a debugger or add console output in the gem and use it from your project.
If you checked out the gem with your versioning tool, you can easily reset your changes afterwards or make a pull request for the gem if you improved it.

Don't commit a Gemfile with local paths, because this will not work for other developers.


Another way to use a local gem is to install the gem locally on your system and then override the version from git:

cd ~/gems/spreewald
rvm use 2.5.1 # or rbenv local 2.5.1 # use the ruby version your project, which should use the gem, uses
rake install 

If you want to switch back to use the version from Rubygems use gem uninstall spreewald to uninstall the local version and gem install spreewald to reinstall from Rubygems.

Judith Roth
Last edit
Michael Leimstädtner
License
Source code in this card is licensed under the MIT License.
Posted by Judith Roth to makandra dev (2017-08-02 07:47)