From Funtoo
Revision as of 19:44, August 23, 2014 by Threesixes (talk | contribs) (add puma section, remove warnings, fix console spacings, add categories, adjust links to reflect ruby rather than rubygems since the gems article got railroaded to ruby some how)
Jump to navigation Jump to search



We welcome improvements to this page. To edit this page, Create a Funtoo account. Then log in and then click here to edit this page. See our editing guidelines to becoming a wiki-editing pro.

Ruby is a programming language with its own package management system to extend the language.

Rubygems is a package management system to extend the ruby language.

Gems are packaged wonky in portage so this page will explain how to work with rubygems rather than fight it. Arch wiki outlines a similar method.

Emerge ruby & rubygems:

root # emerge ruby rubygems

Remove conflicting gems:

root # emerge -C dev-ruby/rake dev-ruby/racc dev-ruby/json dev-ruby/rdoc

Flush conflicting gems bad specs:

root # mv /usr/local/lib64/ruby/gems/2.1.0/specifications/ /usr/local/lib64/ruby/gems/2.1.0/specifications.backup

Fetch gems via rubygems:

root # gem install rdoc json rake racc
root # rubygems-update

update gem system:

root # update_rubygems
root # gem update --system
root # gem pristine --all

Now you're ready to use gem to manage gems.

To add gems to your path:

   $HOME/.bashrc - add gem bin directory to your path
PATH="$(ruby -rubygems -e 'puts Gem.user_dir')/bin:$PATH"

ruby on rails

root # gem install rails
root # rails new testproject
root # cd testproject
root # bundle install


puma is a fast web server for ruby on rails.

To enable puma in your project:

   $HOME/testproject/Gemfile - add puma gem to your rails application
gem 'puma'

To pull in puma:

root # bundle install
   $HOME/testproject/config/puma.rb - puma configuration file
workers Integer(ENV['PUMA_WORKERS'] || 3)
threads Integer(ENV['MIN_THREADS']  || 1), Integer(ENV['MAX_THREADS'] || 16)


rackup      DefaultRackup
port        ENV['PORT']     || 3000
environment ENV['RACK_ENV'] || 'development'

on_worker_boot do
  # worker specific setup
  ActiveSupport.on_load(:active_record) do
    config = ActiveRecord::Base.configurations[Rails.env] ||
    config['pool'] = ENV['MAX_THREADS'] || 16

to start puma:

root # bundle exec puma

or if you added gems bin dir to your path

root # puma