hostcat: Curated datasets at data.rmorie.com

View source: R/data_hub.R

hostcatR Documentation

Curated datasets at data.rmorie.com

Description

Beyond the open data this package ships, the MORIE project keeps more than 160 databases materialised from Google BigQuery public datasets (Chicago crime, EPA air quality, US census, FEC, FDA, NOAA, NHTSA, Hacker News, Ethereum, World Bank, ...) and serves their tables from the edge. They need no sign-in; a MORIE key stored earlier by rmorie, morie or rmoriebricklayer is still sent. hostcat() returns every table with its key, description, rows and BigQuery source (the manifest is kept for a day); hostload("db/table") returns one table, cached under the package cache directory (tempdir() unless options(rmoriedata.cache_dir = ) names a persistent one).

Usage

hostcat(refresh = FALSE)

hostlogin(
  token = NULL,
  email = NULL,
  code = NULL,
  openbro = interactive(),
  ...
)

hostload(key, refresh = FALSE)

Arguments

refresh

Fetch again even when a day-old copy is cached.

token, email, code, openbro

Passed to rmoriebricklayer::dlogin(): a key you already hold (no longer needed for the tables, which open without sign-in), or an email address (a one-time code is sent; pass it as code in a non-interactive session). With neither, the GitHub device flow runs. The service address comes from the signed services document (rmoriebricklayer::svcs()).

...

Passed to rmoriebricklayer::dlogin(): the data access terms and who is asking, which a new key needs (accter, name, affil, purp, restr, supnm, suprole, supemail); what is not given is asked at the console.

key

A db/table key from the catalog.

Value

hostlogin(): the key, invisibly, after storing it in the shared credentials file. hostcat(): a data frame with key, name, rows and source; hostload(): the table as a data frame.

Examples

## Not run: 
head(hostcat())
df <- hostload("chicago_crime/incidents")

## End(Not run)

rmoriedata documentation built on Nov. 12, 2026, 9:06 a.m.