R/get-version.R

In hrbrmstr/crumpets: Tools to Work with and Manage 'gitea'

#' Returns the version of the Gitea application
#'
#' @md
#' @param api_endpoint URL prefix for your gitea server (no trailing '/')
#' @param gitea_token NOTE: we use `access_token` in the package
#' @return character
#' @export
#' @examples \dontrun{
#' get_version()
#' }
get_version <- function(api_endpoint = Sys.getenv("GITEA_BASE_URL"),
                        gitea_token = Sys.getenv("GITEA_PAT")) {

  api_endpoint <- sub("/$", "", api_endpoint)

  gitea_url <- file.path(api_endpoint, "api/v1", sub("^/", "", "/version"))

  httr::VERB(
    verb = "GET",
    url = gitea_url,
    query = list(access_token = gitea_token),
    encode = "json",
    httr::user_agent("crumpets r package <https://gitlab.com/hrbrmstr/crumpets")
  ) -> res

  httr::stop_for_status(res)

  out <- httr::content(res, as = "text")
  out <- jsonlite::fromJSON(out)

  out$version

}