Two call shapes:

queueRead(folder, name, sheet = NULL, col_types = "c")

Arguments

folder

Either a local path to an .rds queue file (when name is missing), or a Drive folder URL / dribble of the parent folder containing the queue spreadsheet.

name

Spreadsheet name (exact match) within folder. Omit for local-RDS reads.

sheet

Optional worksheet/tab name (passed to read_sheet()). Ignored for local-RDS reads.

col_types

Column-types spec for read_sheet() (default "c"). Ignored for local-RDS reads.

Value

A data.table. Pipe through as_scenario() for scenario records.

Details

Local: queueRead("path/to/queue.rds")

When the first argument is an existing local .rds file and name is not supplied, the queue is loaded via readRDS(). Useful for the file-backed queues written by experimentTmux() / experimentFuture() / experimentSBATCH() when no ss_id was supplied.

Google Sheet: queueRead(folder, name)

Convenience wrapper around googledrive::drive_ls() + googlesheets4::read_sheet(). folder is the Drive folder URL/id, name is the spreadsheet name within it.

Either way the result is passed through revertDotNames() so callers see canonical .ELFind/.GCM/... column names rather than the dotELFind/dotGCM/... names Google Sheets forces. As a side effect, the non-meta column names are cached as the active scenario field set (see scenarioFields()).