R/csl_style_find.R

In ropenscilabs/seasl: Citation Style Language ('CSL') Utilities

#' Search for a CSL style
#'
#' @export
#' @param x (character) a full or partial journal name
#' @return if no matches `NULL`. otherwise, one or more file paths
#' to the style file on your machine
#' @examples
#' # setup
#' csl_cache$cache_path_set("seasl", type = "tempdir")
#' csl_cache$mkdir()
#' dir.create(file.path(csl_cache$cache_path_get(), "styles"))
#' an <- system.file('inst/examples/acta-naturae.csl', package = 'seasl')
#' file.copy(an, file.path(csl_cache$cache_path_get(), "styles/acta-naturae.csl"))
#' 
#' # find a style
#' csl_style_find(x = "Naturae")
#' 
#' # cleanup
#' csl_cache$delete_all()
#' 
#' \dontrun{
#' # fetch styles
#' csl_fetch_styles()
#' 
#' # single match
#' csl_style_find(x = "American Journal of Epidemiology")
#' 
#' # many matches
#' csl_style_find(x = "American Journal")
#' csl_style_find(x = "pediatrics")
#' csl_style_find(x = "analysis and prevention")
#' 
#' # no matches
#' csl_style_find(x = "foo bar")
#' }
csl_style_find <- function(x) {
  styles_exist()
  assert(x, 'character')
  tmp <- csl_styles()
  # independent
  c(matchem(x, tmp$independent),
  # dependent
  matchem(x, tmp$dependent, FALSE))
}

matchem <- function(x, y, independent = TRUE) {
  yy <- gsub("-", " ", y)
  mtch <- grep(tolower(x), yy, ignore.case = TRUE)
  if (length(mtch) == 0) return(NULL)
  if (length(mtch) == 1) return(make_path(y[mtch], independent))
  if (length(mtch) > 1) {
    return(vapply(mtch, function(w) make_path(y[w], independent), ""))
  }
}

make_path <- function(x, independent = TRUE) {
  file.path(csl_cache$cache_path_get(), "styles", 
    paste0(if (!independent) "dependent/" else "", x, ".csl"))
}