Build status Coverage

datr allows R users to interact with the Dat network. You can load, store, or share data on the Dat network, without including any intermediaries that can snoop on your content. All transfers are end-to-end encrypted.

Example

GIF of demo

or in plain text

datr::dat_install(os = 'linux')

datr::clone_dat('dat://0286381d95864386a83aadb136a60c1d09d079c5a4ff0e403fa126644ba4c6ab',
 dir = '~/test-datr/')

dir.create('~/test-datr-sharing')
setwd('~/test-datr-sharing')

datr::create_dat()

write.csv(data.frame(x = rnorm(100, 0, 1), y = rnorm(100, 50, 23)),
 '~/test-datr-sharing/test-data.csv',
 row.names = FALSE)

datr::sync_dat()

Installation

You can install datr from GitHub with:

# install.packages("devtools")
devtools::install_github("libscie/datr")

See below for Windows, Mac, and Linux specific instructions for installing Dat. v0.1.0 will be submitted to CRAN (almost done šŸ)!

Windows

Fire up R with Administrator privileges by right clicking the icon and selecting ā€œRun as administratorā€

Run as administrator

Once the program launches, run datr::dat_install(). The package then initiates downloading Dat and installs it on your local machine.

Upon completion, reboot R and you can start using the package šŸ˜» (adminstrator privileges no longer needed)

Mac

devtools::install_github('libscie/datr', ref = 'install')
datr::dat_install(os = 'macos')

Note that there currently is an issue out that could benefit from feedback on installation on Mac (#7).

Linux

Run datr::dat_install(os = 'linux') from your R console. Thereā€™s no need to specify which flavor of Linux youā€™re running, but you might to need to restart your R session šŸ™‹

Code of conduct

This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. We welcome you with open arms if you are mindful and respectful of differences. You might not always understand another personā€™s perspective; acknowledging that other peopleā€™s feelings or perspectives are valid regardless of your understanding is prerequisite number one to being both mindful and respectful. We will not consider contributions if they are not done in a respectful manner, no matter how ā€œgeniusā€ they might be.

License

All code is licensed GPLv3. All non-code assets are available under a CC 0 Public Domain Dedication.