z-developers-vignette-save-the-nix-package-versions-data.Rmd

---
title: "z - Developers Vignette: Save the Nix Package Versions data"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{z-developers-vignette-save-the-nix-package-versions-data}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>"
)
```

```{r, include=FALSE}
library(rix)
```

This vignette is only needed for the developers of `{rix}`.

To install old versions of R, specific Nix revisions must be used. This tool
[Nix Package Versions](https://lazamar.co.uk/nix-versions/) provides a simple
web-interface to look for packages and get their revisions.

It is possible to scrape the table and get the data, but the code below
should not be executed and is instead kept for historcial reasons:

```
library(rvest)
library(dplyr)
library(janitor)

r_nix_revs <- read_html("https://lazamar.co.uk/nix-versions/?channel=nixpkgs-unstable&package=r") |>
  html_element("table") |>
  html_table() |>
  clean_names() |>
  filter(!grepl("wrapper", version)) |>
  select(-package)

```

The code above provided commits up until version 4.3.1. The commit for the 4.3.2
release does not use the above code, instead we manually chose the last commit
that contains all the fixes that were merged during this release. This ensures
that a maximum of packages are in a working state.


```{r parsermd-chunk-1, eval = TRUE}
library(rix)

data("r_nix_revs")

revision_4.3.2 <- as.data.frame(
  list(
    "version" = "4.3.2",
    "revision" = "219f896bdf192721446db4fedc338eebf732057d",
    "date" = "2024-03-10"
  )
)

r_nix_revs <- rbind(r_nix_revs,
                    revision_4.3.2)
```