#' @param progress (logical) print progress - ignored if `parallel=TRUE`.

#' The default is `FALSE` because printing progress adds a small bit of

#' time, so if processing time is important, then keep as `FALSE`

#' @seealso [isd()], [isd_stations()], [isd_stations_search()]

#' @details `isd_read` - read a `.gz` file as downloaded

#' from NOAA's website

#' this will override that behavior.

#' @param ... Curl options passed on to [crul::verb-GET]

#'

#' https://www1.ncdc.noaa.gov/pub/data/noaa

#' @family isd

#'

#'

#' @section Errors:

#' Note that when you get an error similar to `Error: download failed for

#' you'll get a different error.

#'

#' @note See [isd_cache] for managing cached files

#' @return A tibble (data.frame) which contains data pulled from NOAA's FTP

#' server for the queried weather site. A README file with more information

#' about the format of this file is available from NOAA

#' This file is formatted so each line of the file gives the daily weather

#' observations for a single weather variable for all days of one month of

#' one year. In addition to measurements, columns are included for certain

#' @section Base URL:

#' The base url for data requests can be changed. The allowed urls are:

#' https://www1.ncdc.noaa.gov/pub/data/ghcn/daily/all (default),

#' 

#' You can set the base url using the `RNOAA_GHCND_BASE_URL` environment

#' variable; see example below.

#' 

#' # change the base url for data requests

#' Sys.setenv(RNOAA_GHCND_BASE_URL =

#' ghcnd(stations$id[45], verbose = TRUE)

#' ## must be in the allowed set of urls

#' # Sys.setenv(RNOAA_GHCND_BASE_URL = "https://google.com")

ghcnd_allowed_urls <- c(

  "https://www1.ncdc.noaa.gov/pub/data/ghcn/daily/all",

)

ghcndbase <- function() {

  }

#' a single data.frame. Data across years, with extent and area of ice.

#' 

#' An example file, for January, North pole:

#'

#' @export

#' @param ... Curl options passed on to [crul::verb-GET] - beware

#' @export

#' @param refresh (logical) Download station data from NOAA ftp server again.

#' Default: `FALSE`

#' @family isd

#' @details The data table is cached, but you can force download of data from

#' NOAA by setting `refresh=TRUE`

#' - lat - latitude (-90 to 90)

#' - precip - precipitation (in mm) (see Details for more information)

#'

#'

#' @details

#' Rainfall data for the world (1979-present, resolution 50 km), and

}

cpc_GET_write <- function(url, path, overwrite = TRUE, ...) {

}

cpc_base_ftp <- function(x) {

}

#' then split the output into tibbles by date

#' @param ... curl options passed on to [crul::verb-GET]

#' @references docs:

#' @note See [arc2_cache] for managing cached files

#' @section box parameter:

#' The `box` parameter filters the arc2 data to a bounding box you supply.

}

arc2_GET_write <- function(url, path, date, overwrite = TRUE, ...) {

}

arc2_base <- function() {

}

#' @param bbox (numeric) Bounding box, of the form: min-longitude, 

#' min-latitude, max-longitude, max-latitude

#'

#'

#' @return a data.frame with the columns:

#'