R/set_schema.R

Defines functions set_schema

Documented in set_schema

#' Set the schema from user input
#'
#' @param format String. JSON data schema version number. There are currently
#'   three schemas supported: `"1.0"`, `"1.1"`, `"2.0"` and `"3.0"`.
#'   Formats `"1.0"` and `"1.1"` are included for backward compatibility only.
#'   Use `format = "3.0"` for new applications.
#' @param schema A file name (optionally including the path) with the JSON
#'   validation schema.
#'   The `schema` argument overrides `format`. The function extracts the
#'   version number for the basename, and overwrites the
#'   `format` argument by version number.
#' @return A list with components `format` (either `1.0`, `1.1`, `2.0`
#' or `3.0`), `schema` (long file name) and `schema_base` (base file name).
#' @examples
#' set_schema("3.0")
#' @export
set_schema <- function(format = "1.0", schema = NULL) {
  if (is.null(schema)) {
    schema_base <- switch(as.character(format),
                          "1.0" = "bds_v1.0.json",
                          "1.1" = "bds_v1.1.json",
                          "2.0" = "bds_v2.0.json",
                          "3.0" = "bds_v3.0.json",
                          "-")
    if (schema_base == "-") stop("Format ", format, " unknown.")
    schema <- system.file("schemas", schema_base, package = "bdsreader",
                          mustWork = TRUE)
  } else {
    # extract format by file name extract
    schema_base <- basename(schema)
    format <- gsub("bds_v(.+).json", "\\1", schema_base)
    schema <- system.file("schemas", schema_base, package = "bdsreader",
                          mustWork = TRUE)
  }
  list(format = format, schema = schema, schema_base = schema_base)
}
growthcharts/bdsreader documentation built on March 26, 2024, 4:16 a.m.