otty / dotfiles

All tools/RubyGems

RubyGems

gem

RubyGems is a package management framework for Ruby.

Detected by gem | macOS, Linux, Windows |guides.rubygems.org

Sync it gem.toml

Sync rules

What travels, what stays, what never leaves

RubyGems in your home directory Every rule on this page, by file

…

:concurrent_downloads: 8

:sources:

- https://rubygems.org/

:gempath:machine-local

- /Users/octocat/.gem/ruby/3.4.0

- /opt/homebrew/lib/ruby/gems/3.4.0

gem: --no-document

…

Each machine keeps its own copy of these.

· ruby/ Exclude

· specs/ Exclude

· credentials Never synced

· ~/.local/share/gem/credentials Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/gem.tomlThe file this page is generated from

id = "gem"

name = "RubyGems"

homepage = "https://guides.rubygems.org/command-reference/"

description = "RubyGems is a package management framework for Ruby."

icon = "theSVG:rubygems"

detect = ["gem"]

# `gem help environment`: "Command line argument defaults and some RubyGems

# defaults can be set in a ~/.gemrc file for individual users and a gemrc in

# the SYSTEM CONFIGURATION DIRECTORY for all users." Only the per-user file is

# a dotfile. Windows writes the same file as %USERPROFILE%\.gemrc, which

# resolves to this very path.

paths = ["~/.gemrc"]

# `gem environment` on a stock install reports USER INSTALLATION DIRECTORY

# ~/.gem/ruby/<abi> and SPEC CACHE DIRECTORY ~/.gem/specs — installed gems and

# a downloaded index, not settings.

exclude = ["~/.gem/ruby/", "~/.gem/specs/"]

# rubygems lib/rubygems/config_file.rb, `credentials_path`: ~/.gem/credentials

# when that file exists, otherwise Gem.data_home + "/gem/credentials".

# lib/rubygems/defaults.rb defines `data_home` as

# `ENV["XDG_DATA_HOME"] || File.join(Gem.user_home, ".local", "share")` with no

# per-OS branch, so it is the XDG data home on macOS too and is written

# [xdgData]; [dataHome] would be ~/Library/Application Support, which RubyGems

# never writes. `gem environment credentials` prints whichever is in effect.

# Both hold nothing but RubyGems.org API keys, so both are whole-file secrets

# rather than files with a secret field in them.

secret = [

"~/.gem/credentials",

"[xdgData]/gem/credentials",

]

# Read once per `gem` invocation; no resident process holds it.

side_effect = false

# `gem help environment` documents `:gempath:` as "The paths in which to look

# for gems" — absolute paths into this machine's Ruby installations. The rest

# of the file (`:sources:`, `:verbose:`, `:update_sources:`, per-command

# argument defaults) is preference that should follow the user. The list mixes

# the user's own ~/.gem tree with whatever Ruby this machine has installed, so

# it cannot be handed to another machine — but it is worth having back when

# rebuilding this one: backup. `.gemrc` is YAML with Ruby symbol keys, and

# nothing in the name says so.

[[machine_lines]]

file = "~/.gemrc"

format = "yaml"

match = { key_path = [":gempath"] }

scope = "backup"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/gem. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out. None of them splits :gempath for you — that part is Otty’s own sync, or a template you write by hand.