Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/edwindj/daff
Diff, patch and merge for data.frames, see http://paulfitz.github.io/daff/
https://github.com/edwindj/daff
daff data diff r
Last synced: 2 months ago
JSON representation
Diff, patch and merge for data.frames, see http://paulfitz.github.io/daff/
- Host: GitHub
- URL: https://github.com/edwindj/daff
- Owner: edwindj
- License: other
- Created: 2015-02-17T12:23:31.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-15T07:46:35.000Z (11 months ago)
- Last Synced: 2024-10-28T17:26:48.986Z (2 months ago)
- Topics: daff, data, diff, r
- Language: R
- Homepage: https://edwindj.github.io/daff/
- Size: 1.77 MB
- Stars: 152
- Watchers: 11
- Forks: 18
- Open Issues: 12
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - edwindj/daff - Diff, patch and merge for data.frames, see http://paulfitz.github.io/daff/ (data)
- jimsghstars - edwindj/daff - Diff, patch and merge for data.frames, see http://paulfitz.github.io/daff/ (R)
- StarryDivineSky - edwindj/daff
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
[](https://github.com/edwindj/daff/actions/workflows/R-CMD-check.yaml)
# Daff: diff, patch and merge for data.frames
daff is an R package that can find difference in values between
`data.frames`, store this difference, render it and apply this
difference to patch a `data.frame`. It can also merge two versions of a
`data.frame` having a common parent. It wraps the
[daff.js](http://paulfitz.github.io/daff/) library using the
[V8](https://github.com/jeroen/v8) package.
The diff format is described in
.
Functions:
- diff: `diff_data`
- patch: `patch_data`
- write/read diff: `read_diff` and `write_diff`
- render to html: `render_diff`
- merge two tables based on a same version: `merge_data`
## Installation
You can install the development version of daff from [GitHub](https://github.com/) with:
``` r
# install.packages("devtools")
devtools::install_github("edwindj/daff")
```
# Usage
## diff_data
Calculate the difference between a reference and a changed `data.frame`
``` r
library(daff)
y <- iris[1:3,]
x <- y
x <- head(x,2) # remove a row
x[1,1] <- 10 # change a value
x$hello <- "world" # add a column
x$Species <- NULL # remove a column
patch <- diff_data(y, x)
# write a patch to disk
write_diff(patch, "patch.csv")
```
`render_diff(patch)` will generate the following HTML page:
render_diff
## patch_data
Patch a `data.frame` using a diff generated with `diff_data`.
``` r
# read a diff from disk
patch <- read_diff("patch.csv")
# apply patch
y_patched <- patch_data(y, patch)
```
## merge_data
Merge two `data.frame`s that have diverged from a common parent
`data.frame`.
``` r
parent <- a <- b <- iris[1:3,]
a[1,1] <- 10
b[2,1] <- 11
# succesful merge
merge_data(parent, a, b)
parent <- a <- b <- iris[1:3,]
a[1,1] <- 10
b[1,1] <- 11
# conflicting merge (both a and b change same cell)
merged <- merge_data(parent, a, b)
merged #note the conflict
#find out which rows contain a conflict
which_conflicts(merged)
```