Skip to contents

Sign in for the curated tables at data.rmorie.com

Source: R/llm_native.R
dlogin.Rd

Stores your personal MORIE data key in $XDG_CONFIG_HOME/morie/credentials.json (owner-only; the file the morie, rmorie and rmoriedata packages read too, so one sign-in serves all of them). The key opens the curated tables (dload); it is not used for language models, which run on your own key or a local model (llmask). Keys are personal: the GitHub or emailed-code sign-in issues one, or ask at www.rmorie.com/access/. The sign-in addresses come from svcs. Three ways in:

  • token: a key you already have, from the website or an email. It is checked with the service first and stored only when it is accepted; a refused key, or no answer, stores nothing.

  • email: a one-time code is sent to the address (valid ten minutes, single use); you type it, or pass code.

  • neither: the GitHub device flow; a code is shown to enter at github.com, and the key arrives once you approve.

Nothing is written except by this explicit call.

Usage

dlogin(
  token = NULL,
  email = NULL,
  code = NULL,
  openbro = interactive(),
  pollmaxsec = 600,
  accter = FALSE,
  name = NULL,
  affil = NULL,
  purp = NULL,
  restr = NULL,
  supnm = NULL,
  suprole = NULL,
  supemail = NULL
)

Arguments

token

Character scalar or NULL (the default): a key you already have, issued at www.rmorie.com/access/. Surrounding spaces are removed. Takes precedence over email.

email

Character scalar or NULL (the default): sign in with a one-time code sent to this address. Lower-cased before use.

code

Character scalar or NULL (the default): the emailed code when you already have it; NULL sends a new code and asks for it at the console. Used only with email.

openbro

Logical scalar, default interactive(): open the GitHub page for the device flow in the system browser (only a public https address is opened).

pollmaxsec

Numeric scalar, default 600: how many seconds the device flow waits for you to approve the sign-in.

accter

Logical scalar, default FALSE: TRUE accepts the data access terms (read them at data.rmorie.com/terms) without the console asking. A new key is issued only once they are accepted, here or at the prompt.

name

Character scalar or NULL: your name (asked for when NULL). Required for a new key.

affil

Character scalar or NULL: your university, employer or organisation (optional; asked for when NULL).

purp

Character scalar or NULL: why you need the data, a sentence or two (asked for when NULL). Required for a new key.

restr

Logical scalar or NULL: TRUE also accepts Schedule B of the terms, which opens the restricted tables (ICPSR, NCVS 38604, A2AJ case law); NULL asks at the console.

supnm, suprole, supemail

Character scalars or NULL: the supervisor, department chair, director or coordinator who knows of your use, their role and their email. Required with restricted = TRUE; asked for when NULL. The role is one of "supervisor", "chair", "director", "coordinator" or "other".

Value

The key (character scalar), invisibly. A message names the file it was stored in.

Details

The credentials file is edited as text: only the three members this package owns (hosted_key, hosted_user and hosted_base_url, the address the key was issued for) are set, and every other byte stays, so entries written by the other packages survive. The file is written through a fresh temporary name, created owner-only (mode 0600, folder 0700 on Unix) before the key is written. A file that is not a JSON object, is not valid JSON or names a member twice is refused rather than overwritten. XDG_CONFIG_HOME moves the file; when unset it is ~/.config/morie/credentials.json.

The sign-in service address is the signed services document's data.auth_url (see svcs), or the environment variable MORIE_HOSTED_AUTH_URL when set (it must be a public https address). The device flow polls every interval seconds the service names (5 by default), prints a progress line about every 30 seconds, and stops with an error after pollmaxsec.

Errors: an empty token; a token the data service does not accept, or no answer from it (nothing is stored); an email that is empty or not of the form name@domain.tld; no code typed at the prompt; a refused code; a sign-in service that answers with an error or returns no key; a credentials file that cannot be edited safely.

See also

dlogout to remove the key.

Examples

old <- Sys.getenv("XDG_CONFIG_HOME", unset = NA)
Sys.setenv(XDG_CONFIG_HOME = tempfile()) # never touch your real credentials

# input checks that need no network
try(dlogin(token = "   "))
#> Error : an empty token cannot be stored
try(dlogin(email = "not-an-email"))
#> Error : dlogin: 'not-an-email' is not an email address

if (is.na(old)) {
  Sys.unsetenv("XDG_CONFIG_HOME")
} else {
  Sys.setenv(XDG_CONFIG_HOME = old)
}
if (FALSE) { # interactive()
# these contact the sign-in service
dlogin(token = "<key issued at https://www.rmorie.com/access/>")
dlogin(email = "you@example.com")
dlogin(email = "you@example.com", code = "123456")
dlogin() # GitHub device flow; asks for the terms, name and reason
# everything given up front, for a script
dlogin(accter = TRUE, name = "Ada Lovelace",
                     purp = "Course project on court delays in Ontario.")
}