dmdScheme (version 1.1.2)

scheme_active: Functions to manage schemes

Description

scheme_active(): Shows the name and version of the active scheme.

scheme_default(): Shows the name of the default scheme which comes with the package and can not be deleted. If nameand version is specified, the default scheme to be used will be set. There is no need to do this only internally!. Otherwise, the scheme repository used is only returned.

scheme_download(): Scheme definitions can be stored in an online repo. The default is a github repo at https://github.com/Exp-Micro-Ecol-Hub/dmdSchemeRepository. This function dowloads a scheme definition, specified by name and version, and saves it locally under the name destfile

scheme_install(): Installed schemes are copied to cache("installedSchemes") and , if necessary, an .xlsx definition is saved in addition. These can be listed by using scheme_list.

scheme_install_r_package(): Install R package for scheme name version definition using the script install_R_package.R in the scheme package.

scheme_installed(): Checks if a scheme is installed

scheme_list(): Lists all definitions for schemes which are installed. Each follows the pattern SCHEMENAME_SCHEMEVERSION.EXT. All files with the same basename but different extensions represent different representations of the same scheme definition and are effectively equivalent, only that the tab Documentation can only be found in the .xls files.

scheme_list_in_repo(): Scheme definitions can be stored in an online repo.

scheme_repo(): Get or set scheme repository. If repo is specified, the scheme repository to be used is set. Otherwise, the scheme repository used is only returned.

scheme_uninstall(): Installed schemes are deleted from cache("installedSchemes") and moved to a temporary folder which is rteturned invisibly.

scheme_use(): Switch from the current scheme to a new scheme as defined in the scheme schemeDefinition. Installed schemes can be listed by using scheme_list(). New schemes can be added to the library via a call to scheme_add(). The name of the active scheme is saved in dmdScheme_active

Usage

scheme_active()
scheme_default(name = NULL, version = NULL)
scheme_download(
  name,
  version,
  destfile = NULL,
  overwrite = FALSE,
  baseurl = scheme_repo(),
  ...
)
scheme_install(
  name,
  version,
  repo = scheme_repo(),
  file = NULL,
  overwrite = FALSE,
  install_package = FALSE
)
scheme_install_r_package(name, version, reinstall = FALSE)
scheme_installed(name, version)
scheme_list()
scheme_list_in_repo(baseurl = scheme_repo(), ...)
scheme_repo(repo = NULL)
scheme_uninstall(name = NULL, version = NULL)
scheme_use(name = NULL, version = NULL)

Arguments

name

a character string containing the name of the scheme definition

version

a character string containing the version of the scheme definition

destfile

a character string containing the name of the downloaded scheme definition. If NULL, a temporary file will be used.

overwrite

if TRUE, the scheme will be overwritten if it exists

baseurl

a character string containing the base url of the repository in which the scheme definitions are located.

...

additional parameter for the function download.file.

repo

repo of the schemes.

file

if give, this file will be used as the local scheme definition, and repo will be ignored

install_package

if TRUE, install / update the accompanying R package. You can do it manually later by running scheme_install_r_package("NAME", "VERSION").

reinstall

if TRUE, the R package will be uninstalled before installing it.

Value

data.frame with two columns containing name and version of the default scheme

data.frame with two columns containing name and version of the default scheme

invisibly the value of destfile

invisibly NULL

invisibly NULL

TRUE if the theme is installed, FALSE if not

data.frame with two columns containing name and version of the intalled schemes

Returns the info about the scheme definitions in this repo as a list.

URL of the repo toi be used. If not set previously, the default repo at https://github.com/Exp-Micro-Ecol-Hub/dmdSchemeRepository/ is used.

invisibly returns the temporary location where the scheme definition is moved to.

Examples

# NOT RUN {
scheme_active()

scheme_default()

scheme_download(
  name = "dmdScheme",
  version = "0.9.5"
)
# }
# NOT RUN {
scheme_install("path/to/definition.xml")
scheme_install("path/to/definition.xlsx")
# }
# NOT RUN {
# }
# NOT RUN {
scheme_install_r_package()
# }
# NOT RUN {
# }
# NOT RUN {
scheme_installed("dmdScheme", "0.9.5")
scheme_installed("dmdScheme", "0.7.3")
# }
# NOT RUN {
scheme_list_in_repo()

# returns the repo used:
scheme_repo()
# }
# NOT RUN {
scheme_uninstall(name = "schemename", version = "schemeversion")
# }
# NOT RUN {
scheme_list()
scheme_use(name = "dmdScheme", version = "0.9.5")

# }