-
Notifications
You must be signed in to change notification settings - Fork 4
/
README.Rmd
86 lines (67 loc) · 2.47 KB
/
README.Rmd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
---
output: github_document
---
<!-- README.md is generated from README.Rmd. Please edit that file -->
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%",
eval = FALSE
)
```
# groundhog
<!-- badges: start -->
[](https://cran.r-project.org/package=groundhog)
[](https://github.com/CredibilityLab/groundhog/actions)
[](https://codecov.io/gh/CredibilityLab/groundhog?branch=master)
<!-- badges: end -->
## Installation
groundhog has not yet been released on CRAN and must be installed from our
custom repository:
```{r}
install.packages("groundhog", repos = "https://cran.groundhogr.com")
```
## Example 1 - Recovering broken code with backwards incompatible change in dplyr
With version 0.5, [dplyr](https://dplyr.tidyverse.org/) changed how the
[`distinct`](https://dplyr.tidyverse.org/reference/distinct.html) function
worked, leading to dropped variables:
Say you have data with repeat values of `x`:
```{r}
df1 <- data.frame(
x1 = c(1, 1, 2),
x2 = c("a", "b", "c")
)
```
To drop repeated rows you can use the package dplyr and run:
```{r}
dplyr::distinct(df1, x1)
```
The problem is that in June 2016, the function
[`dplyr::distinct()`](https://dplyr.tidyverse.org/reference/distinct.html) was
modified in a non backwards-compatible way. Up to that date it would keep all
variables but, afterward the SAME function drops all other variables, The same
line of code, run in the same computer, on the same date, has one effect before
june 2016 vs after.
With groundhog the script tells us which version of dplyr to use keeping the
same results:
```{r eval = FALSE}
library(groundhog)
# if before the change, then both variables are kept
groundhog.library("dplyr", date = "2016-06-22")
```
```{r, include = FALSE, echo = FALSE, plot = FALSE}
library(groundhog)
groundhog.library("dplyr", date = "2016-06-22", ignore.package.conflicts = TRUE)
```
```{r}
distinct(df1, x1)
```
```{r}
# if after the change, only x1 is kept
#Now as it was two days after
#IMPORTANT: since another version of dplyr is loaded, we do CTRL-SHIFT-F10 to restart the R Session and load the newer version
groundhog.library("dplyr",date = "2016-06-26")
distinct(df1, x1)
```