R/exist_attribute_insights.R

In ebbertd/existR: Read and write data to Exist.io

#' Query Exist.io for all insights for a specific attribute
#'
#' Returns information on all insights for a specific attribute.
#'
#' @return A list containing the information of all insights for a specific attribute.
#' @param token The token environment.
#' @param attribute The attribute for which to get all insights. Defaults to mood.
#' @param limit Number of values to return per page, starting with today. Optional, max is 100.
#' @param page Page index. Optional, default is 1.
#' @param date_min Oldest date (inclusive) of results to be returned, in format YYYY-mm-dd. Optional.
#' @param date_max Most recent date (inclusive) of results to be returned, in format YYYY-mm-dd. Optional.
#' @export
#' @examples
#' \dontrun{
#' etoken <- exist_auth()
#' exist_attribute_insights(etoken)
#' }
exist_attribute_insights <- function(token = NULL, attribute = "mood", limit = NULL, page = 1, date_min = NULL, date_max = NULL) {
  # Set path for query
  path <- paste0("api/1/users/$self/insights/attribute/", attribute, "/")
  query <- list(limit = limit, page = page, date_min = date_min, date_max = date_max)

  # Call wrapper function for query
  exist_package_query(token = token, path = path, query = query)
}

#' Print result of exist_attribute_insights()
#'
#' Print a structured return of the exist_attribute_insights() function.
#'
#' @param x The return of the function this print function relates to.
#' @param ... Possible further options to the print function.
#' @return A structured print of the return by the exist_attribute_insights() function.
#' @seealso \code{\link{exist_attribute_insights}}
#' @importFrom utils str
#' @export
#' @examples
#' \dontrun{
#' resp <- exist_attribute_insights()
#'
#' resp
#' }
print.exist_attribute_insights <- function(x, ...) {
  cat("<Exist ", x$path, ">\n", sep = "")
  str(x$content)
  invisible(x)
}