In INWTlab/rsync: API to use rsync

Rsync as R-Package

rsync is a open source file-copying tool that is freely available under the GNU General Public License. This is a R package providing an API to rsync from R.

Why use rsync:

Rsync is a tool, which is used with Unix systems and allows efficient transferring and synchronizing of files across systems. It is widely used for making backups, copying files or mirroring them.

Working with Rsync offers nice benefits, as it is: - fast - works remotly and locally - minimizes data transfer, as it only transfers the changes within the files - supports copying links, devices, owners, groups, and permissions

For further information about rsync, please visit https://rsync.samba.org/.

Similar and very popular alternatives exist. E.g. in contrast to AWS S3 the solution here:

• Is free,
• fast(er), if you stay in your local network,
• but, S3 provides versioning, which is very neat.

Installation:

The rsync R package can be downloaded and installed by running the following command from the R console:

```{R, eval = FALSE} devtools::install_github("INWTlab/rsync")

Make sure you have the `rsync` command line tool available.


## Examples

You create a rsync configuration using:

```{R}
library(rsync)
dir.create("destination")
dir.create("source")
dest <- rsync(dest = "destination", src = "source")
dest

In the case of an rsync daemon you can also supply a password. The way you think about transactions is that we have a destination folder with which we want to interact. All methods provided by this package will always operate on the destination. It will not change the source, in most cases. An exception is sendObject, that will also create a file in source.

x <- 1
y <- 2
sendObject(dest, x)
sendObject(dest, y)

We can see that we have added two new files. These two files now exist in the source directory and the destination. The following examples illustrate the core features of the package:

removeAllFiles(dest) # will not change source
sendFile(dest, "x.Rdata") # so we can still send the files
removeAllFiles(src <- rsync("source")) # make the source a destination
getFile(dest, "x.Rdata")
src

# Clean-up
removeAllFiles(src)
removeAllFiles(dest)
file.remove("destination")
file.remove("source")

INWTlab/rsync documentation built on Sept. 28, 2023, 5:22 p.m.