R Package

The dvs R package wraps the dvs core. Each function returns a native R object: the verbs return tibbles, dvs_init() returns a list. New to dvs? Start with the R walkthrough in Getting Started.

🔗Functions

One page per function, covering every parameter.

• dvs_init(): initialize a project and configure storage.
• dvs_add(): track files in storage.
• dvs_status(): report the sync status of tracked files.
• dvs_get(): restore files from storage.

🔗Helpers

R-only utilities that sit outside the four-verb workflow. They configure the dvs core process-wide (threads, logging) or format its output. The CLI exposes the same controls through flags and environment variables.

• set_dvs_threads(): set the process-wide thread pool size.
• set_dvs_log_level(): route core log output to the R console.
• format_byte_size(): human-readable byte sizes.
• new_dvs_bytes(): the dvs_bytes vector type and pillar printing.
• dvs_version(): report the core crate version.

🔗How the R surface differs from the CLI

The R functions and the CLI cover the same operations with different shapes:

• R returns native data frames and lists; there is no --json.
• dvs_status() always returns the metadata columns; the CLI hides them behind --with-metadata.
• Threads are set process-wide with set_dvs_threads(); the CLI takes a per-call --threads.
• dvs_init() uses compression = c("zstd", "none"); the CLI uses a --no-compression flag.

🔗Installation (advanced users)

With rv:

rv add dvs --git https://github.com/A2-ai/dvs2 --branch main --directory dvs-rpkg