download: Download a file

In MangoTheCat/install: R Package Installation from Remote Repositories, Including 'GitHub'

Download a file

Description

Uses either the curl package for R versions older than 3.2.0, otherwise a wrapper around download.file().

Usage

download(
  path,
  url,
  auth_token = NULL,
  basic_auth = NULL,
  quiet = TRUE,
  headers = NULL
)

Arguments

path	Path to download to. dirname(path) must exist.
url	URL.
auth_token	Token for token-based authentication or NULL.
basic_auth	List with user and password for basic HTTP authentication, or NULL.
quiet	Passed to download.file() or curl::curl_download().
headers	Named character vector of HTTP headers to use.

Details

We respect the download.file.method setting of the user. If it is not set, then see download_method() for choosing a method.

Authentication can be supplied three ways:

• By setting auth_token. This will append an HTTP Authorization header: ⁠Authorization: token {auth_token}⁠.

• By setting basic_auth to a list with elements user and password. This will append a proper ⁠Authorization: Basic {encoded_password}⁠ HTTP header.

• By specifying the proper headers directly.

If both auth_token and basic_auth are specified, that's an error. auth_token and basic_auth are appended to headers, so they take precedence over an Authorization header that is specified directly in headers.

Value

path, if the download was successful.

MangoTheCat/install documentation built on April 7, 2024, 2:56 a.m.