André Arko @indirect // March 24, 2026 // SF Ruby Meetup How to install a gem it's harder than it sounds, really 

rv.dev gem.coop 

how do you install a gem? 

how about what’s in a gem? 

what about how require works? 

How does a name 
 become a .gem URL? 

› curl -s https: //gem.coop/info/rails | tail -n 1 8.1.3 actioncable:= 8.1.3,actionmailbox:= 8.1.3,actionmailer:= 8.1.3,actionpack:= 8.1.3,actiontext:= 8.1.3,actionview:= 8.1.3,activejob:= 8.1.3,activemodel:= 8.1.3,activerecord:= 8.1.3,activestorage:= 8.1.3,activesupport:= 8.1.3,bundler:>= 1.15.0,railties:= 8.1.3| checksum:6d017ba5348c98fc909753a8169b21d44de14d2a0b92 d140d1a966834c3c9cd3,ruby:>= 3.2.0,rubygems:>= 1.8.11 

› curl -s https: //gem.coop/info/rails | tail -n 1 8.1.3 actioncable:= 8.1.3,actionmailbox:= 8.1.3,actionmailer:= 8.1.3,actionpack:= 8.1.3,actiontext:= 8.1.3,actionview:= 8.1.3,activejob:= 8.1.3,activemodel:= 8.1.3,activerecord:= 8.1.3,activestorage:= 8.1.3,activesupport:= 8.1.3,bundler:>= 1.15.0,railties:= 8.1.3| checksum:6d017ba5348c98fc909753a8169b21d44de14d2a0b92 d140d1a966834c3c9cd3,ruby:>= 3.2.0,rubygems:>= 1.8.11 

checksum:6d017ba5348c98fc909753a8169b21d44de14d2a0 b92d140d1a966834c3c9cd3 › curl -sO https: //gem.coop/gems/rails-8.1.3.gem › sha256sum rails-8.1.3.gem 6d017ba5348c98fc909753a8169b21d44de14d2a0b92d140d1 a966834c3c9cd3 rails-8.1.3.gem 

what exactly is in a gem? 

› tar xfvz railties-8.1.3.gem x metadata.gz x data.tar.gz x checksums.yaml.gz 

› gzcat checksums.yaml.gz --- SHA256: metadata.gz: 8326ab6cc8e325055394ebd19c41d895e9ebd48e4752ec90d5c4675935516e6e data.tar.gz: 4152d8f55ae639d899f1cb6c54e1e93bb158bb76026b253482c5ae0343ac5aec SHA512: metadata.gz: f6aa3390b6b1699255f1dbc6c6f24c6d9c18d3bfa48f10b6d720595384b4d1bb 26f92232adb7011d3b1e7e977ca775cd253a12a135fe83eaa21e10dd0f14f779 data.tar.gz: a001cebc5b97f627336a3e8d394c4ecac4a5d2b9e62c82de3b484470a58deac7 c8ff0a8e8b497843386b1639c9cbfdfabee2cc7b2d483469e00a0b01da6bd41d 

› gzcat metadata.gz --- !ruby/object:Gem::Specification name: railties version: !ruby/object:Gem::Version version: 8.1.3 platform: ruby bindir: exe executables: - rails require_paths: - lib authors: - David Heinemeier Hansson summary: Tools for creating, working with, and running Rails applications. description: 'Rails internals: application bootup, plugins, generators, and rake tasks.' email: [email protected] homepage: https: //rubyonrails.org licenses: - MIT metadata: bug_tracker_uri: https: //github.com/rails/rails/issues changelog_uri: https: //github.com/rails/rails/blob/v8.1.3/railties/CHANGELOG.md documentation_uri: https: //api.rubyonrails.org/v8.1.3/ mailing_list_uri: https: //discuss.rubyonrails.org/c/rubyonrails-talk source_code_uri: https: //github.com/rails/rails/tree/v8.1.3/railties rubygems_mfa_required: 'true' rubygems_version: 4.0.6 specification_version: 4 files: - CHANGELOG.md - MIT-LICENSE - RDOC_MAIN.md - README.rdoc - exe/rails - lib/minitest/rails_plugin.rb - lib/rails.rb [ ...] 

› gzcat metadata.gz --- !ruby/object:Gem::Specification name: railties version: !ruby/object:Gem::Version version: 8.1.3 platform: ruby bindir: exe executables: - rails require_paths: - lib 

what gets unpacked, where? 

› mkdir railties-8.1.3 › tar xfvz data.tar.gz -C railties-8.1.3 x CHANGELOG.md x MIT-LICENSE x RDOC_MAIN.md x README.rdoc x exe/rails x lib/minitest/rails_plugin.rb x lib/rails.rb [ ...] 

› ruby -e 'puts Gem.dir' /Users/andre/.gem/ruby/4.0.0 › ls ~/.gem/ruby/4.0.0 | xargs -L1 echo bin build_info cache doc extensions gems plugins specifications 

mv railties-8.1.3.gem ~/.gem/ruby/4.0.0/cache/ 

› gunzip metadata.gz › ruby -ryaml -e 'puts YAML.unsafe_load_file("metadata").to_ruby' > ~/.gem/ruby/4.0.0/specifications/ railties-8.1.3.specification 

› mv railties-8.1.3 ~/.gem/ruby/4.0.0/gems/ › ls ~/.gem/ruby/4.0.0/gems/railties-8.1.3 CHANGELOG.md exe lib MIT-LICENSE RDOC_MAIN.md README.rdoc 

› cat < ~/.gem/ruby/4.0.0/bin/rails #!/usr/bin/env ruby require "rubygems" Gem.activate_and_load_bin_path("railties", "rails") EOF › chmod +x ~/.gem/ruby/4.0.0/bin/rails 

› ~/.gem/ruby/4.0.0/bin/rails Usage: rails COMMAND [options] You must specify a command: new Create a new Rails application. "rails new my_app" creates a new application called MyApp in "./my_app" 

how does require find a gem? 

› mkdir lib › echo 'puts "this is some ruby"' > lib/my-file.rb › ruby -Ilib -e 'puts $LOAD_PATH.first; \ require "my-file"' /Users/andre/lib this is some ruby 

how do we require 'rails'? 

require "rails" # becomes require "~/.gem/ruby/4.0.0/gems/railties-8.1.3/ lib/rails.rb" # and works! 

! gems installed ! 

rv.dev
 
 spinel.coop