Which IRW version was live, and what every dataset was pinned to

IRW is made of eleven Redivis datasets that are versioned independently, so no single Redivis version describes the corpus. The IRW version number does: it increments whenever any dataset is published and names one exact combination of the eleven. Cite it in a paper and a reader can reconstruct the data you used.

Usage

irw_version(date = NULL, version = NULL)

Arguments

date

Optional. A date or time to look up, as "2026-08-01", "2026-08-01 12:00:00", or a Date/POSIXct.

version

Optional. An IRW version number, e.g. 332. Mutually exclusive with date. Defaults, with date, to the newest version.

Value

A data frame with one row per dataset and columns dataset, version, released_at, and approximate. The IRW version number is attached as the attribute irw_version and printed as a message.

Details

Called with no argument, reports the newest IRW version. Called with a version, reports exactly what that version held. Called with a date, reports the version that was live then – which is how you recover what an analysis run months ago was actually reading.

Use irw_use_version() to make the session read one of these versions.

Dates before 21 July 2026 are approximate

Redivis overwrote its own release timestamps for the older warehouse shards during a platform migration: 142 of the corpus' 332 released versions claim to have been released inside one 80-minute window on 2026-07-21. For those, the manifest records the earliest date the version could have been live (its creation date) and marks the row bracketed. A lookup that lands on one warns, because the tag may then be wrong too – a later version could already have been released inside the bracket. IRW version numbers themselves are always exact; only the mapping from a date to a version is affected. This is why a paper should cite the number, not the date.

See also

irw_use_version() to read a whole IRW version, irw_set_version() to pin one dataset, irw_get_version() for the versions the current session is actually reading.

Examples

if (FALSE) { # \dontrun{
irw_version()                # the newest IRW version, and its eleven pins
irw_version(version = 332)   # exactly what v332 held
irw_version("2026-08-01")    # what was live on 1 August 2026
} # }