vmTools

1.0.1

Version Management Tools on the File System

0packages depend

2.2Kdownloads / year

–test coverage

13/13checks pass

Overview

About

Maintained by Sam ByrneFirst published 2025-07-251 releasesCRAN page ↗GitHub ↗

Data version management on the file system for smaller projects. Manage data pipeline outputs with symbolic folder links, structured logging and reports, using 'R6' classes for encapsulation and 'data.table' for speed. Directory-specific logs used as source of truth to allow portability of versioned data folders.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("vmTools", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("epi-sam/vmTools")

Development version from epi-sam/vmTools. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-vmtools

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-vmTools

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-vmTools

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 2.7 min · r-devel-linux-x86_64-fedora-gcc

Code health

Yes

Tests · ratio 0.24

not tracked

Coverage

100%

Documentation · exports

Yes

Vignettes

Yes

README

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Downloads

2.2K

CRAN downloads in the past year

Rank #22,337 · ~6/day · ~182/mo

Releases R versions

Daily download trend is not available in this view yet.

22230 days

53190 days

2.2K1 year

Compare downloads with other packages →

Also on73 r2u21 autocran

Repository

GitHub ↗ epi-sam/vmtools

Dependencies

Declared dependencies

8 external dependencies (excludes base and recommended)

Depends (0)

none

Imports (2)

R6 data.table

LinkingTo (0)

none

Suggests (6)

devtools knitr rmarkdown testthat withr qpdf

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Code Composition

R 4,105 (62%)Vignettes 1,597 (24%)Rd 966 (14%)

Code characteristics

Object systems

S31R61

Cyclomatic complexity: 3.0 median / 12 max
Test cases: 48 / 0.24 per code line
Documented parameters: 100%

Test coverage

Line coverage

–

Expression

–

Tests / Examples

–

Functions

19 2 exported

Complexity

3.7 avg / 12 max

Call network

19 nodes / 8 edges

Test coverage has not been measured for this package yet; nodes fall back to a neutral fill.

Call graph

Open call graph →

Loading call graph…

Lowest coverage

Per-function coverage is not measured for this package yet.

People & History

People (1)

Maintainer (1)

Sam Byrne

Author, Maintainer, Copyright holder

Authors (1)

Sam Byrne

Author, Maintainer, Copyright holder

Sam Byrne

Author, Maintainer, Copyright holder

Release timeline

1 release. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.0.1Latest
2026-03-10 · current release
R
R 4.5.0 released · 2025-04-11

Package metadata

First published: 2025-07-25
Total releases: 1 / 1 yrs
License: MIT + file LICENSE OSI
Download size: 322 KB
Installed size: not tracked yet
With dependencies: not tracked yet