valdr (version 2.2.0)

get_forcedecks_tests_only: Get only ForceDecks test data

Description

Wrapper around get_forcedecks_tests() if the user only wants test-level data without trials.

Usage

get_forcedecks_tests_only(start_date = NULL, include_attributes = FALSE)

Value

Either a data frame containing ForceDecks test-level data, or a list with components tests and attributes if include_attributes = TRUE.

Arguments

start_date

In ISO 8601 UTC format (e.g., "2025-06-25T00:00:00Z") indicating the start of the test retrieval window.

include_attributes

Logical; if TRUE, returns a named list with tests (the test data frame) and attributes (the long-format attributes mapping table). If FALSE (default), returns only the tests data frame.

Examples

if (FALSE) {
# Fetch only tests
tests <- get_forcedecks_tests_only()

# Fetch tests plus attributes mapping
res <- get_forcedecks_tests_only(include_attributes = TRUE)
tests <- res$tests
attrs <- res$attributes
}