dvs_add.Rd
copy files to the storage directory
dvs_add(files, message = NULL, split_output = FALSE)
file paths or glob patterns to add to the storage directory
optional: a message associated with the file(s) for versioning context to appear in dvs metadata files
optional: when TRUE
, a list of two data frames is returned:
successes
and failures
.
rows in successes
are successfully added file inputs
rows in failures
are inputs that returned errors
when FALSE
, the output is a single data frame whose rows are the files
attempted to add in the given operation, the successes or failures of which are indicated in the
outcome
column
one or two data frames whose rows are the files attempted to add in the given operation.
after initializing the storage directory with dvs_init, this command copies files to storage directory for other collaborators to version and retrieve with dvs_get If an explicitly inputted file doesn't exist, the command returns an error .
For any other error retrieving a particular file, the function itself will indicate the error type and message in the data frame output; the function itself will not return an error.
if (FALSE) { # \dontrun{
# would add all csv files in data/derived to the initialized storage directory
dvs_add("data/derived/*.csv")
# would add model/nonmem/1001/1001.ext and all files in data/derived
# to the initialized storage directory (excluding dvs metadata and .gitignore files)
dvs_add(c("model/nonmem/1001/1001.ext", "data/derived/*"))
} # }