Check Whether Filenames Already Exist in a Session — check_duplicate_files_in

Ask the server which of the supplied filenames already exist as files in the given session. Useful before bulk uploads to detect name collisions in advance.

Usage

check_duplicate_files_in_session(
  vol_id = 1,
  session_id,
  filenames,
  vb = options::opt("vb"),
  rq = NULL
)

Arguments

vol_id: Target volume number. Must be a positive integer.
session_id: Numeric session identifier. Must be a positive integer.
filenames: Character vector of filenames to check. Length must be at least 1; each element must be a non-empty string.
vb: Show verbose messages. (Defaults to FALSE, overwritable using option 'databraryr.vb' or environment variable 'R_DATABRARYR_VB')
rq: An httr2 request object. Defaults to NULL.

Value

A tibble with columns filename (character) and exists (logical), one row per input filename and in the same order. Returns NULL if the request fails. The server answers successfully even when session_id does not exist: every file is reported as exists = FALSE (no rows match that session).

Examples

# \donttest{
if (FALSE) { # \dontrun{
check_duplicate_files_in_session(
  vol_id = 1,
  session_id = 42,
  filenames = c("clip_001.mp4", "clip_002.mp4")
)
} # }
# }