From a7c11d40aa115fa5467e36a5b26b6a892b2c2b05 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 14:23:50 -0700
Subject: [PATCH 01/26] docs: prettify README image

---
 README.md                     |   2 +-
 man/figures/fb-cli-signal.png | Bin 36736 -> 134619 bytes
 2 files changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index cdc64710..6329602c 100644
--- a/README.md
+++ b/README.md
@@ -52,7 +52,7 @@ ggplot(epidata, aes(x = time_value, y = value)) +
        y = "CLI")
 ```
 
-<img src="man/figures/fb-cli-signal.png" style="height:750px; width:750px" alt="Smoothed CLI from Facebook Survey">
+![Alt text](man/figures/fb-cli-signal.png)
 
 ## Installation
 
diff --git a/man/figures/fb-cli-signal.png b/man/figures/fb-cli-signal.png
index 5ad5cc6f4c5c578a76aab5734394134cae590819..dfb1ca4ceb1486e77ea69e2fe02c1c1e67b452a9 100644
GIT binary patch
literal 134619
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%0DG==Qw#)N1j0$ct
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
I&2Iny0aV$z9smFU

literal 36736
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%0A5X4b4lS#Cwh
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
M7PjVR&D^&CAHk6zEC2ui


From 829638d6ce2dcee3828644e817ebda274b8e5565 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 14:50:32 -0700
Subject: [PATCH 02/26] docs: add covidcast blurb, updates, and more to README

---
 README.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 6329602c..b9f61620 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,7 @@
 [![License: MIT][mit-image]][mit-url] [![Github Actions][github-actions-image]][github-actions-url]
 [![codecov](https://codecov.io/gh/dsweber2/epidatr/branch/dev/graph/badge.svg?token=jVHL9eHZNZ)](https://codecov.io/gh/dsweber2/epidatr)
 
-The [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/) provides real-time access to epidemiological surveillance data for influenza, COVID-19, and other diseases from both official government sources such as the [Center for Disease Control (CDC)](https://www.cdc.gov/datastatistics/index.html) and private partners such as [Quidel](https://www.quidel.com/), [Facebook](https://delphi.cmu.edu/blog/2020/08/26/covid-19-symptom-surveys-through-facebook/), and [Change Healthcare](https://www.changehealthcare.com/). It is built and maintained by the Carnegie Mellon University [Delphi research group](https://delphi.cmu.edu/).
+The [Delphi Epidata API](https://cmu-delphi.github.io/delphi-epidata/) provides real-time access to epidemiological surveillance data for influenza, COVID-19, and other diseases from both official government sources such as the [Center for Disease Control (CDC)](https://www.cdc.gov/datastatistics/index.html) and [Google Trends](https://cmu-delphi.github.io/delphi-epidata/api/covidcast-signals/google-symptoms.html) and private partners such as [Facebook](https://delphi.cmu.edu/blog/2020/08/26/covid-19-symptom-surveys-through-facebook/) and [Change Healthcare](https://www.changehealthcare.com/). It is built and maintained by the Carnegie Mellon University [Delphi research group](https://delphi.cmu.edu/).
 
 This package is designed to streamline the downloading and usage of data from the [Delphi Epidata
 API](https://cmu-delphi.github.io/delphi-epidata/). It provides a simple R interface to the API, including functions for downloading data, parsing the results, and converting the data into a tidy format. The API stores a historical record of all data, including corrections and updates, which is particularly useful for accurately backtesting forecasting models. We also provide packages for downstream data processing ([epiprocess](https://github.com/cmu-delphi/epiprocess)) and modeling ([epipredict](https://github.com/cmu-delphi/epipredict)).
@@ -52,7 +52,7 @@ ggplot(epidata, aes(x = time_value, y = value)) +
        y = "CLI")
 ```
 
-![Alt text](man/figures/fb-cli-signal.png)
+![Smoothed CLI from Facebook Survey](man/figures/fb-cli-signal.png)
 
 ## Installation
 
@@ -85,3 +85,11 @@ Note that for the time being, the private endpoints (i.e. those prefixed with
 [mit-url]: https://opensource.org/licenses/MIT
 [github-actions-image]: https://github.com/cmu-delphi/epidatr/workflows/ci/badge.svg
 [github-actions-url]: https://github.com/cmu-delphi/epidatr/actions
+
+## Get updates
+
+You should consider subscribing to the [API mailing list](https://lists.andrew.cmu.edu/mailman/listinfo/delphi-covidcast-api) to be notified of package updates, new data sources, corrections, and other updates.
+
+## For users of the `covidcast` R package
+
+The `epidatr` package is a complete rewrite of the [`covidcast` package](https://cmu-delphi.github.io/covidcast/covidcastR/), with a focus on speed, reliability, and ease of use. The `covidcast` package is deprecated and will no longer be updated.

From f0a7cd453214646b90d8fe84b8750872d4e1f6be Mon Sep 17 00:00:00 2001
From: dsweber2 <david.weber2@pm.me>
Date: Wed, 6 Sep 2023 15:08:35 -0700
Subject: [PATCH 03/26] feat: don't adjust prune, better docs

---
 R/cache.R                   | 15 +++------------
 _pkgdown.yml                |  1 +
 tests/testthat/test-cache.R |  5 ++---
 3 files changed, 6 insertions(+), 15 deletions(-)

diff --git a/R/cache.R b/R/cache.R
index 3cd01222..62738c9b 100644
--- a/R/cache.R
+++ b/R/cache.R
@@ -72,8 +72,7 @@ cache_environ$epidatr_cache <- NULL
 #'   dir = "some/subdir",
 #'   days = 14,
 #'   max_size = 512,
-#'   logfile = "some/subdir/logs.txt",
-#'   prune_rate = 20L
+#'   logfile = "some/subdir/logs.txt"
 #' )
 #' }
 #'
@@ -90,11 +89,6 @@ cache_environ$epidatr_cache <- NULL
 #' @param logfile where cachem's log of transactions is stored, relative to the
 #'   cache directory. By default, it is `"logfile.txt"`. The environmental
 #'   variable is `EPIDATR_CACHE_LOGFILE`.
-#' @param prune_rate how many calls to go between checking if any cache elements
-#'   are too old or if the cache overall is too large. Defaults to `2000L`.
-#'   Since cachem fixes the max time between prune checks to 5 seconds, there's
-#'   little reason to actually change this parameter. Doesn't have a
-#'   corresponding environmental variable.
 #' @param confirm whether to confirm directory creation. default is `TRUE`;
 #'   should only be set in non-interactive scripts
 #' @seealso [clear_cache] to delete the old cache while making a new one,
@@ -107,7 +101,6 @@ set_cache <- function(cache_dir = NULL,
                       days = NULL,
                       max_size = NULL,
                       logfile = NULL,
-                      prune_rate = 2000L,
                       confirm = TRUE) {
   if (is.null(cache_dir) && sessionInfo()$R.version$major >= 4) {
     cache_dir <- Sys.getenv("EPIDATR_CACHE_DIR", unset = tools::R_user_dir("epidatr"))
@@ -129,7 +122,7 @@ set_cache <- function(cache_dir = NULL,
     logfile <- Sys.getenv("EPIDATR_CACHE_LOGFILE", unset = "logfile.txt")
   }
   stopifnot(is.character(logfile))
-  stopifnot(is.numeric(days), is.numeric(max_size), is.integer(prune_rate))
+  stopifnot(is.numeric(days), is.numeric(max_size))
   #
   # make sure that that directory exists and drag the user into that process
   cache_exists <- file.exists(cache_dir)
@@ -171,8 +164,7 @@ set_cache <- function(cache_dir = NULL,
       dir = cache_dir,
       max_size = as.integer(max_size * 1024^2),
       max_age = days * 24 * 60 * 60,
-      logfile = file.path(cache_dir, logfile),
-      prune_rate = prune_rate
+      logfile = file.path(cache_dir, logfile)
     )
   }
 }
@@ -190,7 +182,6 @@ set_cache <- function(cache_dir = NULL,
 #'   days = 14,
 #'   max_size = 512,
 #'   logfile = "some/subdir/logs.txt",
-#'   prune_rate = 20L
 #' )
 #' }
 #' @param disable instead of setting a new cache, disable caching entirely;
diff --git a/_pkgdown.yml b/_pkgdown.yml
index 87c1dde5..abc7c2d3 100644
--- a/_pkgdown.yml
+++ b/_pkgdown.yml
@@ -16,6 +16,7 @@ reference:
       - epirange
       - timeset
   - title: Control Caching behavior
+    desc: configure an optional persistent cache
   - contents:
       - set_cache
       - clear_cache
diff --git a/tests/testthat/test-cache.R b/tests/testthat/test-cache.R
index e06924bd..1ba98e31 100644
--- a/tests/testthat/test-cache.R
+++ b/tests/testthat/test-cache.R
@@ -17,14 +17,12 @@ test_set_cache <- function(cache_dir = new_temp_dir,
                            days = 1,
                            max_size = 1,
                            logfile = "logfile.txt",
-                           prune_rate = 3L,
                            confirm = FALSE) {
   set_cache(
     cache_dir = cache_dir,
     days = days,
     max_size = max_size,
     logfile = logfile,
-    prune_rate = prune_rate,
     confirm = confirm
   )
 }
@@ -41,7 +39,7 @@ test_that("cache set as expected", {
   }
   expect_equal(cache_info()$max_size, 1024^2)
   expect_equal(cache_info()$max_age, 24 * 60 * 60)
-  expect_equal(cache_info()$prune_rate, 3)
+  expect_equal(cache_info()$prune_rate, 20)
   expect_equal(cache_info()$logfile, file.path(new_temp_dir, "logfile.txt"))
   expect_equal(cache_info()$evict, "lru")
   expect_equal(cache_info()$max_n, Inf)
@@ -198,6 +196,7 @@ test_that("check_is_cachable", {
 })
 
 test_set_cache()
+cache_environ$epidatr_cache$prune()
 clear_cache(disable = TRUE)
 rm(new_temp_dir)
 

From 3f7008802331f5b6f135e1ee047542ade623ecfa Mon Sep 17 00:00:00 2001
From: dsweber2 <david.weber2@pm.me>
Date: Wed, 6 Sep 2023 15:13:12 -0700
Subject: [PATCH 04/26] when merged we're at 1.0; David is maintainer

---
 DESCRIPTION | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 441b6139..87103255 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,13 +1,13 @@
 Package: epidatr
 Type: Package
 Title: Client for Delphi's Epidata API
-Version: 0.9.0
+Version: 1.0.0
 Authors@R: 
   c(
-    person("Logan", "Brooks", email = "lcbrooks@andrew.cmu.edu", role = c("aut", "cre")),
+    person("Logan", "Brooks", email = "lcbrooks@andrew.cmu.edu", role = c("aut")),
     person("Dmitry", "Shemetov", email = "dshemeto@andrew.cmu.edu", role = c("aut")),
     person("Samuel", "Gratzl", email = "sam@sgratzl.com", role = c("aut")),
-    person("David", "Weber", email = "davidweb@andrew.cmu.edu", role = c("ctb")),
+    person("David", "Weber", email = "davidweb@andrew.cmu.edu", role = c("ctb", "cre")),
     person("Alex", "Reinhart", role = c("ctb")),
     person("Daniel", "McDonald", role = c("ctb")),
     person("Kean Ming", "Tan", role = c("ctb")),

From f034c02f6d05bdc5a0a8bd9ef5719ac474ee39a1 Mon Sep 17 00:00:00 2001
From: dsweber2 <dsweber2@users.noreply.github.com>
Date: Wed, 6 Sep 2023 22:24:37 +0000
Subject: [PATCH 05/26] docs: document (GHA)

---
 man/clear_cache.Rd     |  1 -
 man/epidatr-package.Rd |  4 ++--
 man/set_cache.Rd       | 10 +---------
 3 files changed, 3 insertions(+), 12 deletions(-)

diff --git a/man/clear_cache.Rd b/man/clear_cache.Rd
index 37b5ac8e..d3c892ad 100644
--- a/man/clear_cache.Rd
+++ b/man/clear_cache.Rd
@@ -25,7 +25,6 @@ clear_cache(
   days = 14,
   max_size = 512,
   logfile = "some/subdir/logs.txt",
-  prune_rate = 20L
 )
 }
 }
diff --git a/man/epidatr-package.Rd b/man/epidatr-package.Rd
index 28d4a660..ae5695fa 100644
--- a/man/epidatr-package.Rd
+++ b/man/epidatr-package.Rd
@@ -18,17 +18,17 @@ Useful links:
 
 }
 \author{
-\strong{Maintainer}: Logan Brooks \email{lcbrooks@andrew.cmu.edu}
+\strong{Maintainer}: David Weber \email{davidweb@andrew.cmu.edu} [contributor]
 
 Authors:
 \itemize{
+  \item Logan Brooks \email{lcbrooks@andrew.cmu.edu}
   \item Dmitry Shemetov \email{dshemeto@andrew.cmu.edu}
   \item Samuel Gratzl \email{sam@sgratzl.com}
 }
 
 Other contributors:
 \itemize{
-  \item David Weber \email{davidweb@andrew.cmu.edu} [contributor]
   \item Alex Reinhart [contributor]
   \item Daniel McDonald [contributor]
   \item Kean Ming Tan [contributor]
diff --git a/man/set_cache.Rd b/man/set_cache.Rd
index 06935aac..cc9bcfa6 100644
--- a/man/set_cache.Rd
+++ b/man/set_cache.Rd
@@ -9,7 +9,6 @@ set_cache(
   days = NULL,
   max_size = NULL,
   logfile = NULL,
-  prune_rate = 2000L,
   confirm = TRUE
 )
 }
@@ -31,12 +30,6 @@ variable is \code{EPIDATR_CACHE_MAX_SIZE_MB}.}
 cache directory. By default, it is \code{"logfile.txt"}. The environmental
 variable is \code{EPIDATR_CACHE_LOGFILE}.}
 
-\item{prune_rate}{how many calls to go between checking if any cache elements
-are too old or if the cache overall is too large. Defaults to \code{2000L}.
-Since cachem fixes the max time between prune checks to 5 seconds, there's
-little reason to actually change this parameter. Doesn't have a
-corresponding environmental variable.}
-
 \item{confirm}{whether to confirm directory creation. default is \code{TRUE};
 should only be set in non-interactive scripts}
 }
@@ -109,8 +102,7 @@ set_cache(
   dir = "some/subdir",
   days = 14,
   max_size = 512,
-  logfile = "some/subdir/logs.txt",
-  prune_rate = 20L
+  logfile = "some/subdir/logs.txt"
 )
 }
 

From 59544c37fed50edbf1053b9a305ea5d9ebe22aa7 Mon Sep 17 00:00:00 2001
From: dsweber2 <david.weber2@pm.me>
Date: Wed, 6 Sep 2023 16:09:53 -0700
Subject: [PATCH 06/26] docs: resembling same format for link

---
 R/endpoints.R | 74 ++++++++++++++++++++++++++++-----------------------
 1 file changed, 41 insertions(+), 33 deletions(-)

diff --git a/R/endpoints.R b/R/endpoints.R
index 17b275b8..4c65e824 100644
--- a/R/endpoints.R
+++ b/R/endpoints.R
@@ -1,5 +1,5 @@
 #' CDC page hits
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/cdc.html>
 #'
 #' @examples
@@ -51,13 +51,14 @@ pvt_cdc <- function(auth, locations, epiweeks, fetch_args = fetch_args_list()) {
 }
 
 #' COVID hospitalization facility identifiers
+#' @description
+#' API docs:
+#' <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility_lookup.html>
 #'
 #' Obtains unique identifiers and other metadata for COVID hospitalization
 #' facilities of interest.
 #' This is a companinon endpoint to the [covid_hosp_facility()] endpoint.
 #'
-#' API docs:
-#' <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility_lookup.html>
 #'
 #' @details Only one argument needs to be specified.
 #' Combinations of the arguments are not currently supported.
