id       = "rstudio"
name     = "RStudio"
homepage = "https://posit.co/products/open-source/rstudio/"
description = "An integrated development environment for R and Python."
icon     = "SimpleIcons:rstudioide"
# RStudio Desktop launches from a binary named rstudio on Linux and from
# RStudio.app on a Mac, whose bundle identifier — com.rstudio.desktop — is the
# one the Homebrew cask quits
# (https://formulae.brew.sh/api/cask/rstudio.json). The binary is what a user
# types, so that is what `detect` carries.
executables   = ["rstudio"]

[dotfiles]

# RStudio Desktop Administration Guide, Settings → Overview
# (https://docs.posit.co/ide/desktop-pro/settings/settings.html): "All of the
# settings file locations described in this section conform to the XDG Base
# Directory Specification", with the user scope listed as %APPDATA%\RStudio on
# Windows and ~/.config/rstudio on Unix, both keyed off XDG_CONFIG_HOME (or
# RSTUDIO_CONFIG_HOME, which takes precedence). The same page adds: "Here, and
# in the rest of this section, 'Unix' refers to both Linux and macOS."
#
# XDG_CONFIG_HOME with ~/.config as the fallback, and %APPDATA% on Windows, is
# exactly what [configHome] resolves to; the directory differs only in case
# between the two, and both of those filesystems are case-insensitive.
#
# The Preferences page names the file: "User preferences set in the RStudio
# IDE's Global Options dialog can also be set in the JSON file
# rstudio-prefs.json, located in the settings directory described above." The
# keybindings, snippets and editor themes a user adds sit beside it in the same
# directory.
#
# ~/.rstudio-desktop, the one location the Homebrew cask zaps, is the older
# session-state directory rather than settings, so it is not listed.
paths = ["[configHome]/rstudio/"]

secret  = []

# Each of these is an absolute path to something installed on this machine.
# Quoting the preference reference
# (https://docs.posit.co/ide/server-pro/session_user_settings/session_user_settings.html):
# initial_working_directory "The initial working directory for new R sessions";
# default_project_location "The directory path under which to place new projects
# by default"; python_path "The path to the default Python interpreter";
# git_exe_path "The path to the Git executable to use"; svn_exe_path "The path
# to the Subversion executable to use"; custom_shell_command "The fully
# qualified path to the custom shell command to use in the Terminal tab".
#
# The editor theme, font, pane layout and keybindings in the same file are
# preferences and travel.
[[dotfiles.machine_lines]]
file  = "[configHome]/rstudio/rstudio-prefs.json"
scope = "backup"
match = { key_path = [
  "initial_working_directory",
  "default_project_location",
  "python_path",
  "git_exe_path",
  "svn_exe_path",
  "custom_shell_command",
] }