Package 'trud'

Download NHS TRUD item

Description

Downloads files for a specified NHS TRUD item (requires a subscription). By default this is the latest release.

Usage

download_item(
  item,
  directory = ".",
  download_file = "archive",
  TRUD_API_KEY = NULL,
  release = NULL
)

Arguments

item	An integer, the item to be downloaded.
directory	Path to the directory to which this item will be downloaded to. This is set to the current working directory by default.
download_file	The item file to be downloaded. Valid values: "archive" (the release item) "checksum" "signature" "publickKey"
TRUD_API_KEY	A string. The name of an environmental variable containing your TRUD API key. If NULL (default) this is assumed to be called TRUD_API_KEY.
release	The name of a specific release ID to be downloaded (this can be ascertained using get_item_metadata()). If NULL (default), then the latest item release will be downloaded.

Value

The file path to the downloaded file, returned invisibly.

Examples

## Not run: 
 # Download Community Services Data Set pre-deadline extract XML Schema
 x <- download_item(394, directory = tempdir())

 # List downloaded files
 unzip(x, list = TRUE)

 # Download a previous release
 release <- get_item_metadata(394)$releases[[2]]$id

 y <- download_item(394, directory = tempdir(), release = release)

 unzip(y, list = TRUE)

## End(Not run)

# An informative error is raised if your API key is invalid or missing
try(download_item(394, TRUD_API_KEY = "INVALID_API_KEY"))

---

Retrieve metadata for a NHS TRUD item

Description

Sends a request to the release list endpoint, returning a list of metadata pertaining to the specified NHS TRUD item.

Usage

get_item_metadata(item, TRUD_API_KEY = NULL, latest_only = FALSE)

Arguments

item	An integer, the item to be downloaded.
TRUD_API_KEY	A string. The name of an environmental variable containing your TRUD API key. If NULL (default) this is assumed to be called TRUD_API_KEY.
latest_only	If TRUE, only metadata pertaining to the latest item release will be retrieved. By default this is set to FALSE.

Value

A list.

Examples

## Not run: 
 # Get metadata for Community Services Data Set pre-deadline extract XML Schema
 get_item_metadata(394) |>
   purrr::map_at("releases", \(release) purrr::map(release, names))

# Include metadata for any previous releases using `latest_only = FALSE`
get_item_metadata(394, latest_only = FALSE) |>
   purrr::map_at("releases", \(release) purrr::map(release, names))

## End(Not run)

# An informative error is raised if your API key is invalid or missing
try(download_item(394, TRUD_API_KEY = "INVALID_API_KEY"))

---

Get metadata for subscribed NHS TRUD items

Description

A convenience wrapper around trud_items() and get_item_metadata(), retrieving metadata for only items that the user is subscribed to.

Usage

get_subscribed_metadata(TRUD_API_KEY = NULL, latest_only = FALSE)

Arguments

TRUD_API_KEY	A string. The name of an environmental variable containing your TRUD API key. If NULL (default) this is assumed to be called TRUD_API_KEY.
latest_only	If TRUE, only metadata pertaining to the latest item release will be retrieved. By default this is set to FALSE.

Value

A tibble, with item metadata stored in the list column metadata.

See Also

trud_items(), get_item_metadata()

Examples

## Not run: 
get_subscribed_metadata()

## End(Not run)

---

Get available NHS TRUD items

Description

Scrapes this page from the NHS TRUD website for all available items.

Usage

trud_items()

Value

A tibble, with columns item_number and item_name.

Examples

## Not run: 
 trud_items()

## End(Not run)

---