id       = "rbenv"
name     = "rbenv"
homepage = "https://github.com/rbenv/rbenv"
description = "rbenv is a version manager tool for the Ruby programming language on Unix-like systems."
# The rbenv organisation's avatar — a purpose-drawn mark for this project,
# which is the only thing that org publishes. No logo file in the repo.
icon     = "https://github.com/rbenv.png"
executables   = ["rbenv"]

[dotfiles]

# README, `rbenv global`: the command writes "the version name to the
# ~/.rbenv/version file". The same page's environment-variable table gives
# RBENV_ROOT a default of ~/.rbenv, "the directory under which Ruby versions
# and shims reside". That one file — a single line naming the default Ruby —
# is the only thing under the root the user authors.
paths = ["~/.rbenv/version"]

# The rest of RBENV_ROOT is installed software and generated stubs. Same
# README: rbenv "looks up that Ruby version among those installed under
# ~/.rbenv/versions/", `rbenv rehash` "Installs shims for all Ruby executables
# known to rbenv (~/.rbenv/versions/*/bin/*)", and rbenv "Prepends
# ~/.rbenv/shims directory to PATH".
exclude = [
  "~/.rbenv/versions/",
  "~/.rbenv/shims/",
  "~/.rbenv/plugins/",
]

# rbenv has no credentials.
secret = []

# Read once per invocation by a shell script; no resident process holds it.
side_effect = false

# No machine_lines: the file holds one version string and nothing else, so
# there is no line to leave behind — a consumer that syncs it should expect the
# receiving machine to need `rbenv install` for that version.

[commands]
format = 1
label = "rbenv"
description = "Use the subcommand tabs to install a Ruby or set the global or local one."
quality = "ai-draft"
base = "fig:rbenv"
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/rbenv.ts"
license = "MIT"

[[commands.subcommand]]
path = ["install"]
label = "Install a Ruby version"

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

[[commands.subcommand.field]]
id = "version"
label = "Version"
description = "For example 3.3.4."
type = "string"
position = 0
sources = ["fig"]

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

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

[[commands.subcommand]]
path = ["global"]
label = "Set the global version"
description = "Leave the version empty to show the current one."

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

[[commands.subcommand.field]]
id = "version"
label = "Version"
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.field]]
id = "unset"
label = "Unset"
type = "boolean"
option = ["--unset"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "set"
label = "Set global"
fields = ["version"]
required = ["version"]

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

[[commands.subcommand]]
path = ["local"]
label = "Set the local version"
description = "Writes .ruby-version in the current directory. Leave the version empty to show it."

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

[[commands.subcommand.field]]
id = "version"
label = "Version"
type = "string"
position = 0
sources = ["fig"]

[[commands.subcommand.field]]
id = "unset"
label = "Unset"
type = "boolean"
option = ["--unset"]
sources = ["fig"]

[[commands.subcommand.task]]
id = "set"
label = "Set local"
fields = ["version"]
required = ["version"]

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