README.md
In smvr: Simple Implementation of Semantic Versioning

smvr

Simple implementation of Semantic Versioning 2.0.0 on R.

smvr provides a lightweight, fully vectorized R class for Semantic Versioning. It enables type-safe manipulation, comparison, and sorting of version numbers, and integrates smoothly with tidyverse tools.

Install the latest release version from CRAN:

install.packages("smvr")

The development version can be installed from GitHub:

pak::pak("eitsupi/smvr")

library(smvr)

# Parse version characters into smvr objects
v <- parse_semver(c("1.0.0", "1.0.0-alpha", "1.0.0-alpha.1", "1.0.1+20250621", "0.9.0"))

# Sort versions
sort(v)
#> <smvr[5]>
#> [1] 0.9.0          1.0.0-alpha    1.0.0-alpha.1  1.0.0          1.0.1+20250621

# Can compare with string notation
v[v < "1.0.0"]
#> <smvr[3]>
#> [1] 1.0.0-alpha   1.0.0-alpha.1 0.9.0

# Works with tibble data frame and dplyr
tibble::tibble(version = v) |>
  dplyr::arrange(version) |>
  dplyr::mutate(
    `>= 1.0.0` = version >= "1.0.0",
    `pre-release` = is_pre_release(version),
  )
#> # A tibble: 5 × 3
#>          version `>= 1.0.0` `pre-release`
#>           <smvr> <lgl>      <lgl>        
#> 1          0.9.0 FALSE      FALSE        
#> 2    1.0.0-alpha FALSE      TRUE         
#> 3  1.0.0-alpha.1 FALSE      TRUE         
#> 4          1.0.0 TRUE       FALSE        
#> 5 1.0.1+20250621 TRUE       FALSE

Fully vectorized Semantic Versioning class.
Type-safe comparison and sorting.
Tidyverse compatibility ({tibble}, {dplyr}, etc.).
No dependencies except {vctrs}.

The number of pre-release identifier fields is limited to 5.

# Only 5 pre-release fields are supported:
try(parse_semver("1.2.3-a.b.c.d.e.f")) # Having 6 dot separated identifiers
#> Error in parse_semver("1.2.3-a.b.c.d.e.f") : 
#>   Unsupported pre-release identifiers in '1.2.3-a.b.c.d.e.f'.
#> ! Only up to 5 pre-release identifiers are supported, got 6.

The semver package is a wrapper for a C++ SemVer parser. The class provided by this package is a special list, which does not work well with {tibble} and {dplyr}.