devtools (version 1.2)

source_url: Run a script through some protocols such as http, https, ftp, etc.

Description

Internally, source_url calls getURL in RCurl package and then read the contents by textConnection, which is then sourceed. See ?getURL for the available protocol.

Usage

source_url(url, ..., sha1 = NULL)

Arguments

url

url

...

other options passed to source

sha1

The SHA-1 hash of the file at the remote URL

Details

If a SHA-1 hash is specified with the sha1 argument, then this function will check the SHA-1 hash of the downloaded file to make sure it matches the expected value, and throw an error if it does not match. If the SHA-1 hash is not specified, it will print a message displaying the hash of the downloaded file. The purpose of this is to improve security when running remotely-hosted code; if you have a hash of the file, you can be sure that it has not changed.

Examples

source_url("https://raw.github.com/gist/1654919/8161f74fb0ec26d1ba9fd54473a96f768ed76f56/test2.r")

# With a hash, to make sure the remote file hasn't changed
source_url("https://raw.github.com/gist/1654919/8161f74fb0ec26d1ba9fd54473a96f768ed76f56/test2.r",
  sha1 = "fc6551f13ceddcbe0730ff74c4300f2682c74028")