R/logging.r

In hrbrmstr/jwatr: Tools to Query and Create Web Archive Files Using the Java Web Archive Toolkit

#' @title rJava logging
#' @description Toggle verbose rJava logging
#' @details This function turns off the somewhat verbose rJava logging, most of which is
#'          uninformative. It is called automatically when tabulizer is attached via
#'          \code{library()}, \code{require}, etc. To keep logging on, load the package
#'          namespace using \code{requireNamespace("tabulizer")} and reference functions
#'          in using fully qualified references (e.g., \code{tabulizer::extract_tables()}.
#' @note This resets a global Java setting and may affect logging of other rJava operations,
#'       requiring a restart of R.
#' @return `NULL`, invisibly.
#' @author Thomas J. Leeper <thosjleeper@@gmail.com>
#' @noRd
#' @md
#' @examples
#' \dontrun{
#' stop_logging()
#' }
#' @export
stop_logging <- function() {
    rJava::J("java.util.logging.LogManager")$getLogManager()$reset()
    invisible(NULL)
}