@@ -133,14 +134,14 @@ covid_hosp_facility_lookup <- function(
 }
 
 #' COVID hospitalization data for specific facilities
+#' @description
+#' API docs:
+#' <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility.html>
 #'
 #' Obtains the COVID-19 reported patient impact and hospital capacity data by
 #' facility. This dataset is provided by the US Department of Health & Human
 #' Services via healthdata.gov.
 #'
-#' API docs:
-#' <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility.html>
-#'
 #' @details Starting October 1, 2022, some facilities are only required to
 #' report annually. The companion function [covid_hosp_facility_lookup()] can be
 #' used to look up facility identifiers in a variety of ways.
@@ -436,13 +437,13 @@ covid_hosp_facility <- function(
 }
 
 #' COVID Hospitalization Data by State
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp.html>.
 #'
 #' Obtains the COVID-19 reported patient impact and hospital capacity data by
 #' state. This dataset is provided by the US Department of Health & Human
 #' Services via healthdata.gov.
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp.html>.
-#'
 #' @details Starting October 1, 2022, some facilities are only required to
 #' report annually.
 #'
@@ -598,13 +599,14 @@ covid_hosp_state_timeseries <- function(states, dates, ..., issues = NULL, fetch
 }
 
 #' Metadata for covidcast endpoint
+#' @description
+#' API docs:
+#' <https://cmu-delphi.github.io/delphi-epidata/api/covidcast_meta.html>.
 #'
 #' Fetch a summary of metadata for all sources and signals that are available in
 #' the API, along with basic summary statistics such as the dates they are
 #' available, the geographic levels at which they are reported, and etc.
 #'
-#' API docs:
-#' <https://cmu-delphi.github.io/delphi-epidata/api/covidcast_meta.html>.
 #'
 #' @param fetch_args [`fetch_args`]. Additional arguments to pass to `fetch()`.
 #'
@@ -646,7 +648,7 @@ covidcast_meta <- function(fetch_args = fetch_args_list()) {
 }
 
 #' COVID data via the covidcast endpoint
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covidcast.html>
 #'
 #' COVIDcast public dashboard: <https://delphi.cmu.edu/covidcast/>
@@ -783,7 +785,7 @@ covidcast <- function(
 }
 
 #' Delphi's ILINet forecasts
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/delphi.html>
 #'
 #' @examples
@@ -814,7 +816,7 @@ delphi <- function(system, epiweek, fetch_args = fetch_args_list()) {
 }
 
 #' Delphi's PAHO Dengue nowcast
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/dengue_nowcast.html>
 #'
 #' @examples
@@ -848,7 +850,7 @@ dengue_nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list())
 }
 
 #' Dengue digital surveillance sensors in PAHO member countries
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/dengue_sensors.html>
 #'
 #' @examples
@@ -893,11 +895,12 @@ pvt_dengue_sensors <- function(auth, names, locations, epiweeks, fetch_args = fe
 }
 
 #' ECDC ILI data
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/ecdc_ili.html>.
 #'
 #' Obtain information on influenza-like-illness from the European Centre for
 #' Disease Prevention and Control.
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/ecdc_ili.html>.
 #'
 #' @details The list of location argument can be found in
 #' <https://github.com/cmu-delphi/delphi-epidata/blob/main/labels/ecdc_regions.txt>.
@@ -948,11 +951,12 @@ ecdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_ar
 }
 
 #' FluSurv hospitalization data
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/flusurv.html>.
 #'
 #' Obtain information on flu hospitalization rates from the Center of Disease
 #' Control.
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/flusurv.html>.
 #' See also <https://gis.cdc.gov/GRASP/Fluview/FluHospRates.html>.
 #'
 #' @details The list of location argument can be found in
@@ -1009,7 +1013,7 @@ flusurv <- function(locations, epiweeks, ..., issues = NULL, lag = NULL, fetch_a
 }
 
 #' FluView virological data from clinical labs
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview_clinical.html>
 #'
 #' @examples
@@ -1065,7 +1069,7 @@ fluview_clinical <- function(regions, epiweeks, ..., issues = NULL, lag = NULL,
 }
 
 #' FluView metadata
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview_meta.html>
 #' @examples
 #' \dontrun{
@@ -1091,11 +1095,12 @@ fluview_meta <- function(fetch_args = fetch_args_list()) {
 
 
 #' FluView ILINet data
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview.html>. For
 #'
 #' Obtains information on outpatient inluenza-like-illness (ILI) from U.S.
 #'   Outpatient Influenza-like Illness Surveillance Network (ILINet).
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview.html>. For
 #' more information on ILINet, see
 #' <https://gis.cdc.gov/grasp/fluview/fluportaldashboard.html>.
 #'
@@ -1164,11 +1169,12 @@ fluview <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, auth = NU
 }
 
 #' Google Flu Trends data
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/gft.html>
 #'
 #' Obtains estimates of inluenza activity based on volume of certain search
 #' queries from Google.
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/gft.html>
 #'
 #' @details Google has discontinued Flu Trends and this is now a static
 #'   endpoint. Possibile input for locations can be found in
@@ -1205,7 +1211,7 @@ gft <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 }
 
 #' Google Health Trends data
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/ght.html>
 #'
 #' @examples
@@ -1249,7 +1255,7 @@ pvt_ght <- function(auth, locations, epiweeks, query, fetch_args = fetch_args_li
 }
 
 #' KCDC ILI data
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/kcdc_ili.html>
 #'
 #' @examples
@@ -1298,7 +1304,7 @@ kcdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_ar
 }
 
 #' NoroSTAT metadata
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/meta_norostat.html>
 #'
 #' @examples
@@ -1321,7 +1327,7 @@ pvt_meta_norostat <- function(auth, fetch_args = fetch_args_list()) {
 }
 
 #' Api metadata
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/meta.html>
 #'
 #' @param fetch_args [`fetch_args`]. Additional arguments to pass to `fetch()`.
@@ -1334,11 +1340,12 @@ meta <- function(fetch_args = fetch_args_list()) {
 }
 
 #' NIDSS dengue data
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nidss_dengue.html>
 #'
 #' Obtains counts of confirmed dengue cases in Taiwan from Taiwan National
 #' Infectious Disease Statistical System.
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nidss_dengue.html>
 #'
 #' @details Possible location inputs can be found in
 #' <https://github.com/cmu-delphi/delphi-epidata/blob/main/labels/nidss_regions.txt>
@@ -1373,11 +1380,12 @@ nidss_dengue <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 }
 
 #' NIDSS flu data
+#' @description
+#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nidss_flu.html>
 #'
 #' Obtains information on outpatient inluenza-like-illness from Taiwan National
 #' Infectious Disease Statistical System.
 #'
-#' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nidss_flu.html>
 #'
 #' @examples
 #' \dontrun{
@@ -1428,7 +1436,7 @@ nidss_flu <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_a
 
 
 #' NoroSTAT data (point data, no min/max)
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/norostat.html>
 #'
 #' @examples
@@ -1468,7 +1476,7 @@ pvt_norostat <- function(auth, locations, epiweeks, fetch_args = fetch_args_list
 }
 
 #' Delphi's ILI nowcast
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nowcast.html>.
 #'
 #' Obtains information on outpatient inluenza-like-illness (ILI) from Delphi's
@@ -1505,7 +1513,7 @@ nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 }
 
 #' PAHO Dengue data
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/paho_dengue.html>
 #'
 #' @examples
@@ -1556,7 +1564,7 @@ paho_dengue <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch
 }
 
 #' Quidel COVID-19 and influenza testing data
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/quidel.html>
 #'
 #' @examples
@@ -1596,7 +1604,7 @@ pvt_quidel <- function(auth, locations, epiweeks, fetch_args = fetch_args_list()
 }
 
 #' Digital surveillance sensors
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/sensors.html>
 #'
 #' @examples
@@ -1641,7 +1649,7 @@ pvt_sensors <- function(auth, names, locations, epiweeks, fetch_args = fetch_arg
 }
 
 #' HealthTweets data
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/twitter.html>
 #'
 #' @examples
@@ -1697,7 +1705,7 @@ pvt_twitter <- function(auth, locations, ..., dates = NULL, epiweeks = NULL, fet
 }
 
 #' Wikipedia access data
-#'
+#' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/wiki.html>
 #'
 #' ```{r results="asis", echo = FALSE}

From 4646efc944ec50158871855c676eb66fd6e05ac4 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:12:35 -0700
Subject: [PATCH 07/26] fix: avail_endpoints print 50 lines

---
 R/avail_endpoints.R | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/R/avail_endpoints.R b/R/avail_endpoints.R
index a183967c..c65e58e7 100644
--- a/R/avail_endpoints.R
+++ b/R/avail_endpoints.R
@@ -17,5 +17,5 @@ avail_endpoints <- function() {
     Endpoint = paste0(h$Name, "()"),
     Description = h$Title
   )
-  tib
+  tib %>% print(n = 50)
 }

From 1c4d4c112e0ab405fa4baa827d3febb8499fdc8b Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:13:08 -0700
Subject: [PATCH 08/26] docs: capitalize

---
 R/cache.R | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/R/cache.R b/R/cache.R
index 62738c9b..c27c2217 100644
--- a/R/cache.R
+++ b/R/cache.R
@@ -3,7 +3,8 @@
 cache_environ <- new.env(parent = emptyenv())
 cache_environ$use_cache <- NULL
 cache_environ$epidatr_cache <- NULL
-#' create or renew a cache for this session
+
+#' Create or renew a cache for this session
 #' @aliases set_cache
 #' @description
 #' By default, epidatr re-requests data from the API on every call of `fetch`.
@@ -169,7 +170,7 @@ set_cache <- function(cache_dir = NULL,
   }
 }
 
-#' manually reset the cache, deleting all currently saved data and starting afresh
+#' Manually reset the cache, deleting all currently saved data and starting afresh
 #' @description
 #' deletes the current cache and resets a new cache. Deletes local data! If you
 #'   are using a session unique cache, you will have to pass the arguments you
@@ -201,7 +202,7 @@ clear_cache <- function(disable = FALSE, ...) {
   }
 }
 
-#' turn off the caching for this session
+#' Turn off the caching for this session
 #' @description
 #' Disable caching until you call `set_cache` or restart R. The files defining
 #'   the cache are untouched. If you are looking to disable the caching more
@@ -215,7 +216,7 @@ disable_cache <- function() {
   cache_environ$epidatr_cache <- NULL
 }
 
-#' describe current cache
+#' Describe current cache
 #' @description
 #' Print out the information about the cache (as would be returned by cachem's
 #' `info()` method)
@@ -231,7 +232,7 @@ cache_info <- function() {
   }
 }
 
-#' dispatch caching
+#' Dispatch caching
 #'
 #' @description
 #' the guts of caching, its interposed between fetch and the specific fetch

From 94c683aa3eedc51288a63d42a50a349362bc077f Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:13:23 -0700
Subject: [PATCH 09/26] feat: add pub_ to endpoints

---
 R/endpoints.R | 92 +++++++++++++++++++++++++--------------------------
 1 file changed, 46 insertions(+), 46 deletions(-)

