Skip to contents

Make a share link

cellucid_dataset_share_link.Rd

The public link that opens the dataset shown on www.cellucid.com for anyone, with its "Open in Cellucid" badge and an embed snippet, as Share in Session › Open data makes them; what a link carried to grant access is left out. Refused for a dataset no link reopens (a file of this computer, a notebook's, a server on this computer).

Usage

cellucid_dataset_share_link(viewer)

Arguments

viewer

A viewer cellucid_view() or cellucid_serve() returned.

Value

A cellucid_action_request, at once and invisibly: the action is sent now, or when the viewer's channel opens. cellucid_action_result(request) returns its outcome: a list of access_left_out (The dataset's link carried a key, a signature or a token that was left out: someone without access cannot open it), badge (The badge as Markdown), embed (The embed snippet as HTML), link (The link).

Details

The viewer's action dataset.share-link (Datasets). It acts outside the viewer's state and history (a file the person receives in the browser, a publication, or what the browser keeps for later visits), which Undo does not take back: it makes no step of the history.

It publishes for others to see, so the viewer asks the person first (publishes), from R too, as when an agent (Claude, ChatGPT) runs it; cellucid_action_result(request) waits for their answer (call it again if its timeout passes first).

See also

cellucid_act() sends any action by its type, and cellucid_action_result() collects its answer.

Examples

if (interactive() && requireNamespace("SeuratObject", quietly = TRUE)) {
  data("pbmc_small", package = "SeuratObject")
  viewer <- cellucid_view(SeuratObject::UpdateSeuratObject(pbmc_small))
  request <- cellucid_dataset_share_link(viewer)
  print(request)
  # cellucid_action_result(request) waits for its outcome.
  cellucid_stop(viewer)
}