id       = "rvm"
name     = "RVM"
homepage = "https://rvm.io"
description = "A command-line tool which allows you to easily install, manage, and work with multiple ruby environments from interpreters to sets of gems."
# RVM's own logo, from its home page.
icon     = "https://rvm.io/images/logo.png"
executables   = ["rvm"]
platforms = ["macos", "linux"]

[dotfiles]

# https://rvm.io/workflow/rvmrc — "The users rvmrc file overwrites settings in
# /etc/rvmrc and is loaded before RVM initializes. $HOME/.rvmrc settings are
# applied only for the user belonging to $HOME." Only that per-user file is a
# dotfile; /etc/rvmrc is system-wide and a project's .rvmrc belongs to the
# project.
paths = ["~/.rvmrc"]

# ~/.rvm is RVM's installation tree — compiled rubies, gemsets, downloaded
# sources, logs. It is an install, not configuration, and it is rebuilt by
# `rvm install`.
exclude = ["~/.rvm/"]

# .rvmrc holds installation and compilation preferences. RVM authenticates to
# nothing; gem credentials live in ~/.gem/credentials (apps/gem.toml).
secret = []

# Sourced by the shell on each RVM initialization.
side_effect = false

# Same page documents rvm_path as "Have RVM install to a different location"
# — an absolute path into this machine's disk. The rest of the file
# (rvm_install_on_use_flag, rvm_project_rvmrc, rvm_make_flags, rvm_archflags)
# is preference that should follow the user.
# A line here is the user having moved the install somewhere of their own
# choosing, which is what they would want back when rebuilding this machine.
[[dotfiles.machine_lines]]
file  = "~/.rvmrc"
match = { prefix = ["rvm_path"] }
scope = "backup"

[commands]
format = 1
label = "RVM"
description = "Install or switch Ruby versions. The completion data lists no options for these commands."
quality = "ai-draft"
base = "fig:rvm"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/rvm.ts"
license = "MIT"

[[commands.subcommand]]
path = ["install"]
label = "Install Ruby"
description = "Install one or more Ruby versions."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/rvm.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "versions"
label = "Ruby versions"
type = "string"
position = 0
multiple = true
suggestions = [{ value = "ruby-head", label = "ruby-head" }]
sources = ["fig"]

[[commands.subcommand.task]]
id = "install"
label = "Install"
fields = ["versions"]
required = ["versions"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["versions"]

[[commands.subcommand]]
path = ["use"]
label = "Use Ruby"
description = "Set up the current shell to use a Ruby version."

[[commands.subcommand.source]]
id = "fig"
kind = "completion"
url = "https://github.com/withfig/autocomplete/blob/master/src/rvm.ts"
license = "MIT"

[[commands.subcommand.field]]
id = "version"
label = "Ruby version"
type = "string"
position = 0
suggestions = [{ value = "system", label = "system" }, { value = "default", label = "default" }]
sources = ["fig"]

[[commands.subcommand.task]]
id = "use"
label = "Use"
fields = ["version"]
required = ["version"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["version"]