id = "rainfrog"
name = "rainfrog"
homepage = "https://github.com/achristmascarl/rainfrog"
description = "Database management TUI for PostgreSQL/MySQL/SQLite"
executables = ["rainfrog"]

[dotfiles]

# The project's official README documents rainfrog_config.toml under the
# platform config directory: ~/.config on Linux, ~/Library/Application Support
# on macOS, and LocalAppData/.../config on Windows. Database connection details
# can include passwords in the config, so only the config file is secret while
# the surrounding directory remains portable path content.
# https://github.com/achristmascarl/rainfrog#customization
paths = [
  "[configHome]/rainfrog/",
  "[appData]/rainfrog/",
  "%LOCALAPPDATA%/rainfrog/config/",
]

secret = [
  "[configHome]/rainfrog/rainfrog_config.toml",
  "[appData]/rainfrog/rainfrog_config.toml",
  "%LOCALAPPDATA%/rainfrog/config/rainfrog_config.toml",
]

[commands]
format = 1
label = "Connect to a database"
description = "Open rainfrog on a PostgreSQL, MySQL, Oracle or SQLite database by URL or by separate connection parts. The password option is left out; rainfrog prompts or reads the saved config."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.source]]
id = "readme"
kind = "help"
url = "https://github.com/achristmascarl/rainfrog#usage"
revision = "main 2026-10-27"
evidence = '''
Usage: rainfrog [OPTIONS] [COMMAND]
  -M, --mouse <MOUSE_MODE>       Whether to enable mouse event support. [possible values: true, false]
  -u, --url <URL>                Full connection URL for the database, e.g. postgres://username:password@localhost:5432/dbname
      --username <USERNAME>      Username for database connection
  -R, --reenter-password         Reenter the password for a saved database connection
      --host <HOST>              Host for database connection (ex. localhost)
      --port <PORT>              Port for database connection (ex. 5432)
      --database <DATABASE>      Name of database for connection (ex. postgres)
      --driver <DRIVER>          Driver for database connection (ex. postgres)
      --ssl-required             Require an SSL/TLS connection (supported by PostgreSQL, MySQL, and Oracle)
'''

[[commands.field]]
id = "url"
label = "Connection URL"
description = "A URL with a password in it lands in shell history."
type = "string"
option = ["--url", "-u"]
sources = ["readme"]

[[commands.field]]
id = "driver"
label = "Driver"
type = "string"
option = ["--driver"]
suggestions = [{ value = "postgres", label = "PostgreSQL" }, { value = "mysql", label = "MySQL" }, { value = "sqlite", label = "SQLite" }]
sources = ["readme"]

[[commands.field]]
id = "host"
label = "Host"
type = "string"
option = ["--host"]
sources = ["readme"]

[[commands.field]]
id = "port"
label = "Port"
type = "integer"
option = ["--port"]
sources = ["readme"]

[[commands.field]]
id = "username"
label = "Username"
type = "string"
option = ["--username"]
sources = ["readme"]

[[commands.field]]
id = "database"
label = "Database name"
type = "string"
option = ["--database"]
sources = ["readme"]

[[commands.field]]
id = "ssl_required"
label = "Require SSL/TLS"
type = "boolean"
option = ["--ssl-required"]
sources = ["readme"]

[[commands.field]]
id = "reenter_password"
label = "Re-enter saved password"
type = "boolean"
option = ["-R", "--reenter-password"]
sources = ["readme"]

[[commands.field]]
id = "mouse"
label = "Mouse support"
type = "enum"
option = ["--mouse", "-M"]
choices = [{ value = "true", label = "On" }, { value = "false", label = "Off" }]
sources = ["readme"]

[[commands.task]]
id = "url"
label = "Connect by URL"
fields = ["url", "ssl_required"]
required = ["url"]

[[commands.task]]
id = "parts"
label = "Connect by parts"
fields = ["driver", "host", "port", "username", "database", "ssl_required"]
required = ["driver"]

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["url", "driver", "host", "port", "username", "database"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["ssl_required", "reenter_password", "mouse"]