Maintainers: Karthik Ram (@karthik) and Clayton Yochum (@ClaytonJY)
This package provides programmatic access to Dropbox from R. The functions in this package provide access to a full suite of file operations, including dir/copy/move/delete operations, account information and the ability to upload and download files from any Dropbox account.
# Current CRAN version (0.8.1) install.packages('rdrop2') # or the development version (0.8.1.9999) devtools::install_github("karthik/rdrop2")
library(rdrop2) drop_auth() # This will launch your browser and request access to your Dropbox account. You will be prompted to log in if you aren't already logged in. # Once completed, close your browser window and return to R to complete authentication. # The credentials are automatically cached (you can prevent this) for future use. # If you wish to save the tokens, for local/remote use token <- drop_auth() saveRDS(token, file = "token.rds") # Then in any drop_* function, pass `dtoken = token # Tokens are valid until revoked.
Retrieve Dropbox account information
library(dplyr) drop_acc() %>% data.frame() # Returns the following fields #  "account_id" "name.given_name" #  "name.surname" "name.familiar_name" #  "name.display_name" "name.abbreviated_name" #  "email" "email_verified" #  "disabled" "country" #  "locale" "referral_link" #  "is_paired" ".tag"
Dropbox directory listing
write.csv(mtcars, "mtcars.csv") drop_upload("mtcars.csv") drop_dir() # If your account is not empty, it returns the following fields #  ".tag" "name" "path_lower" #  "path_display" "id" "client_modified" #  "server_modified" "rev" "size" #  "content_hash" # # # or specify a path drop_dir('public/gifs')
Filter directory listing by object type (file/folder)
drop_dir() %>% filter(.tag == "folder")
Create folders on Dropbox
drop_create('drop_test') # or provide the full path where it needs to be created drop_create('public/drop_test')
Upload a file into Dropbox
write.csv(mtcars, 'mtcars.csv') drop_upload('mtcars.csv') # or upload to a specific folder drop_upload('mtcars.csv', path = "drop_test")
You can also do this for any other file type and large files are supported regardless of your memory.
Download a file
drop_download('mtcars.csv') # or add path if file is not in root drop_download("test_folder/mtcars.csv")
Delete a file
drop_create("new_folder") drop_move("mtcars.csv", "new_folder/mtcars.csv")
drop_create("new_folder2") drop_copy("new_folder/mtcars.csv", "new_folder2/mtcars.csv")
Search and download files
I frequently use a duck season rabbit season gif. This is how I could search and download from my public Dropbox account.
x <- drop_search("rabbit") drop_download(x$matches[]$metadata$path_lower, local_path = '~/Desktop/bugs.gif') # Downloaded /public/gifs/duck_rabbit.gif to ~/Desktop/bugs.gif: 329.2 Kb on disk
Read csv files directly from Dropbox
write.csv(iris, file = "iris.csv") drop_upload("iris.csv") # Now let's read this back into an R session # Note that there is a quiet download happening to your temp dir new_iris <- drop_read_csv("iris.csv")
Accessing Dropbox on Shiny and remote servers
If you expect to access a Dropbox account via Shiny or on a remote cluster, EC2, Digital Ocean etc, you can leave the cached
oauth file in the same directory, or pass the
token explicitly to
drop_auth. You can also save the output of
drop_auth into an R object, sink that to disk, and pass that as a token. If using on Travis or similar, you should consider encrypting the oauth cache file to prevent unauthorized access to your Dropbox account. If you have multiple tokens and accounts, it is also possible to override the environment token and explicitly pass a specific token for each
token <- drop_auth() saveRDS(token, "droptoken.rds") # Upload droptoken to your server # ******** WARNING ******** # Losing this file will give anyone # complete control of your Dropbox account # You can then revoke the rdrop2 app from your # dropbox account and start over. # ******** WARNING ******** # read it back with readRDS token <- readRDS("droptoken.rds") # Then pass the token to each drop_ function drop_acc(dtoken = token)