Simulate the functions before truly running them

Description

These functions are used to simulate the main functions before truly running them, to disable changes to the files and to the cloud.

Usage

mimic_on()

mimic_off()

is_mimic_on()

Details

These are used in most examples, so the user settings don't change when running [utils::example()]. Internally, these change the options 'ss.mimic', 'ss.mimic.local' and 'ss.mimic.cloud'.

Value

nothing

Functions

• mimic_on(): Enable mimic and write mimic files

• mimic_off(): Disable mimic

• is_mimic_on(): Check if mimic is on

Examples

mimic_on()
if(interactive()) {
  sync()
}
mimic_off()

Pull Rstudio Settings

Description

Pulls Rstudio settings from Google Drive, without pushing. This is just a helper function for [sync()], the main function, but can be used alone, although this function will not do any checking, and will just override.

Usage

pull(
  all = FALSE,
  addins_gd = FALSE,
  editor_bindings_gd = FALSE,
  rstudio_bindings_gd = FALSE
)

Arguments

Value

nothing

See Also

[read_from_gd()], [sync()], [push()]

Examples

mimic_on()
  pull()           # does nothing
  pull(all = TRUE) # will pull all settings from gd, overwriting them
  pull(addins_gd = '{"insertPipeOperator": "Shift+Tab"}',)
  # will write to addins.json the string
  pull(
    addins_gd = '{"insertPipeOperator": "Shift+Tab"}',
    editor_bindings_gd= TRUE
  )
  # will write to addins.json the string and pull editor_bindings from gd
mimic_off()

Push Rstudio Settings

Description

Pushes Rstudio settings to Google Drive, without pulling. This is just a helper function for [sync()], the main function, but can be used alone, although this function will not do any checking, and will just override. Because of the way [googledrive::drive_put] is built, this function reads from the files directly.

Usage

push(
  do_all = FALSE,
  do_addins = FALSE,
  do_editor_bindings = FALSE,
  do_rstudio_bindings = FALSE,
  progBar = NULL
)

Arguments

Value

nothing

Examples

mimic_on()
  push()              # does nothing
  push(do_all = TRUE) # will push all settings to gd, overwriting them
  push(do_editor_bindings = FALSE, do_rstudio_bindings = FALSE)
  # will push only editor and rstudio bindings
mimic_off()

Read from Google Drive a JSON file inside rstudio folder

Description

This is a helper function for [pull()] and [sync()] that: * reads a json file from Google Drive inside the rstudio folder * converts it to a data frame (to resolve conflicts in the future)

Usage

read_from_gd(what, progBar = NULL)

Arguments

Value

A data frame with the contents of the file, converted from json

See Also

[read_from_local()] [sync()] [jsonlite::fromJSON()] [googledrive::drive_read_string()]

Examples

mimic_on()
  read_from_gd("rstudio_bindings")
  read_from_gd("editor_bindings")
  read_from_gd("addins")
mimic_off()

Read from local a JSON file inside rstudio folder

Description

This is a helper function for [sync()] that: * reads a json file from the local rstudio folder * converts it to a data frame (to resolve conflicts in the future)

Usage

read_from_local(what)

Arguments

Value

A data frame with the contents of the file, converted from json

See Also

[read_from_gd()], [push()], [sync()], [jsonlite::read_json()]

Examples

mimic_on()
  read_from_local("rstudio_bindings")
  read_from_local("editor_bindings")
  read_from_local("addins")
mimic_off()

Get rstudio local path

Description

Get rstudio local path

Usage

rstudio_path()

Value

path to rstudio local

See Also

[rappdirs::user_config_dir()], [is_windows()], [usethis::is_windows()]

Examples

rstudio_path()

Sync Rstudio Settings

Description

Gets the settings from Google Drive and from the local files, and merges them. If there are conflicts, will ask the user to resolve them. Finally, will write the merged settings to the local files, and push them to Google Drive. Will first ask for confirmation if interactive. This function is what's called by the addin.

Usage

sync(write = NULL, useProgBar = TRUE)

Arguments

Details

NOTE: if it's not interactive, it won't write to files because of CRAN policies.

Value

nothing

See Also

[push()], [pull()]

Examples

mimic_on()
if(interactive()) {
  sync(write = TRUE)   # will immediately try to sync all settings
  sync(write = FALSE)  # dry run, will not write to files or push to gd
  sync()               # will ask for confirmation, then sync all settings
}
mimic_off()