diff --git a/R/endpoints.R b/R/endpoints.R
index 4c65e824..1f5e6933 100644
--- a/R/endpoints.R
+++ b/R/endpoints.R
@@ -66,8 +66,8 @@ pvt_cdc <- function(auth, locations, epiweeks, fetch_args = fetch_args_list()) {
 #'
 #' @examples
 #' \dontrun{
-#' covid_hosp_facility_lookup(state = "fl")
-#' covid_hosp_facility_lookup(city = "southlake")
+#' pub_covid_hosp_facility_lookup(state = "fl")
+#' pub_covid_hosp_facility_lookup(city = "southlake")
 #' }
 #' @param ... not used for values, forces later arguments to bind by name
 #' @param state string. A two-letter character state abbreviation.
@@ -78,10 +78,10 @@ pvt_cdc <- function(auth, locations, epiweeks, fetch_args = fetch_args_list()) {
 #' @param fetch_args [`fetch_args`]. Additional arguments to pass to `fetch()`.
 #' @return [`epidata_call`]
 #'
-#' @seealso [covid_hosp_facility()]
+#' @seealso [pub_covid_hosp_facility()]
 #' @keywords endpoint
 #' @export
-covid_hosp_facility_lookup <- function(
+pub_covid_hosp_facility_lookup <- function(
     ...,
     state = NULL,
     ccn = NULL,
@@ -151,7 +151,7 @@ covid_hosp_facility_lookup <- function(
 #'
 #' @examples
 #' \dontrun{
-#' covid_hosp_facility(
+#' pub_covid_hosp_facility(
 #'   hospital_pks = "100075",
 #'   collection_weeks = epirange(20200101, 20200501)
 #' )
@@ -164,11 +164,11 @@ covid_hosp_facility_lookup <- function(
 #' @return [`epidata_call`]
 #'
 #'
-#' @seealso [covid_hosp_facility_lookup()], [epirange()]
+#' @seealso [pub_covid_hosp_facility()], [epirange()]
 #' @keywords endpoint
 #' @export
 #
-covid_hosp_facility <- function(
+pub_covid_hosp_facility <- function(
     hospital_pks,
     collection_weeks,
     ...,
@@ -452,7 +452,7 @@ covid_hosp_facility <- function(
 #'
 #' @examples
 #' \dontrun{
-#' covid_hosp_state_timeseries(
+#' pub_covid_hosp_state_timeseries(
 #'   states = "fl",
 #'   dates = epirange(20200101, 20200501)
 #' )
@@ -469,7 +469,7 @@ covid_hosp_facility <- function(
 #' @keywords endpoint
 #' @export
 #
-covid_hosp_state_timeseries <- function(states, dates, ..., issues = NULL, fetch_args = fetch_args_list()) {
+pub_covid_hosp_state_timeseries <- function(states, dates, ..., issues = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("states", states)
   assert_timeset_param("dates", dates)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -615,13 +615,13 @@ covid_hosp_state_timeseries <- function(states, dates, ..., issues = NULL, fetch
 #'
 #' @examples
 #' \dontrun{
-#' covidcast_meta()
+#' pub_covidcast_meta()
 #' }
 #'
-#' @seealso [covidcast()],[covidcast_epidata()]
+#' @seealso [pub_covidcast()],[covidcast_epidata()]
 #' @keywords endpoint
 #' @export
-covidcast_meta <- function(fetch_args = fetch_args_list()) {
+pub_covidcast_meta <- function(fetch_args = fetch_args_list()) {
   create_epidata_call(
     "covidcast_meta/",
     list(),
@@ -655,7 +655,7 @@ covidcast_meta <- function(fetch_args = fetch_args_list()) {
 #'
 #' @examples
 #' \dontrun{
-#' covidcast(
+#' pub_covidcast(
 #'   source = "jhu-csse",
 #'   signals = "confirmed_7dav_incidence_prop",
 #'   geo_type = "state",
@@ -663,7 +663,7 @@ covidcast_meta <- function(fetch_args = fetch_args_list()) {
 #'   geo_values = "ca,fl",
 #'   time_values = epirange(20200601, 20200801)
 #' )
-#' covidcast(
+#' pub_covidcast(
 #'   source = "jhu-csse",
 #'   signals = "confirmed_7dav_incidence_prop",
 #'   geo_type = "state",
@@ -699,10 +699,10 @@ covidcast_meta <- function(fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #'
 #'
-#' @seealso [covidcast_meta()], [covidcast_epidata()], [epirange()]
+#' @seealso [pub_covidcast_meta()], [covidcast_epidata()], [epirange()]
 #' @keywords endpoint
 #' @export
-covidcast <- function(
+pub_covidcast <- function(
     source,
     signals,
     geo_type,
@@ -790,7 +790,7 @@ covidcast <- function(
 #'
 #' @examples
 #' \dontrun{
-#' delphi(system = "ec", epiweek = 201501)
+#' pub_delphi(system = "ec", epiweek = 201501)
 #' }
 #' @param system character. System name to fetch.
 #' @param epiweek [`timeset`]. Epiweeks to fetch.
@@ -798,7 +798,7 @@ covidcast <- function(
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-delphi <- function(system, epiweek, fetch_args = fetch_args_list()) {
+pub_delphi <- function(system, epiweek, fetch_args = fetch_args_list()) {
   assert_character_param("system", system)
   assert_timeset_param("epiweek", epiweek, len = 1)
   epiweek <- parse_timeset_input(epiweek)
@@ -821,7 +821,7 @@ delphi <- function(system, epiweek, fetch_args = fetch_args_list()) {
 #'
 #' @examples
 #' \dontrun{
-#' dengue_nowcast(
+#' pub_dengue_nowcast(
 #'   locations = "pr",
 #'   epiweeks = epirange(201401, 202301)
 #' )
@@ -832,7 +832,7 @@ delphi <- function(system, epiweek, fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-dengue_nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
+pub_dengue_nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
   assert_character_param("locations", locations)
   assert_timeset_param("epiweeks", epiweeks)
   epiweeks <- parse_timeset_input(epiweeks)
@@ -907,7 +907,7 @@ pvt_dengue_sensors <- function(auth, names, locations, epiweeks, fetch_args = fe
 #'
 #' @examples
 #' \dontrun{
-#' ecdc_ili(regions = "austria", epiweeks = epirange(201901, 202001))
+#' pub_ecdc_ili(regions = "austria", epiweeks = epirange(201901, 202001))
 #' }
 #' @param regions character. Regions to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -920,7 +920,7 @@ pvt_dengue_sensors <- function(auth, names, locations, epiweeks, fetch_args = fe
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-ecdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
+pub_ecdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -964,7 +964,7 @@ ecdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_ar
 #'
 #' @examples
 #' \dontrun{
-#' flusurv(locations = "CA", epiweeks = epirange(201701, 201801))
+#' pub_flusurv(locations = "CA", epiweeks = epirange(201701, 201801))
 #' }
 #' @param locations character. Character vector indicating location.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -977,7 +977,7 @@ ecdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_ar
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-flusurv <- function(locations, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
+pub_flusurv <- function(locations, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("locations", locations)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -1018,7 +1018,7 @@ flusurv <- function(locations, epiweeks, ..., issues = NULL, lag = NULL, fetch_a
 #'
 #' @examples
 #' \dontrun{
-#' fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
+#' pub_fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
 #' }
 #' @param regions character. Regions to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch in the form
@@ -1033,7 +1033,7 @@ flusurv <- function(locations, epiweeks, ..., issues = NULL, lag = NULL, fetch_a
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-fluview_clinical <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
+pub_fluview_clinical <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -1073,7 +1073,7 @@ fluview_clinical <- function(regions, epiweeks, ..., issues = NULL, lag = NULL,
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview_meta.html>
 #' @examples
 #' \dontrun{
-#' fluview_meta()
+#' pub_fluview_meta()
 #' }
 #'
 #' @param fetch_args [`fetch_args`]. Additional arguments to pass to `fetch()`.
@@ -1081,7 +1081,7 @@ fluview_clinical <- function(regions, epiweeks, ..., issues = NULL, lag = NULL,
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-fluview_meta <- function(fetch_args = fetch_args_list()) {
+pub_fluview_meta <- function(fetch_args = fetch_args_list()) {
   create_epidata_call(
     "fluview_meta/",
     list(),
@@ -1108,7 +1108,7 @@ fluview_meta <- function(fetch_args = fetch_args_list()) {
 #'   <https://github.com/cmu-delphi/delphi-epidata/blob/main/src/acquisition/fluview/fluview_locations.py>.
 #'
 #' @examples
-#' fluview(regions = "nat", epiweeks = epirange(201201, 202001))
+#' pub_fluview(regions = "nat", epiweeks = epirange(201201, 202001))
 #' @param regions character. Locations to fetch. Can be any string IDs in
 #'   national, HHS region, census division, most states and territories, and so
 #'   on. Full list link below.
@@ -1126,7 +1126,7 @@ fluview_meta <- function(fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-fluview <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, auth = NULL, fetch_args = fetch_args_list()) {
+pub_fluview <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, auth = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -1185,7 +1185,7 @@ fluview <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, auth = NU
 #'
 #' @examples
 #' \dontrun{
-#' gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
+#' pub_gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
 #' }
 #' @param locations character. Locations to fetch.
 #' @param epiweeks [`timeset`] Epiweeks to fetch.
@@ -1194,7 +1194,7 @@ fluview <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, auth = NU
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-gft <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
+pub_gft <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
   assert_character_param("locations", locations)
   assert_timeset_param("epiweeks", epiweeks)
   epiweeks <- parse_timeset_input(epiweeks)
@@ -1260,7 +1260,7 @@ pvt_ght <- function(auth, locations, epiweeks, query, fetch_args = fetch_args_li
 #'
 #' @examples
 #' \dontrun{
-#' kcdc_ili(regions = "ROK", epiweeks = 200436)
+#' pub_kcdc_ili(regions = "ROK", epiweeks = 200436)
 #' }
 #' @param regions character. Regions to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -1273,7 +1273,7 @@ pvt_ght <- function(auth, locations, epiweeks, query, fetch_args = fetch_args_li
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-kcdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
+pub_kcdc_ili <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -1326,7 +1326,7 @@ pvt_meta_norostat <- function(auth, fetch_args = fetch_args_list()) {
   ) %>% fetch(fetch_args = fetch_args)
 }
 
-#' Api metadata
+#' API metadata
 #' @description
 #' API docs: <https://cmu-delphi.github.io/delphi-epidata/api/meta.html>
 #'
@@ -1335,7 +1335,7 @@ pvt_meta_norostat <- function(auth, fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-meta <- function(fetch_args = fetch_args_list()) {
+pub_meta <- function(fetch_args = fetch_args_list()) {
   create_epidata_call("meta/", list(), only_supports_classic = TRUE) %>% fetch(fetch_args = fetch_args)
 }
 
@@ -1354,7 +1354,7 @@ meta <- function(fetch_args = fetch_args_list()) {
 #'
 #' @examples
 #' \dontrun{
-#' nidss_dengue(locations = "taipei", epiweeks = epirange(201201, 201301))
+#' pub_nidss_dengue(locations = "taipei", epiweeks = epirange(201201, 201301))
 #' }
 #' @param locations character. Locations to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -1363,7 +1363,7 @@ meta <- function(fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-nidss_dengue <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
+pub_nidss_dengue <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
   assert_character_param("locations", locations)
   assert_timeset_param("epiweeks", epiweeks)
   epiweeks <- parse_timeset_input(epiweeks)
@@ -1389,7 +1389,7 @@ nidss_dengue <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 #'
 #' @examples
 #' \dontrun{
-#' nidss_flu(regions = "taipei", epiweeks = epirange(201501, 201601))
+#' pub_nidss_flu(regions = "taipei", epiweeks = epirange(201501, 201601))
 #' }
 #' @param regions character. Regions to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -1402,7 +1402,7 @@ nidss_dengue <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-nidss_flu <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
+pub_nidss_flu <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -1487,7 +1487,7 @@ pvt_norostat <- function(auth, locations, epiweeks, fetch_args = fetch_args_list
 #'
 #' @examples
 #' \dontrun{
-#' nowcast(locations = "ca", epiweeks = epirange(201201, 201301))
+#' pub_nowcast(locations = "ca", epiweeks = epirange(201201, 201301))
 #' }
 #' @param locations character. Locations to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -1495,7 +1495,7 @@ pvt_norostat <- function(auth, locations, epiweeks, fetch_args = fetch_args_list
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
+pub_nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
   assert_character_param("locations", locations)
   assert_timeset_param("epiweeks", epiweeks)
   epiweeks <- parse_timeset_input(epiweeks)
@@ -1518,7 +1518,7 @@ nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 #'
 #' @examples
 #' \dontrun{
-#' paho_dengue(regions = "ca", epiweeks = epirange(201401, 201501))
+#' pub_paho_dengue(regions = "ca", epiweeks = epirange(201401, 201501))
 #' }
 #' @param regions character. Regions to fetch.
 #' @param epiweeks [`timeset`]. Epiweeks to fetch.
@@ -1531,7 +1531,7 @@ nowcast <- function(locations, epiweeks, fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-paho_dengue <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
+pub_paho_dengue <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)
@@ -1717,7 +1717,7 @@ pvt_twitter <- function(auth, locations, ..., dates = NULL, epiweeks = NULL, fet
 #'
 #' @examples
 #' \dontrun{
-#' wiki(articles = "avian_influenza", epiweeks = epirange(201501, 201601))
+#' pub_wiki(articles = "avian_influenza", epiweeks = epirange(201501, 201601))
 #' }
 #' @param articles character. Articles to fetch.
 #' @param ... not used for values, forces later arguments to bind by name
@@ -1730,7 +1730,7 @@ pvt_twitter <- function(auth, locations, ..., dates = NULL, epiweeks = NULL, fet
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-wiki <- function(
+pub_wiki <- function(
     articles,
     ...,
     dates = NULL,

From 3423881180d5d90a7994cd34935e3ac321e8002a Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:13:43 -0700
Subject: [PATCH 10/26] docs: fix some utils

---
 R/model.R | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/R/model.R b/R/model.R
index 650f06f3..92574ae5 100644
--- a/R/model.R
+++ b/R/model.R
@@ -1,16 +1,17 @@
 #' Specify a date range (in days or epiweeks) for an API request.
 #'
-#' Epiweeks, also known as MMWR weeks number the weeks of the year from 1 to 53,
-#' each week spanning from Sunday to Saturday. The numbering is [defined by the
-#' CDC](https://ndc.services.cdc.gov/wp-content/uploads/MMWR_Week_overview.pdf).
-#'
 #' @param from A `Date`, integer-like value, or integer-like string that takes the
 #'   form YYYYMMDD for dates or YYYYWW for epiweeks.
 #' @param to A `Date`, integer-like value, or integer-like string that takes the
 #'  form YYYYMMDD for dates or YYYYWW for epiweeks.
-#' @return EpiRange instance
+#' @return An `EpiRange` object.
 #' @importFrom checkmate check_integerish check_character check_date assert
 #'
+#' @details
+#' Epiweeks, also known as MMWR weeks number the weeks of the year from 1 to 53,
+#' each week spanning from Sunday to Saturday. The numbering is [defined by the
+#' CDC](https://ndc.services.cdc.gov/wp-content/uploads/MMWR_Week_overview.pdf).
+#'
 #' @examples
 #' # Represents 2021-01-01 to 2021-01-07, inclusive
 #' epirange(20210101, 20210107)
@@ -58,7 +59,7 @@ epirange <- function(from, to) {
 }
 
 
-#' timeset
+#' Timeset
 #'
 #' Many API calls accept timesets to specify the time ranges of data being
 #' requested. Timesets can be specified with `epirange()`, as `Date` objects, or
@@ -72,8 +73,8 @@ epirange <- function(from, to) {
 #'   take the form YYYYMMDD.
 #' - Epiweeks: Integer-like values or integer-like strings that take the form
 #'   YYYYWW.
-#' - EpiRanges: A range returned by `epirange()`, or a list of multiple ranges
-#' - Wildcard: The string `"*"`, which request all available time values
+#' - EpiRanges: A range returned by `epirange()`, or a list of multiple ranges.
+#' - Wildcard: The string `"*"`, which request all available time values.
 #'
 #' Please refer to the specific endpoint documentation for guidance on using
 #' dates vs weeks. Most endpoints support only one or the other. Some (less
@@ -152,14 +153,15 @@ parse_data_frame <- function(epidata_call, df, disable_date_parsing = FALSE) {
   df
 }
 
+#' @keywords internal
 parse_api_date <- function(value) {
   as.Date(as.character(value), format = "%Y%m%d")
 }
 
-#' parses a week
 #' @param value value to be converted to an epiweek
 #' @importFrom MMWRweek MMWRweek2Date
 #' @return a date
+#' @keywords internal
 parse_api_week <- function(value) {
   v <- as.integer(value)
   years <- floor(v / 100)
@@ -168,6 +170,7 @@ parse_api_week <- function(value) {
 }
 
 #' @importFrom checkmate test_character test_class test_date test_integerish test_list
+#' @keywords internal
 parse_timeset_input <- function(value) {
   if (is.null(value)) {
     return(NULL)

From eb914beeb860f3df0a17bedf3803b2c33f1fb792 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:50:14 -0700
Subject: [PATCH 11/26] docs: fix cache docs

---
 R/cache.R | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/R/cache.R b/R/cache.R
index c27c2217..ddbd54f6 100644
--- a/R/cache.R
+++ b/R/cache.R
@@ -92,8 +92,8 @@ cache_environ$epidatr_cache <- NULL
 #'   variable is `EPIDATR_CACHE_LOGFILE`.
 #' @param confirm whether to confirm directory creation. default is `TRUE`;
 #'   should only be set in non-interactive scripts
-#' @seealso [clear_cache] to delete the old cache while making a new one,
-#'   [disable_cache] to disable without deleting, and [cache_info]
+#' @seealso [`clear_cache`] to delete the old cache while making a new one,
+#'   [`disable_cache`] to disable without deleting, and [`cache_info`]
 #' @export
 #' @import cachem
 #' @import glue
@@ -172,7 +172,7 @@ set_cache <- function(cache_dir = NULL,
 
 #' Manually reset the cache, deleting all currently saved data and starting afresh
 #' @description
-#' deletes the current cache and resets a new cache. Deletes local data! If you
+#' Deletes the current cache and resets a new cache. Deletes local data! If you
 #'   are using a session unique cache, you will have to pass the arguments you
 #'   used for `set_cache` earlier, otherwise the system-wide `.Renviron`-based
 #'   defaults will be used.
@@ -186,11 +186,10 @@ set_cache <- function(cache_dir = NULL,
 #' )
 #' }
 #' @param disable instead of setting a new cache, disable caching entirely;
-#' defaults to `FALSE`
-#' @param ... see the `set_cache` arguments below
-#' @inheritParams set_cache
-#' @seealso [set_cache] to start a new cache (and general caching info),
-#'   [disable_cache] to only disable without deleting, and [cache_info]
+#'   defaults to `FALSE`
+#' @param ... arguments passed to `set_cache`
+#' @seealso [`set_cache`] to start a new cache (and general caching info),
+#'   [`disable_cache`] to only disable without deleting, and [`cache_info`]
 #' @export
 #' @import cachem
 clear_cache <- function(disable = FALSE, ...) {
@@ -209,8 +208,8 @@ clear_cache <- function(disable = FALSE, ...) {
 #'   permanently, set `EPIDATR_USE_CACHE=FALSE` as environmental variable in
 #'   your `.Renviron`.
 #' @export
-#' @seealso [set_cache] to start a new cache (and general caching info),
-#'   [clear_cache] to delete the cache and set a new one, and [cache_info]
+#' @seealso [`set_cache`] to start a new cache (and general caching info),
+#'   [`clear_cache`] to delete the cache and set a new one, and [`cache_info`]
 #' @import cachem
 disable_cache <- function() {
   cache_environ$epidatr_cache <- NULL
@@ -220,8 +219,8 @@ disable_cache <- function() {
 #' @description
 #' Print out the information about the cache (as would be returned by cachem's
 #' `info()` method)
-#' @seealso [set_cache] to start a new cache (and general caching info),
-#'   [clear_cache] to delete the cache and set a new one, and [disable_cache] to
+#' @seealso [`set_cache`] to start a new cache (and general caching info),
+#'   [`clear_cache`] to delete the cache and set a new one, and [`disable_cache`] to
 #'   disable without deleting
 #' @export
 cache_info <- function() {
@@ -239,7 +238,7 @@ cache_info <- function() {
 #' methods. Internal method only.
 #'
 #' @param call the `epidata_call` object
-#' @param fetch_args the args list for fetch as generated by [fetch_args_list()]
+#' @param fetch_args the args list for fetch as generated by [`fetch_args_list()``]
 #' @keywords internal
 #' @import cachem openssl
 cache_epidata_call <- function(epidata_call, fetch_args = fetch_args_list()) {

From 32db0c3e9599b79cc0877cd227b041c8f594210b Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:50:31 -0700
Subject: [PATCH 12/26] fix: covidcast_epidata tibble

---
 R/covidcast.R | 33 +++++++--------------------------
 1 file changed, 7 insertions(+), 26 deletions(-)

diff --git a/R/covidcast.R b/R/covidcast.R
index b0331e70..3844b079 100644
--- a/R/covidcast.R
+++ b/R/covidcast.R
@@ -24,7 +24,7 @@ parse_signal <- function(signal, base_url) {
                           fetch_args = fetch_args_list()) {
     stopifnot(is.character(geo_type) & length(geo_type) == 1)
 
-    covidcast(
+    pub_covidcast(
       source = signal$source,
       signals = signal$signal,
       geo_type = geo_type,
@@ -77,34 +77,15 @@ as_tibble.covidcast_data_signal_list <- function(x, ...) {
   tib$format <- unname(map_chr(x, "format"))
   tib$category <- unname(map_chr(x, "category"))
   tib$high_values_are <- unname(map_chr(x, "high_values_are"))
-  if ("is_smoothed" %in% names(x)) {
-    tib$is_smoothed <- unname(map_lgl(x, "is_smoothed"))
-  } else {
-    tib$is_smoothed <- NA
-  }
-  if ("is_weighted" %in% names(x)) {
-    tib$is_weighted <- unname(map_lgl(x, "is_weighted"))
-  } else {
-    tib$is_weighted <- NA
-  }
-  if ("is_cumulative" %in% names(x)) {
-    tib$is_cumulative <- unname(map_lgl(x, "is_cumulative"))
-  } else {
-    tib$is_cumulative <- NA
-  }
-  if ("has_stderr" %in% names(x)) {
-    tib$has_stderr <- unname(map_lgl(x, "has_stderr"))
-  } else {
-    tib$has_stderr <- NA
-  }
-  if ("has_sample_size" %in% names(x)) {
-    tib$has_sample_size <- unname(map_lgl(x, "has_sample_size"))
-  } else {
-    tib$has_sample_size <- NA
-  }
   as_tibble(tib)
 }
 
+#' @export
+print.covidcast_data_signal_list <- function(x, ...) {
+  tib <- as_tibble(x)
+  print(tib[, c("source", "signal", "short_description")], ...)
+}
+
 #' @export
 print.covidcast_data_source <- function(x, ...) {
   print(x$name, ...)

From 684f837ce373aad71e29da1f225db90ce728a322 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:50:46 -0700
Subject: [PATCH 13/26] fix: example covidcast call

---
 R/epidatacall.R | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/R/epidatacall.R b/R/epidatacall.R
index 67e0a364..5f558ee4 100644
--- a/R/epidatacall.R
+++ b/R/epidatacall.R
@@ -20,7 +20,7 @@
 #'
 #' @examples
 #' \dontrun{
-#' call <- covidcast(
+#' call <- pub_covidcast(
 #'   source = "jhu-csse",
 #'   signals = "confirmed_7dav_incidence_prop",
 #'   time_type = "day",

From d6a7f8a392d3c85956308a35d348e1a188f4d440 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:50:59 -0700
Subject: [PATCH 14/26] docs: parse_api_week docstring

---
 R/model.R | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/R/model.R b/R/model.R
index 92574ae5..1ea606c2 100644
--- a/R/model.R
+++ b/R/model.R
@@ -158,9 +158,10 @@ parse_api_date <- function(value) {
   as.Date(as.character(value), format = "%Y%m%d")
 }
 
+#' parse_api_week converts an integer to a date
 #' @param value value to be converted to an epiweek
-#' @importFrom MMWRweek MMWRweek2Date
 #' @return a date
+#' @importFrom MMWRweek MMWRweek2Date
 #' @keywords internal
 parse_api_week <- function(value) {
   v <- as.integer(value)

From 84ab63ee303700420d5f029a6a62555de08f176c Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 15:51:21 -0700
Subject: [PATCH 15/26] docs: document

---
 NAMESPACE                                     | 41 ++++++++++---------
 man/cache_epidata_call.Rd                     |  4 +-
 man/cache_info.Rd                             |  6 +--
 man/clear_cache.Rd                            | 10 ++---
 man/disable_cache.Rd                          |  6 +--
 man/epidata_call.Rd                           |  2 +-
 man/epirange.Rd                               |  5 ++-
 man/parse_api_week.Rd                         |  5 ++-
 ...facility.Rd => pub_covid_hosp_facility.Rd} | 10 ++---
 ...p.Rd => pub_covid_hosp_facility_lookup.Rd} | 12 +++---
 ....Rd => pub_covid_hosp_state_timeseries.Rd} |  8 ++--
 man/{covidcast.Rd => pub_covidcast.Rd}        | 12 +++---
 ...ovidcast_meta.Rd => pub_covidcast_meta.Rd} | 10 ++---
 man/{delphi.Rd => pub_delphi.Rd}              |  8 ++--
 ...engue_nowcast.Rd => pub_dengue_nowcast.Rd} |  8 ++--
 man/{ecdc_ili.Rd => pub_ecdc_ili.Rd}          |  8 ++--
 man/{flusurv.Rd => pub_flusurv.Rd}            |  8 ++--
 man/{fluview.Rd => pub_fluview.Rd}            |  8 ++--
 ...ew_clinical.Rd => pub_fluview_clinical.Rd} |  8 ++--
 man/{fluview_meta.Rd => pub_fluview_meta.Rd}  |  8 ++--
 man/{gft.Rd => pub_gft.Rd}                    |  8 ++--
 man/{kcdc_ili.Rd => pub_kcdc_ili.Rd}          |  8 ++--
 man/{meta.Rd => pub_meta.Rd}                  |  8 ++--
 man/{nidss_dengue.Rd => pub_nidss_dengue.Rd}  |  8 ++--
 man/{nidss_flu.Rd => pub_nidss_flu.Rd}        |  8 ++--
 man/{nowcast.Rd => pub_nowcast.Rd}            |  8 ++--
 man/{paho_dengue.Rd => pub_paho_dengue.Rd}    |  8 ++--
 man/{wiki.Rd => pub_wiki.Rd}                  |  8 ++--
 man/set_cache.Rd                              |  6 +--
 man/timeset.Rd                                |  6 +--
 30 files changed, 134 insertions(+), 129 deletions(-)
 rename man/{covid_hosp_facility.Rd => pub_covid_hosp_facility.Rd} (87%)
 rename man/{covid_hosp_facility_lookup.Rd => pub_covid_hosp_facility_lookup.Rd} (82%)
 rename man/{covid_hosp_state_timeseries.Rd => pub_covid_hosp_state_timeseries.Rd} (89%)
 rename man/{covidcast.Rd => pub_covidcast.Rd} (91%)
 rename man/{covidcast_meta.Rd => pub_covidcast_meta.Rd} (74%)
 rename man/{delphi.Rd => pub_delphi.Rd} (78%)
 rename man/{dengue_nowcast.Rd => pub_dengue_nowcast.Rd} (80%)
 rename man/{ecdc_ili.Rd => pub_ecdc_ili.Rd} (90%)
 rename man/{flusurv.Rd => pub_flusurv.Rd} (91%)
 rename man/{fluview.Rd => pub_fluview.Rd} (93%)
 rename man/{fluview_clinical.Rd => pub_fluview_clinical.Rd} (88%)
 rename man/{fluview_meta.Rd => pub_fluview_meta.Rd} (77%)
 rename man/{gft.Rd => pub_gft.Rd} (86%)
 rename man/{kcdc_ili.Rd => pub_kcdc_ili.Rd} (90%)
 rename man/{meta.Rd => pub_meta.Rd} (78%)
 rename man/{nidss_dengue.Rd => pub_nidss_dengue.Rd} (81%)
 rename man/{nidss_flu.Rd => pub_nidss_flu.Rd} (89%)
 rename man/{nowcast.Rd => pub_nowcast.Rd} (82%)
 rename man/{paho_dengue.Rd => pub_paho_dengue.Rd} (88%)
 rename man/{wiki.Rd => pub_wiki.Rd} (96%)

diff --git a/NAMESPACE b/NAMESPACE
index d15f33e5..9d39a295 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -3,6 +3,7 @@
 S3method(as_tibble,covidcast_data_signal_list)
 S3method(as_tibble,covidcast_data_source_list)
 S3method(print,covidcast_data_signal)
+S3method(print,covidcast_data_signal_list)
 S3method(print,covidcast_data_source)
 S3method(print,covidcast_epidata)
 S3method(print,epidata_call)
@@ -10,31 +11,32 @@ export("%>%")
 export(avail_endpoints)
 export(cache_info)
 export(clear_cache)
-export(covid_hosp_facility)
-export(covid_hosp_facility_lookup)
-export(covid_hosp_state_timeseries)
-export(covidcast)
 export(covidcast_epidata)
-export(covidcast_meta)
-export(delphi)
-export(dengue_nowcast)
 export(disable_cache)
-export(ecdc_ili)
 export(epirange)
 export(fetch)
 export(fetch_args_list)
-export(flusurv)
-export(fluview)
-export(fluview_clinical)
-export(fluview_meta)
 export(get_auth_key)
-export(gft)
-export(kcdc_ili)
-export(meta)
-export(nidss_dengue)
-export(nidss_flu)
-export(nowcast)
-export(paho_dengue)
+export(pub_covid_hosp_facility)
+export(pub_covid_hosp_facility_lookup)
+export(pub_covid_hosp_state_timeseries)
+export(pub_covidcast)
+export(pub_covidcast_meta)
+export(pub_delphi)
+export(pub_dengue_nowcast)
+export(pub_ecdc_ili)
+export(pub_flusurv)
+export(pub_fluview)
+export(pub_fluview_clinical)
+export(pub_fluview_meta)
+export(pub_gft)
+export(pub_kcdc_ili)
+export(pub_meta)
+export(pub_nidss_dengue)
+export(pub_nidss_flu)
+export(pub_nowcast)
+export(pub_paho_dengue)
+export(pub_wiki)
 export(pvt_cdc)
 export(pvt_dengue_sensors)
 export(pvt_ght)
@@ -44,7 +46,6 @@ export(pvt_quidel)
 export(pvt_sensors)
 export(pvt_twitter)
 export(set_cache)
-export(wiki)
 import(cachem)
 import(glue)
 import(openssl)
diff --git a/man/cache_epidata_call.Rd b/man/cache_epidata_call.Rd
index ecdc0c97..60a86ff6 100644
--- a/man/cache_epidata_call.Rd
+++ b/man/cache_epidata_call.Rd
@@ -2,12 +2,12 @@
 % Please edit documentation in R/cache.R
 \name{cache_epidata_call}
 \alias{cache_epidata_call}
-\title{dispatch caching}
+\title{Dispatch caching}
 \usage{
 cache_epidata_call(epidata_call, fetch_args = fetch_args_list())
 }
 \arguments{
-\item{fetch_args}{the args list for fetch as generated by \code{\link[=fetch_args_list]{fetch_args_list()}}}
+\item{fetch_args}{the args list for fetch as generated by \link{`fetch_args_list()``}}
 
 \item{call}{the \code{epidata_call} object}
 }
diff --git a/man/cache_info.Rd b/man/cache_info.Rd
index 729ff756..418a0389 100644
--- a/man/cache_info.Rd
+++ b/man/cache_info.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/cache.R
 \name{cache_info}
 \alias{cache_info}
-\title{describe current cache}
+\title{Describe current cache}
 \usage{
 cache_info()
 }
@@ -11,7 +11,7 @@ Print out the information about the cache (as would be returned by cachem's
 \code{info()} method)
 }
 \seealso{
-\link{set_cache} to start a new cache (and general caching info),
-\link{clear_cache} to delete the cache and set a new one, and \link{disable_cache} to
+\code{\link{set_cache}} to start a new cache (and general caching info),
+\code{\link{clear_cache}} to delete the cache and set a new one, and \code{\link{disable_cache}} to
 disable without deleting
 }
diff --git a/man/clear_cache.Rd b/man/clear_cache.Rd
index d3c892ad..7e938b9b 100644
--- a/man/clear_cache.Rd
+++ b/man/clear_cache.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/cache.R
 \name{clear_cache}
 \alias{clear_cache}
-\title{manually reset the cache, deleting all currently saved data and starting afresh}
+\title{Manually reset the cache, deleting all currently saved data and starting afresh}
 \usage{
 clear_cache(disable = FALSE, ...)
 }
@@ -10,10 +10,10 @@ clear_cache(disable = FALSE, ...)
 \item{disable}{instead of setting a new cache, disable caching entirely;
 defaults to \code{FALSE}}
 
-\item{...}{see the \code{set_cache} arguments below}
+\item{...}{arguments passed to \code{set_cache}}
 }
 \description{
-deletes the current cache and resets a new cache. Deletes local data! If you
+Deletes the current cache and resets a new cache. Deletes local data! If you
 are using a session unique cache, you will have to pass the arguments you
 used for \code{set_cache} earlier, otherwise the system-wide \code{.Renviron}-based
 defaults will be used.
@@ -29,6 +29,6 @@ clear_cache(
 }
 }
 \seealso{
-\link{set_cache} to start a new cache (and general caching info),
-\link{disable_cache} to only disable without deleting, and \link{cache_info}
+\code{\link{set_cache}} to start a new cache (and general caching info),
+\code{\link{disable_cache}} to only disable without deleting, and \code{\link{cache_info}}
 }
diff --git a/man/disable_cache.Rd b/man/disable_cache.Rd
index 5ca72617..580c30dd 100644
--- a/man/disable_cache.Rd
+++ b/man/disable_cache.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/cache.R
 \name{disable_cache}
 \alias{disable_cache}
-\title{turn off the caching for this session}
+\title{Turn off the caching for this session}
 \usage{
 disable_cache()
 }
@@ -13,6 +13,6 @@ permanently, set \code{EPIDATR_USE_CACHE=FALSE} as environmental variable in
 your \code{.Renviron}.
 }
 \seealso{
-\link{set_cache} to start a new cache (and general caching info),
-\link{clear_cache} to delete the cache and set a new one, and \link{cache_info}
+\code{\link{set_cache}} to start a new cache (and general caching info),
+\code{\link{clear_cache}} to delete the cache and set a new one, and \code{\link{cache_info}}
 }
diff --git a/man/epidata_call.Rd b/man/epidata_call.Rd
index 00fa0fe0..456cc97c 100644
--- a/man/epidata_call.Rd
+++ b/man/epidata_call.Rd
@@ -59,7 +59,7 @@ In that case a JSON-like nested list structure is returned instead.
 }
 \examples{
 \dontrun{
-call <- covidcast(
+call <- pub_covidcast(
   source = "jhu-csse",
   signals = "confirmed_7dav_incidence_prop",
   time_type = "day",
diff --git a/man/epirange.Rd b/man/epirange.Rd
index e1732122..921644c3 100644
--- a/man/epirange.Rd
+++ b/man/epirange.Rd
@@ -14,9 +14,12 @@ form YYYYMMDD for dates or YYYYWW for epiweeks.}
 form YYYYMMDD for dates or YYYYWW for epiweeks.}
 }
 \value{
-EpiRange instance
+An \code{EpiRange} object.
 }
 \description{
+Specify a date range (in days or epiweeks) for an API request.
+}
+\details{
 Epiweeks, also known as MMWR weeks number the weeks of the year from 1 to 53,
 each week spanning from Sunday to Saturday. The numbering is \href{https://ndc.services.cdc.gov/wp-content/uploads/MMWR_Week_overview.pdf}{defined by the CDC}.
 }
diff --git a/man/parse_api_week.Rd b/man/parse_api_week.Rd
index 119eb709..a877d210 100644
--- a/man/parse_api_week.Rd
+++ b/man/parse_api_week.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/model.R
 \name{parse_api_week}
 \alias{parse_api_week}
-\title{parses a week}
+\title{parse_api_week converts an integer to a date}
 \usage{
 parse_api_week(value)
 }
@@ -13,5 +13,6 @@ parse_api_week(value)
 a date
 }
 \description{
-parses a week
+parse_api_week converts an integer to a date
 }
+\keyword{internal}
diff --git a/man/covid_hosp_facility.Rd b/man/pub_covid_hosp_facility.Rd
similarity index 87%
rename from man/covid_hosp_facility.Rd
rename to man/pub_covid_hosp_facility.Rd
index f7f5a8ed..edabb8eb 100644
--- a/man/covid_hosp_facility.Rd
+++ b/man/pub_covid_hosp_facility.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{covid_hosp_facility}
-\alias{covid_hosp_facility}
+\name{pub_covid_hosp_facility}
+\alias{pub_covid_hosp_facility}
 \title{COVID hospitalization data for specific facilities}
 \usage{
-covid_hosp_facility(
+pub_covid_hosp_facility(
   hospital_pks,
   collection_weeks,
   ...,
@@ -44,13 +44,13 @@ more information.
 }
 \examples{
 \dontrun{
-covid_hosp_facility(
+pub_covid_hosp_facility(
   hospital_pks = "100075",
   collection_weeks = epirange(20200101, 20200501)
 )
 }
 }
 \seealso{
-\code{\link[=covid_hosp_facility_lookup]{covid_hosp_facility_lookup()}}, \code{\link[=epirange]{epirange()}}
+\code{\link[=pub_covid_hosp_facility]{pub_covid_hosp_facility()}}, \code{\link[=epirange]{epirange()}}
 }
 \keyword{endpoint}
diff --git a/man/covid_hosp_facility_lookup.Rd b/man/pub_covid_hosp_facility_lookup.Rd
similarity index 82%
rename from man/covid_hosp_facility_lookup.Rd
rename to man/pub_covid_hosp_facility_lookup.Rd
index 6e5524d7..12b7fccb 100644
--- a/man/covid_hosp_facility_lookup.Rd
+++ b/man/pub_covid_hosp_facility_lookup.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{covid_hosp_facility_lookup}
-\alias{covid_hosp_facility_lookup}
+\name{pub_covid_hosp_facility_lookup}
+\alias{pub_covid_hosp_facility_lookup}
 \title{COVID hospitalization facility identifiers}
 \usage{
-covid_hosp_facility_lookup(
+pub_covid_hosp_facility_lookup(
   ...,
   state = NULL,
   ccn = NULL,
@@ -47,11 +47,11 @@ For instance, specifying both city and state are not supported.
 }
 \examples{
 \dontrun{
-covid_hosp_facility_lookup(state = "fl")
-covid_hosp_facility_lookup(city = "southlake")
+pub_covid_hosp_facility_lookup(state = "fl")
+pub_covid_hosp_facility_lookup(city = "southlake")
 }
 }
 \seealso{
-\code{\link[=covid_hosp_facility]{covid_hosp_facility()}}
+\code{\link[=pub_covid_hosp_facility]{pub_covid_hosp_facility()}}
 }
 \keyword{endpoint}
diff --git a/man/covid_hosp_state_timeseries.Rd b/man/pub_covid_hosp_state_timeseries.Rd
similarity index 89%
rename from man/covid_hosp_state_timeseries.Rd
rename to man/pub_covid_hosp_state_timeseries.Rd
index 57913518..de13a690 100644
--- a/man/covid_hosp_state_timeseries.Rd
+++ b/man/pub_covid_hosp_state_timeseries.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{covid_hosp_state_timeseries}
-\alias{covid_hosp_state_timeseries}
+\name{pub_covid_hosp_state_timeseries}
+\alias{pub_covid_hosp_state_timeseries}
 \title{COVID Hospitalization Data by State}
 \usage{
-covid_hosp_state_timeseries(
+pub_covid_hosp_state_timeseries(
   states,
   dates,
   ...,
@@ -43,7 +43,7 @@ more information.
 }
 \examples{
 \dontrun{
-covid_hosp_state_timeseries(
+pub_covid_hosp_state_timeseries(
   states = "fl",
   dates = epirange(20200101, 20200501)
 )
diff --git a/man/covidcast.Rd b/man/pub_covidcast.Rd
similarity index 91%
rename from man/covidcast.Rd
rename to man/pub_covidcast.Rd
index 35c6c315..5775feef 100644
--- a/man/covidcast.Rd
+++ b/man/pub_covidcast.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{covidcast}
-\alias{covidcast}
+\name{pub_covidcast}
+\alias{pub_covidcast}
 \title{COVID data via the covidcast endpoint}
 \usage{
-covidcast(
+pub_covidcast(
   source,
   signals,
   geo_type,
@@ -64,7 +64,7 @@ COVIDcast public dashboard: \url{https://delphi.cmu.edu/covidcast/}
 }
 \examples{
 \dontrun{
-covidcast(
+pub_covidcast(
   source = "jhu-csse",
   signals = "confirmed_7dav_incidence_prop",
   geo_type = "state",
@@ -72,7 +72,7 @@ covidcast(
   geo_values = "ca,fl",
   time_values = epirange(20200601, 20200801)
 )
-covidcast(
+pub_covidcast(
   source = "jhu-csse",
   signals = "confirmed_7dav_incidence_prop",
   geo_type = "state",
@@ -84,6 +84,6 @@ covidcast(
 
 }
 \seealso{
-\code{\link[=covidcast_meta]{covidcast_meta()}}, \code{\link[=covidcast_epidata]{covidcast_epidata()}}, \code{\link[=epirange]{epirange()}}
+\code{\link[=pub_covidcast_meta]{pub_covidcast_meta()}}, \code{\link[=covidcast_epidata]{covidcast_epidata()}}, \code{\link[=epirange]{epirange()}}
 }
 \keyword{endpoint}
diff --git a/man/covidcast_meta.Rd b/man/pub_covidcast_meta.Rd
similarity index 74%
rename from man/covidcast_meta.Rd
rename to man/pub_covidcast_meta.Rd
index 67a8843a..75c42c69 100644
--- a/man/covidcast_meta.Rd
+++ b/man/pub_covidcast_meta.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{covidcast_meta}
-\alias{covidcast_meta}
+\name{pub_covidcast_meta}
+\alias{pub_covidcast_meta}
 \title{Metadata for covidcast endpoint}
 \usage{
-covidcast_meta(fetch_args = fetch_args_list())
+pub_covidcast_meta(fetch_args = fetch_args_list())
 }
 \arguments{
 \item{fetch_args}{\code{\link{fetch_args}}. Additional arguments to pass to \code{fetch()}.}
@@ -23,11 +23,11 @@ API docs:
 }
 \examples{
 \dontrun{
-covidcast_meta()
+pub_covidcast_meta()
 }
 
 }
 \seealso{
-\code{\link[=covidcast]{covidcast()}},\code{\link[=covidcast_epidata]{covidcast_epidata()}}
+\code{\link[=pub_covidcast]{pub_covidcast()}},\code{\link[=covidcast_epidata]{covidcast_epidata()}}
 }
 \keyword{endpoint}
diff --git a/man/delphi.Rd b/man/pub_delphi.Rd
similarity index 78%
rename from man/delphi.Rd
rename to man/pub_delphi.Rd
index e7ec6e1b..b877b38d 100644
--- a/man/delphi.Rd
+++ b/man/pub_delphi.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{delphi}
-\alias{delphi}
+\name{pub_delphi}
+\alias{pub_delphi}
 \title{Delphi's ILINet forecasts}
 \usage{
-delphi(system, epiweek, fetch_args = fetch_args_list())
+pub_delphi(system, epiweek, fetch_args = fetch_args_list())
 }
 \arguments{
 \item{system}{character. System name to fetch.}
@@ -21,7 +21,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/delphi.html}
 }
 \examples{
 \dontrun{
-delphi(system = "ec", epiweek = 201501)
+pub_delphi(system = "ec", epiweek = 201501)
 }
 }
 \keyword{endpoint}
diff --git a/man/dengue_nowcast.Rd b/man/pub_dengue_nowcast.Rd
similarity index 80%
rename from man/dengue_nowcast.Rd
rename to man/pub_dengue_nowcast.Rd
index 9eabe210..b2c6cb24 100644
--- a/man/dengue_nowcast.Rd
+++ b/man/pub_dengue_nowcast.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{dengue_nowcast}
-\alias{dengue_nowcast}
+\name{pub_dengue_nowcast}
+\alias{pub_dengue_nowcast}
 \title{Delphi's PAHO Dengue nowcast}
 \usage{
-dengue_nowcast(locations, epiweeks, fetch_args = fetch_args_list())
+pub_dengue_nowcast(locations, epiweeks, fetch_args = fetch_args_list())
 }
 \arguments{
 \item{locations}{character. Locations to fetch.}
@@ -21,7 +21,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/dengue_nowcast.ht
 }
 \examples{
 \dontrun{
-dengue_nowcast(
+pub_dengue_nowcast(
   locations = "pr",
   epiweeks = epirange(201401, 202301)
 )
diff --git a/man/ecdc_ili.Rd b/man/pub_ecdc_ili.Rd
similarity index 90%
rename from man/ecdc_ili.Rd
rename to man/pub_ecdc_ili.Rd
index ff88906a..2dd26bcb 100644
--- a/man/ecdc_ili.Rd
+++ b/man/pub_ecdc_ili.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{ecdc_ili}
-\alias{ecdc_ili}
+\name{pub_ecdc_ili}
+\alias{pub_ecdc_ili}
 \title{ECDC ILI data}
 \usage{
-ecdc_ili(
+pub_ecdc_ili(
   regions,
   epiweeks,
   ...,
@@ -43,7 +43,7 @@ The list of location argument can be found in
 }
 \examples{
 \dontrun{
-ecdc_ili(regions = "austria", epiweeks = epirange(201901, 202001))
+pub_ecdc_ili(regions = "austria", epiweeks = epirange(201901, 202001))
 }
 }
 \keyword{endpoint}
diff --git a/man/flusurv.Rd b/man/pub_flusurv.Rd
similarity index 91%
rename from man/flusurv.Rd
rename to man/pub_flusurv.Rd
index 6e469591..caa6e3e2 100644
--- a/man/flusurv.Rd
+++ b/man/pub_flusurv.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{flusurv}
-\alias{flusurv}
+\name{pub_flusurv}
+\alias{pub_flusurv}
 \title{FluSurv hospitalization data}
 \usage{
-flusurv(
+pub_flusurv(
   locations,
   epiweeks,
   ...,
@@ -44,7 +44,7 @@ The list of location argument can be found in
 }
 \examples{
 \dontrun{
-flusurv(locations = "CA", epiweeks = epirange(201701, 201801))
+pub_flusurv(locations = "CA", epiweeks = epirange(201701, 201801))
 }
 }
 \keyword{endpoint}
diff --git a/man/fluview.Rd b/man/pub_fluview.Rd
similarity index 93%
rename from man/fluview.Rd
rename to man/pub_fluview.Rd
index 561c17df..389ff92c 100644
--- a/man/fluview.Rd
+++ b/man/pub_fluview.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{fluview}
-\alias{fluview}
+\name{pub_fluview}
+\alias{pub_fluview}
 \title{FluView ILINet data}
 \usage{
-fluview(
+pub_fluview(
   regions,
   epiweeks,
   ...,
@@ -52,6 +52,6 @@ The full list of location inputs can be accsssed at
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/src/acquisition/fluview/fluview_locations.py}.
 }
 \examples{
-fluview(regions = "nat", epiweeks = epirange(201201, 202001))
+pub_fluview(regions = "nat", epiweeks = epirange(201201, 202001))
 }
 \keyword{endpoint}
diff --git a/man/fluview_clinical.Rd b/man/pub_fluview_clinical.Rd
similarity index 88%
rename from man/fluview_clinical.Rd
rename to man/pub_fluview_clinical.Rd
index 906759cb..edfb096a 100644
--- a/man/fluview_clinical.Rd
+++ b/man/pub_fluview_clinical.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{fluview_clinical}
-\alias{fluview_clinical}
+\name{pub_fluview_clinical}
+\alias{pub_fluview_clinical}
 \title{FluView virological data from clinical labs}
 \usage{
-fluview_clinical(
+pub_fluview_clinical(
   regions,
   epiweeks,
   ...,
@@ -38,7 +38,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/fluview_clinical.
 }
 \examples{
 \dontrun{
-fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
+pub_fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
 }
 }
 \keyword{endpoint}
diff --git a/man/fluview_meta.Rd b/man/pub_fluview_meta.Rd
similarity index 77%
rename from man/fluview_meta.Rd
rename to man/pub_fluview_meta.Rd
index 34764ae0..31beec17 100644
--- a/man/fluview_meta.Rd
+++ b/man/pub_fluview_meta.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{fluview_meta}
-\alias{fluview_meta}
+\name{pub_fluview_meta}
+\alias{pub_fluview_meta}
 \title{FluView metadata}
 \usage{
-fluview_meta(fetch_args = fetch_args_list())
+pub_fluview_meta(fetch_args = fetch_args_list())
 }
 \arguments{
 \item{fetch_args}{\code{\link{fetch_args}}. Additional arguments to pass to \code{fetch()}.}
@@ -17,7 +17,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/fluview_meta.html
 }
 \examples{
 \dontrun{
-fluview_meta()
+pub_fluview_meta()
 }
 
 }
diff --git a/man/gft.Rd b/man/pub_gft.Rd
similarity index 86%
rename from man/gft.Rd
rename to man/pub_gft.Rd
index 288ba54c..a3d23fb5 100644
--- a/man/gft.Rd
+++ b/man/pub_gft.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{gft}
-\alias{gft}
+\name{pub_gft}
+\alias{pub_gft}
 \title{Google Flu Trends data}
 \usage{
-gft(locations, epiweeks, fetch_args = fetch_args_list())
+pub_gft(locations, epiweeks, fetch_args = fetch_args_list())
 }
 \arguments{
 \item{locations}{character. Locations to fetch.}
@@ -32,7 +32,7 @@ and
 }
 \examples{
 \dontrun{
-gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
+pub_gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
 }
 }
 \keyword{endpoint}
diff --git a/man/kcdc_ili.Rd b/man/pub_kcdc_ili.Rd
similarity index 90%
rename from man/kcdc_ili.Rd
rename to man/pub_kcdc_ili.Rd
index 02fb0190..5dd8453f 100644
--- a/man/kcdc_ili.Rd
+++ b/man/pub_kcdc_ili.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{kcdc_ili}
-\alias{kcdc_ili}
+\name{pub_kcdc_ili}
+\alias{pub_kcdc_ili}
 \title{KCDC ILI data}
 \usage{
-kcdc_ili(
+pub_kcdc_ili(
   regions,
   epiweeks,
   ...,
@@ -36,7 +36,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/kcdc_ili.html}
 }
 \examples{
 \dontrun{
-kcdc_ili(regions = "ROK", epiweeks = 200436)
+pub_kcdc_ili(regions = "ROK", epiweeks = 200436)
 }
 }
 \keyword{endpoint}
diff --git a/man/meta.Rd b/man/pub_meta.Rd
similarity index 78%
rename from man/meta.Rd
rename to man/pub_meta.Rd
index a5919137..46be9d86 100644
--- a/man/meta.Rd
+++ b/man/pub_meta.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{meta}
-\alias{meta}
-\title{Api metadata}
+\name{pub_meta}
+\alias{pub_meta}
+\title{API metadata}
 \usage{
-meta(fetch_args = fetch_args_list())
+pub_meta(fetch_args = fetch_args_list())
 }
 \arguments{
 \item{fetch_args}{\code{\link{fetch_args}}. Additional arguments to pass to \code{fetch()}.}
diff --git a/man/nidss_dengue.Rd b/man/pub_nidss_dengue.Rd
similarity index 81%
rename from man/nidss_dengue.Rd
rename to man/pub_nidss_dengue.Rd
index 8f88f80e..4302eaad 100644
--- a/man/nidss_dengue.Rd
+++ b/man/pub_nidss_dengue.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{nidss_dengue}
-\alias{nidss_dengue}
+\name{pub_nidss_dengue}
+\alias{pub_nidss_dengue}
 \title{NIDSS dengue data}
 \usage{
-nidss_dengue(locations, epiweeks, fetch_args = fetch_args_list())
+pub_nidss_dengue(locations, epiweeks, fetch_args = fetch_args_list())
 }
 \arguments{
 \item{locations}{character. Locations to fetch.}
@@ -30,7 +30,7 @@ and
 }
 \examples{
 \dontrun{
-nidss_dengue(locations = "taipei", epiweeks = epirange(201201, 201301))
+pub_nidss_dengue(locations = "taipei", epiweeks = epirange(201201, 201301))
 }
 }
 \keyword{endpoint}
diff --git a/man/nidss_flu.Rd b/man/pub_nidss_flu.Rd
similarity index 89%
rename from man/nidss_flu.Rd
rename to man/pub_nidss_flu.Rd
index 6768d6de..e2af76e3 100644
--- a/man/nidss_flu.Rd
+++ b/man/pub_nidss_flu.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{nidss_flu}
-\alias{nidss_flu}
+\name{pub_nidss_flu}
+\alias{pub_nidss_flu}
 \title{NIDSS flu data}
 \usage{
-nidss_flu(
+pub_nidss_flu(
   regions,
   epiweeks,
   ...,
@@ -40,7 +40,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/nidss_flu.html}
 }
 \examples{
 \dontrun{
-nidss_flu(regions = "taipei", epiweeks = epirange(201501, 201601))
+pub_nidss_flu(regions = "taipei", epiweeks = epirange(201501, 201601))
 }
 }
 \keyword{endpoint}
diff --git a/man/nowcast.Rd b/man/pub_nowcast.Rd
similarity index 82%
rename from man/nowcast.Rd
rename to man/pub_nowcast.Rd
index df3b04cf..dc7faaf8 100644
--- a/man/nowcast.Rd
+++ b/man/pub_nowcast.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{nowcast}
-\alias{nowcast}
+\name{pub_nowcast}
+\alias{pub_nowcast}
 \title{Delphi's ILI nowcast}
 \usage{
-nowcast(locations, epiweeks, fetch_args = fetch_args_list())
+pub_nowcast(locations, epiweeks, fetch_args = fetch_args_list())
 }
 \arguments{
 \item{locations}{character. Locations to fetch.}
@@ -28,7 +28,7 @@ The full list of location inputs can be accsssed at
 }
 \examples{
 \dontrun{
-nowcast(locations = "ca", epiweeks = epirange(201201, 201301))
+pub_nowcast(locations = "ca", epiweeks = epirange(201201, 201301))
 }
 }
 \keyword{endpoint}
diff --git a/man/paho_dengue.Rd b/man/pub_paho_dengue.Rd
similarity index 88%
rename from man/paho_dengue.Rd
rename to man/pub_paho_dengue.Rd
index e7d1645c..68b9659c 100644
--- a/man/paho_dengue.Rd
+++ b/man/pub_paho_dengue.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{paho_dengue}
-\alias{paho_dengue}
+\name{pub_paho_dengue}
+\alias{pub_paho_dengue}
 \title{PAHO Dengue data}
 \usage{
-paho_dengue(
+pub_paho_dengue(
   regions,
   epiweeks,
   ...,
@@ -36,7 +36,7 @@ API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/paho_dengue.html}
 }
 \examples{
 \dontrun{
-paho_dengue(regions = "ca", epiweeks = epirange(201401, 201501))
+pub_paho_dengue(regions = "ca", epiweeks = epirange(201401, 201501))
 }
 }
 \keyword{endpoint}
diff --git a/man/wiki.Rd b/man/pub_wiki.Rd
similarity index 96%
rename from man/wiki.Rd
rename to man/pub_wiki.Rd
index efc38e08..d075e047 100644
--- a/man/wiki.Rd
+++ b/man/pub_wiki.Rd
@@ -1,10 +1,10 @@
 % Generated by roxygen2: do not edit by hand
 % Please edit documentation in R/endpoints.R
-\name{wiki}
-\alias{wiki}
+\name{pub_wiki}
+\alias{pub_wiki}
 \title{Wikipedia access data}
 \usage{
-wiki(
+pub_wiki(
   articles,
   ...,
   dates = NULL,
@@ -78,7 +78,7 @@ available through our \href{https://delphi.cmu.edu/covidcast/export/}{data expor
 
 \examples{
 \dontrun{
-wiki(articles = "avian_influenza", epiweeks = epirange(201501, 201601))
+pub_wiki(articles = "avian_influenza", epiweeks = epirange(201501, 201601))
 }
 }
 \keyword{endpoint}
diff --git a/man/set_cache.Rd b/man/set_cache.Rd
index cc9bcfa6..56eb77f3 100644
--- a/man/set_cache.Rd
+++ b/man/set_cache.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/cache.R
 \name{set_cache}
 \alias{set_cache}
-\title{create or renew a cache for this session}
+\title{Create or renew a cache for this session}
 \usage{
 set_cache(
   cache_dir = NULL,
@@ -108,6 +108,6 @@ set_cache(
 
 }
 \seealso{
-\link{clear_cache} to delete the old cache while making a new one,
-\link{disable_cache} to disable without deleting, and \link{cache_info}
+\code{\link{clear_cache}} to delete the old cache while making a new one,
+\code{\link{disable_cache}} to disable without deleting, and \code{\link{cache_info}}
 }
diff --git a/man/timeset.Rd b/man/timeset.Rd
index 91c005b5..05c3f910 100644
--- a/man/timeset.Rd
+++ b/man/timeset.Rd
@@ -2,7 +2,7 @@
 % Please edit documentation in R/model.R
 \name{timeset}
 \alias{timeset}
-\title{timeset}
+\title{Timeset}
 \description{
 Many API calls accept timesets to specify the time ranges of data being
 requested. Timesets can be specified with \code{epirange()}, as \code{Date} objects, or
@@ -17,8 +17,8 @@ The allowed values are:
 take the form YYYYMMDD.
 \item Epiweeks: Integer-like values or integer-like strings that take the form
 YYYYWW.
-\item EpiRanges: A range returned by \code{epirange()}, or a list of multiple ranges
-\item Wildcard: The string \code{"*"}, which request all available time values
+\item EpiRanges: A range returned by \code{epirange()}, or a list of multiple ranges.
+\item Wildcard: The string \code{"*"}, which request all available time values.
 }
 
 Please refer to the specific endpoint documentation for guidance on using

From 2a150f9569769b367bb23a5a6c41fbc50a84e7c3 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:06:41 -0700
Subject: [PATCH 16/26] fix: move rlang to Suggests

---
 DESCRIPTION | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 87103255..6ef7d2ef 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: epidatr
 Type: Package
 Title: Client for Delphi's Epidata API
-Version: 1.0.0
+Version: 0.9.0
 Authors@R: 
   c(
     person("Logan", "Brooks", email = "lcbrooks@andrew.cmu.edu", role = c("aut")),
@@ -35,7 +35,6 @@ Imports:
     purrr,
     openssl,
     readr,
-    rlang,
     tibble,
     xml2
 RoxygenNote: 7.2.3
@@ -44,6 +43,7 @@ Suggests:
     ggplot2,
     knitr,
     rmarkdown,
+    rlang,
     testthat (>= 3.1.5),
     withr
 VignetteBuilder: knitr

From f63d594ce05ccc0f73a65a29665b71a7fed55b51 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:07:05 -0700
Subject: [PATCH 17/26] docs: correct docs links to pub_

---
 R/cache.R       | 2 +-
 R/endpoints.R   | 8 ++++----
 R/epidatacall.R | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/R/cache.R b/R/cache.R
index ddbd54f6..f688594b 100644
--- a/R/cache.R
+++ b/R/cache.R
@@ -238,7 +238,7 @@ cache_info <- function() {
 #' methods. Internal method only.
 #'
 #' @param call the `epidata_call` object
-#' @param fetch_args the args list for fetch as generated by [`fetch_args_list()``]
+#' @param fetch_args the args list for fetch as generated by [`fetch_args_list()`]
 #' @keywords internal
 #' @import cachem openssl
 cache_epidata_call <- function(epidata_call, fetch_args = fetch_args_list()) {
diff --git a/R/endpoints.R b/R/endpoints.R
index 1f5e6933..d102ccba 100644
--- a/R/endpoints.R
+++ b/R/endpoints.R
@@ -57,7 +57,7 @@ pvt_cdc <- function(auth, locations, epiweeks, fetch_args = fetch_args_list()) {
 #'
 #' Obtains unique identifiers and other metadata for COVID hospitalization
 #' facilities of interest.
-#' This is a companinon endpoint to the [covid_hosp_facility()] endpoint.
+#' This is a companinon endpoint to the [`pub_covid_hosp_facility()`] endpoint.
 #'
 #'
 #' @details Only one argument needs to be specified.
@@ -78,7 +78,7 @@ pvt_cdc <- function(auth, locations, epiweeks, fetch_args = fetch_args_list()) {
 #' @param fetch_args [`fetch_args`]. Additional arguments to pass to `fetch()`.
 #' @return [`epidata_call`]
 #'
-#' @seealso [pub_covid_hosp_facility()]
+#' @seealso [`pub_covid_hosp_facility()`]
 #' @keywords endpoint
 #' @export
 pub_covid_hosp_facility_lookup <- function(
@@ -143,7 +143,7 @@ pub_covid_hosp_facility_lookup <- function(
 #' Services via healthdata.gov.
 #'
 #' @details Starting October 1, 2022, some facilities are only required to
-#' report annually. The companion function [covid_hosp_facility_lookup()] can be
+#' report annually. The companion function [`pub_covid_hosp_facility_lookup()`] can be
 #' used to look up facility identifiers in a variety of ways.
 #'
 #' See also the official description and data dictionary at <healthdata.gov> for
@@ -164,7 +164,7 @@ pub_covid_hosp_facility_lookup <- function(
 #' @return [`epidata_call`]
 #'
 #'
-#' @seealso [pub_covid_hosp_facility()], [epirange()]
+#' @seealso [`pub_covid_hosp_facility()`], [`epirange()`]
 #' @keywords endpoint
 #' @export
 #
diff --git a/R/epidatacall.R b/R/epidatacall.R
index 5f558ee4..ef117ae1 100644
--- a/R/epidatacall.R
+++ b/R/epidatacall.R
@@ -4,14 +4,14 @@
 #'
 #' @description
 #' `epidata_call` objects are generated internally by endpoint functions like
-#'   [`covidcast`]; by default, they are piped directly into the `fetch`
+#'   [`pub_covidcast`]; by default, they are piped directly into the `fetch`
 #'   function to fetch and format the data. For most endpoints this will return
 #'   a tibble, but a few non-COVIDCAST endpoints only support will return a
 #'   JSON-like list instead.
 #'
 #' `create_epidata_call` is the constructor for `epidata_call` objects, but you
 #'   should not need to use it directly; instead, use an endpoint function,
-#'   e.g., [`covidcast`], to generate an `epidata_call` for the data of
+#'   e.g., [`pub_covidcast`], to generate an `epidata_call` for the data of
 #'   interest.
 #'
 #' There are some other functions available for debugging and advanced usage: -

From 4e2c0ebe065e09fc17f32e63b8e982a9d0bfcf30 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:07:15 -0700
Subject: [PATCH 18/26] docs: fix vignette

---
 vignettes/epidatr.Rmd | 49 +++++++++++++++++++++----------------------
 1 file changed, 24 insertions(+), 25 deletions(-)

diff --git a/vignettes/epidatr.Rmd b/vignettes/epidatr.Rmd
index 16111d0f..6f9c8416 100644
--- a/vignettes/epidatr.Rmd
+++ b/vignettes/epidatr.Rmd
@@ -41,11 +41,11 @@ provides access to a range of data on COVID-19. Reviewing the endpoint
 documentation, we see that we need to specify a data source name, a signal name,
 a geographic level, a time resolution, and the location and times of interest.
 
-In this case, the `covidcast()` function lets us specify these parameters for
+In this case, the `pub_covidcast()` function lets us specify these parameters for
 the endpoint and returns a tibble with the results:
 
 ```{r}
-epidata <- covidcast(
+epidata <- pub_covidcast(
   "fb-survey", "smoothed_cli", "state", "day", "pa",
   epirange(20210105, 20210410)
 )
@@ -114,7 +114,7 @@ We can obtain the `epidata_call` object underlying a request by setting the
 `dry_run` argument to `TRUE` in `fetch_args_list`:
 
 ```{r}
-covidcast(
+pub_covidcast(
   "fb-survey", "smoothed_cli", "state", "day", "pa",
   epirange(20210405, 20210410),
   fetch_args = fetch_args_list(dry_run = TRUE)
@@ -132,7 +132,7 @@ API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covidcast_signals.htm
 County geo_values are [FIPS codes](https://en.wikipedia.org/wiki/List_of_United_States_FIPS_codes_by_county) and are discussed in the API docs [here](https://cmu-delphi.github.io/delphi-epidata/api/covidcast_geography.html). The example below is for Orange County, California.
 
 ```{r}
-covidcast(
+pub_covidcast(
   source = "fb-survey",
   signals = "smoothed_accept_covid_vaccine",
   geo_type = "county",
@@ -145,7 +145,7 @@ covidcast(
 The `covidcast` endpoint supports `*` in its time and geo fields:
 
 ```{r}
-covidcast(
+pub_covidcast(
   source = "fb-survey",
   signals = "smoothed_accept_covid_vaccine",
   geo_type = "county",
@@ -162,10 +162,10 @@ covidcast(
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility_lookup.html>
 
 ```{r, eval = FALSE}
-covid_hosp_facility_lookup(city = "southlake")
-covid_hosp_facility_lookup(state = "WY")
+pub_covid_hosp_facility_lookup(city = "southlake")
+pub_covid_hosp_facility_lookup(state = "WY")
 # A non-example (there is no city called New York in Wyoming)
-covid_hosp_facility_lookup(state = "WY", city = "New York")
+pub_covid_hosp_facility_lookup(state = "WY", city = "New York")
 ```
 
 #### COVID-19 Hospitalization by Facility
@@ -173,7 +173,7 @@ covid_hosp_facility_lookup(state = "WY", city = "New York")
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility.html>
 
 ```{r, eval = FALSE}
-covid_hosp_facility(
+pub_covid_hosp_facility(
   hospital_pks = "100075",
   collection_weeks = epirange(20200101, 20200501)
 )
@@ -184,7 +184,7 @@ covid_hosp_facility(
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp.html>
 
 ```{r, eval = FALSE}
-covid_hosp_state_timeseries(states = "MA", dates = "20200510")
+pub_covid_hosp_state_timeseries(states = "MA", dates = "20200510")
 ```
 
 ### Flu Endpoints
@@ -194,7 +194,7 @@ covid_hosp_state_timeseries(states = "MA", dates = "20200510")
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/delphi.html>
 
 ```{r, eval = FALSE}
-del <- delphi(system = "ec", epiweek = 201501)
+del <- pub_delphi(system = "ec", epiweek = 201501)
 names(del[[1L]]$forecast)
 ```
 
@@ -203,7 +203,7 @@ names(del[[1L]]$forecast)
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/flusurv.html>
 
 ```{r, eval = FALSE}
-flusurv(locations = "ca", epiweeks = 202001)
+pub_flusurv(locations = "ca", epiweeks = 202001)
 ```
 
 #### Fluview data
@@ -211,7 +211,7 @@ flusurv(locations = "ca", epiweeks = 202001)
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview.html>
 
 ```{r, eval = FALSE}
-fluview(regions = "nat", epiweeks = epirange(201201, 202001))
+pub_fluview(regions = "nat", epiweeks = epirange(201201, 202001))
 ```
 
 #### Fluview virological data from clinical labs
@@ -219,7 +219,7 @@ fluview(regions = "nat", epiweeks = epirange(201201, 202001))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview_clinical.html>
 
 ```{r, eval = FALSE}
-fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
+pub_fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
 ```
 
 #### Fluview metadata
@@ -227,7 +227,7 @@ fluview_clinical(regions = "nat", epiweeks = epirange(201601, 201701))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/fluview_meta.html>
 
 ```{r, eval = FALSE}
-fluview_meta()
+pub_fluview_meta()
 ```
 
 #### Google Flu Trends data
@@ -235,7 +235,7 @@ fluview_meta()
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/gft.html>
 
 ```{r, eval = FALSE}
-gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
+pub_gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
 ```
 
 #### ECDC ILI
@@ -243,7 +243,7 @@ gft(locations = "hhs1", epiweeks = epirange(201201, 202001))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/ecdc_ili.html>
 
 ```{r, eval = FALSE}
-ecdc_ili(regions = "Armenia", epiweeks = 201840)
+pub_ecdc_ili(regions = "Armenia", epiweeks = 201840)
 ```
 
 #### KCDC ILI
@@ -251,7 +251,7 @@ ecdc_ili(regions = "Armenia", epiweeks = 201840)
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/kcdc_ili.html>
 
 ```{r, eval = FALSE}
-kcdc_ili(regions = "ROK", epiweeks = 200436)
+pub_kcdc_ili(regions = "ROK", epiweeks = 200436)
 ```
 
 #### NIDSS Flu
@@ -259,7 +259,7 @@ kcdc_ili(regions = "ROK", epiweeks = 200436)
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nidss_flu.html>
 
 ```{r, eval = FALSE}
-nidss_flu(regions = "taipei", epiweeks = epirange(200901, 201301))
+pub_nidss_flu(regions = "taipei", epiweeks = epirange(200901, 201301))
 ```
 
 #### ILI Nearby Nowcast
@@ -267,7 +267,7 @@ nidss_flu(regions = "taipei", epiweeks = epirange(200901, 201301))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nowcast.html>
 
 ```{r, eval = FALSE}
-nowcast(locations = "ca", epiweeks = epirange(202201, 202319))
+pub_nowcast(locations = "ca", epiweeks = epirange(202201, 202319))
 ```
 
 ### Dengue Endpoints
@@ -277,7 +277,7 @@ nowcast(locations = "ca", epiweeks = epirange(202201, 202319))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/dengue_nowcast.html>
 
 ```{r, eval = FALSE}
-dengue_nowcast(locations = "pr", epiweeks = epirange(201401, 202301))
+pub_dengue_nowcast(locations = "pr", epiweeks = epirange(201401, 202301))
 ```
 
 #### NIDSS dengue
@@ -285,7 +285,7 @@ dengue_nowcast(locations = "pr", epiweeks = epirange(201401, 202301))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/nidss_dengue.html>
 
 ```{r, eval = FALSE}
-nidss_dengue(locations = "taipei", epiweeks = epirange(200301, 201301))
+pub_nidss_dengue(locations = "taipei", epiweeks = epirange(200301, 201301))
 ```
 
 ### PAHO Dengue
@@ -293,7 +293,7 @@ nidss_dengue(locations = "taipei", epiweeks = epirange(200301, 201301))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/paho_dengue.html>
 
 ```{r, eval=FALSE}
-paho_dengue(regions = "ca", epiweeks = epirange(200201, 202319))
+pub_paho_dengue(regions = "ca", epiweeks = epirange(200201, 202319))
 ```
 
 ### Other Endpoints
@@ -303,7 +303,7 @@ paho_dengue(regions = "ca", epiweeks = epirange(200201, 202319))
 API docs: <https://cmu-delphi.github.io/delphi-epidata/api/wiki.html>
 
 ```{r, eval = FALSE}
-wiki(language = "en", articles = "influenza", epiweeks = epirange(202001, 202319))
+pub_wiki(language = "en", articles = "influenza", epiweeks = epirange(202001, 202319))
 ```
 
 ### Private methods
@@ -393,4 +393,3 @@ pvt_twitter(
   epiweeks = epirange(200301, 202105)
 )
 ```
-

From 66216d695bf1ef51746323a1c8a95bb5adb90ea7 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:07:24 -0700
Subject: [PATCH 19/26] tests: fix tests

---
 tests/testthat/test-cache.R       |  4 ++--
 tests/testthat/test-covidcast.R   |  2 +-
 tests/testthat/test-endpoints.R   | 40 +++++++++++++++----------------
 tests/testthat/test-epidatacall.R |  6 ++---
 tests/testthat/test-model.R       |  2 +-
 5 files changed, 27 insertions(+), 27 deletions(-)

diff --git a/tests/testthat/test-cache.R b/tests/testthat/test-cache.R
index 1ba98e31..522f97fb 100644
--- a/tests/testthat/test-cache.R
+++ b/tests/testthat/test-cache.R
@@ -49,7 +49,7 @@ test_that("cache set as expected", {
 # use an existing example to save, then load and compare the values
 test_that("cache saves & loads", {
   test_set_cache()
-  epidata_call <- covidcast(
+  epidata_call <- pub_covidcast(
     source = "jhu-csse",
     signals = "confirmed_7dav_incidence_prop",
     time_type = "day",
@@ -122,7 +122,7 @@ test_that("check_is_recent", {
 
 test_that("check_is_cachable", {
   check_fun <- function(..., fetch_args = fetch_args_list(), expected_result) {
-    epidata_call <- covidcast(
+    epidata_call <- pub_covidcast(
       source = "jhu-csse",
       signals = "confirmed_7dav_incidence_prop",
       time_type = "day",
diff --git a/tests/testthat/test-covidcast.R b/tests/testthat/test-covidcast.R
index d470af24..2e816f14 100644
--- a/tests/testthat/test-covidcast.R
+++ b/tests/testthat/test-covidcast.R
@@ -7,7 +7,7 @@ test_that("covidcast", {
       epirange(20210405, 20210410),
       fetch_args = fetch_args_list(dry_run = TRUE)
     ),
-    covidcast(
+    pub_covidcast(
       "fb-survey",
       "smoothed_cli",
       "nation",
diff --git a/tests/testthat/test-endpoints.R b/tests/testthat/test-endpoints.R
index 3812314b..3c81dea1 100644
--- a/tests/testthat/test-endpoints.R
+++ b/tests/testthat/test-endpoints.R
@@ -5,24 +5,24 @@ test_that("basic_epidata_call", {
     epirange(201501, 201601),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(covid_hosp_facility_lookup(
+  expect_no_error(pub_covid_hosp_facility_lookup(
     state = "fl",
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(covid_hosp_facility(
+  expect_no_error(pub_covid_hosp_facility(
     hospital_pks = "100075",
     collection_weeks = epirange(20200101, 20200501),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(covid_hosp_state_timeseries(
+  expect_no_error(pub_covid_hosp_state_timeseries(
     states = "fl",
     dates = epirange(20200101, 20200501),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(covidcast_meta(
+  expect_no_error(pub_covidcast_meta(
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(covidcast(
+  expect_no_error(pub_covidcast(
     source = "jhu-csse",
     signals = "confirmed_7dav_incidence_prop",
     time_type = "day",
@@ -31,12 +31,12 @@ test_that("basic_epidata_call", {
     geo_values = "ca,fl",
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(delphi(
+  expect_no_error(pub_delphi(
     system = "ec",
     epiweek = 202006,
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(dengue_nowcast(
+  expect_no_error(pub_dengue_nowcast(
     locations = "?",
     epiweeks = epirange(201501, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
@@ -48,30 +48,30 @@ test_that("basic_epidata_call", {
     epiweeks = epirange(201501, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(ecdc_ili(
+  expect_no_error(pub_ecdc_ili(
     regions = "austria",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(flusurv(
+  expect_no_error(pub_flusurv(
     locations = "CA",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(fluview_clinical(
+  expect_no_error(pub_fluview_clinical(
     regions = "nat",
     epiweeks = epirange(201601, 201701),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(fluview_meta(
+  expect_no_error(pub_fluview_meta(
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(fluview(
+  expect_no_error(pub_fluview(
     regions = "nat",
     epiweeks = epirange(201601, 201701),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(gft(
+  expect_no_error(pub_gft(
     locations = "hhs1",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
@@ -83,7 +83,7 @@ test_that("basic_epidata_call", {
     query = "?",
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(kcdc_ili(
+  expect_no_error(pub_kcdc_ili(
     regions = "?",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
@@ -92,15 +92,15 @@ test_that("basic_epidata_call", {
     auth = "yourkey",
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(meta(
+  expect_no_error(pub_meta(
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(nidss_dengue(
+  expect_no_error(pub_nidss_dengue(
     locations = "taipei",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(nidss_flu(
+  expect_no_error(pub_nidss_flu(
     regions = "taipei",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
@@ -111,12 +111,12 @@ test_that("basic_epidata_call", {
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(nowcast(
+  expect_no_error(pub_nowcast(
     locations = "ca",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(paho_dengue(
+  expect_no_error(pub_paho_dengue(
     regions = "ca",
     epiweeks = epirange(201201, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
@@ -140,7 +140,7 @@ test_that("basic_epidata_call", {
     epiweeks = epirange(201501, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
   ) %>% request_url())
-  expect_no_error(wiki(
+  expect_no_error(pub_wiki(
     articles = "avian_influenza",
     epiweeks = epirange(201501, 202001),
     fetch_args = fetch_args_list(dry_run = TRUE)
diff --git a/tests/testthat/test-epidatacall.R b/tests/testthat/test-epidatacall.R
index 4a2945a6..b0d171d8 100644
--- a/tests/testthat/test-epidatacall.R
+++ b/tests/testthat/test-epidatacall.R
@@ -69,7 +69,7 @@ test_that("fetch_args", {
 })
 
 test_that("fetch and fetch_tbl", {
-  epidata_call <- covidcast(
+  epidata_call <- pub_covidcast(
     source = "jhu-csse",
     signals = "confirmed_7dav_incidence_prop",
     time_type = "day",
@@ -103,7 +103,7 @@ test_that("fetch and fetch_tbl", {
 })
 
 test_that("fetch_tbl warns on non-success", {
-  epidata_call <- covidcast(
+  epidata_call <- pub_covidcast(
     source = "jhu-csse",
     signals = "confirmed_7dav_incidence_prop",
     time_type = "day",
@@ -142,7 +142,7 @@ test_that("fetch_tbl warns on non-success", {
 
 test_that("classic only fetch", {
   # delphi is an example endpoint that only suports the classic call
-  epidata_call <- delphi(
+  epidata_call <- pub_delphi(
     system = "ec",
     epiweek = 201501,
     fetch_args = fetch_args_list(dry_run = TRUE)
diff --git a/tests/testthat/test-model.R b/tests/testthat/test-model.R
index c0723d01..7a05aa0e 100644
--- a/tests/testthat/test-model.R
+++ b/tests/testthat/test-model.R
@@ -49,7 +49,7 @@ test_that("`parse_timeset_input` on valid inputs", {
 
 test_that("null parsing", {
   # parse_data_frame (df[[info$name]] = NULL)-> parse_value
-  epidata_call <- flusurv(
+  epidata_call <- pub_flusurv(
     locations = "ca",
     epiweeks = 202001,
     fetch_args = fetch_args_list(dry_run = TRUE)

From 4993b7c2c2d88211cc9e170a6bb7fb5bddadc67a Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:07:31 -0700
Subject: [PATCH 20/26] docs: document

---
 man/cache_epidata_call.Rd             | 2 +-
 man/epidata_call.Rd                   | 4 ++--
 man/pub_covid_hosp_facility.Rd        | 2 +-
 man/pub_covid_hosp_facility_lookup.Rd | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/man/cache_epidata_call.Rd b/man/cache_epidata_call.Rd
index 60a86ff6..f9ae68a6 100644
--- a/man/cache_epidata_call.Rd
+++ b/man/cache_epidata_call.Rd
@@ -7,7 +7,7 @@
 cache_epidata_call(epidata_call, fetch_args = fetch_args_list())
 }
 \arguments{
-\item{fetch_args}{the args list for fetch as generated by \link{`fetch_args_list()``}}
+\item{fetch_args}{the args list for fetch as generated by \code{\link[=fetch_args_list]{fetch_args_list()}}}
 
 \item{call}{the \code{epidata_call} object}
 }
diff --git a/man/epidata_call.Rd b/man/epidata_call.Rd
index 456cc97c..a835ac7c 100644
--- a/man/epidata_call.Rd
+++ b/man/epidata_call.Rd
@@ -39,14 +39,14 @@ fetch(epidata_call, fetch_args = fetch_args_list())
 }
 \description{
 \code{epidata_call} objects are generated internally by endpoint functions like
-\code{\link{covidcast}}; by default, they are piped directly into the \code{fetch}
+\code{\link{pub_covidcast}}; by default, they are piped directly into the \code{fetch}
 function to fetch and format the data. For most endpoints this will return
 a tibble, but a few non-COVIDCAST endpoints only support will return a
 JSON-like list instead.
 
 \code{create_epidata_call} is the constructor for \code{epidata_call} objects, but you
 should not need to use it directly; instead, use an endpoint function,
-e.g., \code{\link{covidcast}}, to generate an \code{epidata_call} for the data of
+e.g., \code{\link{pub_covidcast}}, to generate an \code{epidata_call} for the data of
 interest.
 
 There are some other functions available for debugging and advanced usage: -
diff --git a/man/pub_covid_hosp_facility.Rd b/man/pub_covid_hosp_facility.Rd
index edabb8eb..e56d255c 100644
--- a/man/pub_covid_hosp_facility.Rd
+++ b/man/pub_covid_hosp_facility.Rd
@@ -36,7 +36,7 @@ API docs:
 \url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility.html}
 
 Starting October 1, 2022, some facilities are only required to
-report annually. The companion function \code{\link[=covid_hosp_facility_lookup]{covid_hosp_facility_lookup()}} can be
+report annually. The companion function \code{\link[=pub_covid_hosp_facility_lookup]{pub_covid_hosp_facility_lookup()}} can be
 used to look up facility identifiers in a variety of ways.
 
 See also the official description and data dictionary at <healthdata.gov> for
diff --git a/man/pub_covid_hosp_facility_lookup.Rd b/man/pub_covid_hosp_facility_lookup.Rd
index 12b7fccb..21217a25 100644
--- a/man/pub_covid_hosp_facility_lookup.Rd
+++ b/man/pub_covid_hosp_facility_lookup.Rd
@@ -35,7 +35,7 @@ pub_covid_hosp_facility_lookup(
 \description{
 Obtains unique identifiers and other metadata for COVID hospitalization
 facilities of interest.
-This is a companinon endpoint to the \code{\link[=covid_hosp_facility]{covid_hosp_facility()}} endpoint.
+This is a companinon endpoint to the \code{\link[=pub_covid_hosp_facility]{pub_covid_hosp_facility()}} endpoint.
 }
 \details{
 API docs:

From 29317834eedc30b41ea8b8c3df5b958764a67772 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:10:26 -0700
Subject: [PATCH 21/26] chore: bump version to 1.0.0 and add news

---
 .bumpversion.cfg |  2 +-
 DESCRIPTION      |  2 +-
 NEWS.md          | 20 ++++++++++++++------
 R/constants.R    |  2 +-
 4 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/.bumpversion.cfg b/.bumpversion.cfg
index 7565dd9d..c4459027 100644
--- a/.bumpversion.cfg
+++ b/.bumpversion.cfg
@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.9.0
+current_version = 1.0.0
 commit = False
 tag = False
 
diff --git a/DESCRIPTION b/DESCRIPTION
index 6ef7d2ef..506efe67 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,7 +1,7 @@
 Package: epidatr
 Type: Package
 Title: Client for Delphi's Epidata API
-Version: 0.9.0
+Version: 1.0.0
 Authors@R: 
   c(
     person("Logan", "Brooks", email = "lcbrooks@andrew.cmu.edu", role = c("aut")),
diff --git a/NEWS.md b/NEWS.md
index c4cdcde9..9dd1990e 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,3 +1,11 @@
+# epidatr 1.0.0
+
+- Add `set_cache` and other caching functions.
+- Prefix all non-private endpoints with `pub_`.
+- Update printing of `avail_endpoints` to be more readable.
+- Update printing of `covidcast_epidata()` to be more readable.
+- Update landing docs to be more friendly, add plots.
+
 # epidatr 0.9.0
 
 - Major interface change: all endpoints now fetch by default.
@@ -29,13 +37,13 @@
 # epidatr 0.6.0
 
 - The `fetch_{tbl,classic,df,json,csv}` functions have been replaced by the
-`fetch()` function, which almost always returns a tibble, except when used with
-a limited number of older endpoints (such as `delphi()` and `meta()`), where it
-will output a nested list structure.
+  `fetch()` function, which almost always returns a tibble, except when used with
+  a limited number of older endpoints (such as `delphi()` and `meta()`), where it
+  will output a nested list structure.
 
 # epidatr 0.5.0
 
 - The package that this installs is being renamed from `delphi.epidata` to
-`epidatr`. To migrate, run the installation command above, followed by
-`remove.packages("delphi.epidata")`, and adjust all references to the package
-name accordingly.
+  `epidatr`. To migrate, run the installation command above, followed by
+  `remove.packages("delphi.epidata")`, and adjust all references to the package
+  name accordingly.
diff --git a/R/constants.R b/R/constants.R
index eb852c0b..b00768ca 100644
--- a/R/constants.R
+++ b/R/constants.R
@@ -1,3 +1,3 @@
-version <- "0.9.0"
+version <- "1.0.0"
 http_headers <- httr::add_headers("User-Agent" = paste0("epidatr/", version), "Accept-Encoding" = "gzip")
 global_base_url <- "https://api.delphi.cmu.edu/epidata/"

From ab08359c44117a79e9add6ac5aad61eb5a96f722 Mon Sep 17 00:00:00 2001
From: dsweber2 <dsweber2@users.noreply.github.com>
Date: Wed, 6 Sep 2023 23:12:16 +0000
Subject: [PATCH 22/26] docs: document (GHA)

---
 man/pub_covid_hosp_facility.Rd         | 6 +++---
 man/pub_covid_hosp_facility_lookup.Rd  | 6 +++---
 man/pub_covid_hosp_state_timeseries.Rd | 4 ++--
 man/pub_covidcast.Rd                   | 3 +--
 man/pub_covidcast_meta.Rd              | 7 +++----
 man/pub_ecdc_ili.Rd                    | 4 ++--
 man/pub_flusurv.Rd                     | 7 ++++---
 man/pub_fluview.Rd                     | 9 +++++----
 man/pub_gft.Rd                         | 4 ++--
 man/pub_nidss_dengue.Rd                | 4 ++--
 man/pub_nidss_flu.Rd                   | 5 ++---
 man/pub_nowcast.Rd                     | 6 +++---
 12 files changed, 32 insertions(+), 33 deletions(-)

diff --git a/man/pub_covid_hosp_facility.Rd b/man/pub_covid_hosp_facility.Rd
index e56d255c..762d97f3 100644
--- a/man/pub_covid_hosp_facility.Rd
+++ b/man/pub_covid_hosp_facility.Rd
@@ -27,14 +27,14 @@ pub_covid_hosp_facility(
 \code{\link{epidata_call}}
 }
 \description{
+API docs:
+\url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility.html}
+
 Obtains the COVID-19 reported patient impact and hospital capacity data by
 facility. This dataset is provided by the US Department of Health & Human
 Services via healthdata.gov.
 }
 \details{
-API docs:
-\url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility.html}
-
 Starting October 1, 2022, some facilities are only required to
 report annually. The companion function \code{\link[=pub_covid_hosp_facility_lookup]{pub_covid_hosp_facility_lookup()}} can be
 used to look up facility identifiers in a variety of ways.
diff --git a/man/pub_covid_hosp_facility_lookup.Rd b/man/pub_covid_hosp_facility_lookup.Rd
index 21217a25..c416dee9 100644
--- a/man/pub_covid_hosp_facility_lookup.Rd
+++ b/man/pub_covid_hosp_facility_lookup.Rd
@@ -33,14 +33,14 @@ pub_covid_hosp_facility_lookup(
 \code{\link{epidata_call}}
 }
 \description{
+API docs:
+\url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility_lookup.html}
+
 Obtains unique identifiers and other metadata for COVID hospitalization
 facilities of interest.
 This is a companinon endpoint to the \code{\link[=pub_covid_hosp_facility]{pub_covid_hosp_facility()}} endpoint.
 }
 \details{
-API docs:
-\url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp_facility_lookup.html}
-
 Only one argument needs to be specified.
 Combinations of the arguments are not currently supported.
 For instance, specifying both city and state are not supported.
diff --git a/man/pub_covid_hosp_state_timeseries.Rd b/man/pub_covid_hosp_state_timeseries.Rd
index de13a690..6cedca3f 100644
--- a/man/pub_covid_hosp_state_timeseries.Rd
+++ b/man/pub_covid_hosp_state_timeseries.Rd
@@ -28,13 +28,13 @@ most recent issue is returned.}
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp.html}.
+
 Obtains the COVID-19 reported patient impact and hospital capacity data by
 state. This dataset is provided by the US Department of Health & Human
 Services via healthdata.gov.
 }
 \details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/covid_hosp.html}.
-
 Starting October 1, 2022, some facilities are only required to
 report annually.
 
diff --git a/man/pub_covidcast.Rd b/man/pub_covidcast.Rd
index 5775feef..ae1c39f9 100644
--- a/man/pub_covidcast.Rd
+++ b/man/pub_covidcast.Rd
@@ -58,8 +58,7 @@ the most recent issue is returned. Mutually exclusive with \code{as_of} or
 }
 \description{
 API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/covidcast.html}
-}
-\details{
+
 COVIDcast public dashboard: \url{https://delphi.cmu.edu/covidcast/}
 }
 \examples{
diff --git a/man/pub_covidcast_meta.Rd b/man/pub_covidcast_meta.Rd
index 75c42c69..b8c440c7 100644
--- a/man/pub_covidcast_meta.Rd
+++ b/man/pub_covidcast_meta.Rd
@@ -13,14 +13,13 @@ pub_covidcast_meta(fetch_args = fetch_args_list())
 \code{\link{epidata_call}}
 }
 \description{
+API docs:
+\url{https://cmu-delphi.github.io/delphi-epidata/api/covidcast_meta.html}.
+
 Fetch a summary of metadata for all sources and signals that are available in
 the API, along with basic summary statistics such as the dates they are
 available, the geographic levels at which they are reported, and etc.
 }
-\details{
-API docs:
-\url{https://cmu-delphi.github.io/delphi-epidata/api/covidcast_meta.html}.
-}
 \examples{
 \dontrun{
 pub_covidcast_meta()
diff --git a/man/pub_ecdc_ili.Rd b/man/pub_ecdc_ili.Rd
index 2dd26bcb..634e3762 100644
--- a/man/pub_ecdc_ili.Rd
+++ b/man/pub_ecdc_ili.Rd
@@ -32,12 +32,12 @@ the most recent issue is returned. Mutually exclusive with \code{issues}.}
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/ecdc_ili.html}.
+
 Obtain information on influenza-like-illness from the European Centre for
 Disease Prevention and Control.
 }
 \details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/ecdc_ili.html}.
-
 The list of location argument can be found in
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/labels/ecdc_regions.txt}.
 }
diff --git a/man/pub_flusurv.Rd b/man/pub_flusurv.Rd
index caa6e3e2..53cf550a 100644
--- a/man/pub_flusurv.Rd
+++ b/man/pub_flusurv.Rd
@@ -32,13 +32,14 @@ the most recent issue is returned. Mutually exclusive with \code{issues}.}
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/flusurv.html}.
+
 Obtain information on flu hospitalization rates from the Center of Disease
 Control.
+
+See also \url{https://gis.cdc.gov/GRASP/Fluview/FluHospRates.html}.
 }
 \details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/flusurv.html}.
-See also \url{https://gis.cdc.gov/GRASP/Fluview/FluHospRates.html}.
-
 The list of location argument can be found in
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/labels/flusurv_locations.txt}.
 }
diff --git a/man/pub_fluview.Rd b/man/pub_fluview.Rd
index 389ff92c..0eb7954d 100644
--- a/man/pub_fluview.Rd
+++ b/man/pub_fluview.Rd
@@ -40,14 +40,15 @@ key).}
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/fluview.html}. For
+
 Obtains information on outpatient inluenza-like-illness (ILI) from U.S.
 Outpatient Influenza-like Illness Surveillance Network (ILINet).
-}
-\details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/fluview.html}. For
+
 more information on ILINet, see
 \url{https://gis.cdc.gov/grasp/fluview/fluportaldashboard.html}.
-
+}
+\details{
 The full list of location inputs can be accsssed at
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/src/acquisition/fluview/fluview_locations.py}.
 }
diff --git a/man/pub_gft.Rd b/man/pub_gft.Rd
index a3d23fb5..8bdc9742 100644
--- a/man/pub_gft.Rd
+++ b/man/pub_gft.Rd
@@ -17,12 +17,12 @@ pub_gft(locations, epiweeks, fetch_args = fetch_args_list())
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/gft.html}
+
 Obtains estimates of inluenza activity based on volume of certain search
 queries from Google.
 }
 \details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/gft.html}
-
 Google has discontinued Flu Trends and this is now a static
 endpoint. Possibile input for locations can be found in
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/labels/regions.txt},
diff --git a/man/pub_nidss_dengue.Rd b/man/pub_nidss_dengue.Rd
index 4302eaad..ae6bc1d5 100644
--- a/man/pub_nidss_dengue.Rd
+++ b/man/pub_nidss_dengue.Rd
@@ -17,12 +17,12 @@ pub_nidss_dengue(locations, epiweeks, fetch_args = fetch_args_list())
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/nidss_dengue.html}
+
 Obtains counts of confirmed dengue cases in Taiwan from Taiwan National
 Infectious Disease Statistical System.
 }
 \details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/nidss_dengue.html}
-
 Possible location inputs can be found in
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/labels/nidss_regions.txt}
 and
diff --git a/man/pub_nidss_flu.Rd b/man/pub_nidss_flu.Rd
index e2af76e3..f1b12d36 100644
--- a/man/pub_nidss_flu.Rd
+++ b/man/pub_nidss_flu.Rd
@@ -32,12 +32,11 @@ the most recent issue is returned. Mutually exclusive with \code{issues}.}
 \code{\link{epidata_call}}
 }
 \description{
+API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/nidss_flu.html}
+
 Obtains information on outpatient inluenza-like-illness from Taiwan National
 Infectious Disease Statistical System.
 }
-\details{
-API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/nidss_flu.html}
-}
 \examples{
 \dontrun{
 pub_nidss_flu(regions = "taipei", epiweeks = epirange(201501, 201601))
diff --git a/man/pub_nowcast.Rd b/man/pub_nowcast.Rd
index dc7faaf8..0a56e416 100644
--- a/man/pub_nowcast.Rd
+++ b/man/pub_nowcast.Rd
@@ -18,11 +18,11 @@ pub_nowcast(locations, epiweeks, fetch_args = fetch_args_list())
 }
 \description{
 API docs: \url{https://cmu-delphi.github.io/delphi-epidata/api/nowcast.html}.
-}
-\details{
+
 Obtains information on outpatient inluenza-like-illness (ILI) from Delphi's
 epidemiological data
-
+}
+\details{
 The full list of location inputs can be accsssed at
 \url{https://github.com/cmu-delphi/delphi-epidata/blob/main/src/acquisition/fluview/fluview_locations.py}.
 }

From 4e330738258b791bcc8a484ae0faec36d2099cbe Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:28:38 -0700
Subject: [PATCH 23/26] chore: bump lintr object length

---
 .lintr | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.lintr b/.lintr
index a63d9147..c0bfc243 100644
--- a/.lintr
+++ b/.lintr
@@ -1,4 +1,5 @@
 linters: linters_with_defaults(
   line_length_linter(120),
-  cyclocomp_linter = NULL
+  cyclocomp_linter = NULL,
+  object_length_linter(length = 40L)
   )

From 6f267296381d37ba2cbc4bff00a67fcc6a820083 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:28:48 -0700
Subject: [PATCH 24/26] lintr: make happy

---
 R/endpoints.R | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/R/endpoints.R b/R/endpoints.R
index d102ccba..9fda143f 100644
--- a/R/endpoints.R
+++ b/R/endpoints.R
@@ -1126,7 +1126,14 @@ pub_fluview_meta <- function(fetch_args = fetch_args_list()) {
 #' @return [`epidata_call`]
 #' @keywords endpoint
 #' @export
-pub_fluview <- function(regions, epiweeks, ..., issues = NULL, lag = NULL, auth = NULL, fetch_args = fetch_args_list()) {
+pub_fluview <- function(
+    regions,
+    epiweeks,
+    ...,
+    issues = NULL,
+    lag = NULL,
+    auth = NULL,
+    fetch_args = fetch_args_list()) {
   assert_character_param("regions", regions)
   assert_timeset_param("epiweeks", epiweeks)
   assert_timeset_param("issues", issues, required = FALSE)

From a1141865bcb540cecac176a4fc1da2324e7e3047 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:28:58 -0700
Subject: [PATCH 25/26] fix: md5 import

---
 R/cache.R | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/R/cache.R b/R/cache.R
index f688594b..ccc41aa2 100644
--- a/R/cache.R
+++ b/R/cache.R
@@ -240,7 +240,7 @@ cache_info <- function() {
 #' @param call the `epidata_call` object
 #' @param fetch_args the args list for fetch as generated by [`fetch_args_list()`]
 #' @keywords internal
-#' @import cachem openssl
+#' @importFrom openssl md5
 cache_epidata_call <- function(epidata_call, fetch_args = fetch_args_list()) {
   is_cachable <- check_is_cachable(epidata_call, fetch_args)
   if (is_cachable) {

From 2589d0f93d5c04ab6bf7be2bc7a9561a263acb80 Mon Sep 17 00:00:00 2001
From: Dmitry Shemetov <dshemetov@ucdavis.edu>
Date: Wed, 6 Sep 2023 16:29:05 -0700
Subject: [PATCH 26/26] docs: document

---
 NAMESPACE | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/NAMESPACE b/NAMESPACE
index 9d39a295..6f454611 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -48,7 +48,6 @@ export(pvt_twitter)
 export(set_cache)
 import(cachem)
 import(glue)
-import(openssl)
 importFrom(MMWRweek,MMWRweek2Date)
 importFrom(checkmate,assert)
 importFrom(checkmate,assert_character)
@@ -74,6 +73,7 @@ importFrom(httr,modify_url)
 importFrom(httr,stop_for_status)
 importFrom(jsonlite,fromJSON)
 importFrom(magrittr,"%>%")
+importFrom(openssl,md5)
 importFrom(purrr,map_chr)
 importFrom(purrr,map_lgl)
 importFrom(readr,read_csv)