An R interface for the remote file hosting service 'Box' (< https://www.box.com/>). In addition to uploading and downloading files, this package includes functions which mirror base R operations for local files, (e.g. box_load(), box_save(), box_read(), box_setwd(), etc.), as well as 'git' style functions for entire directories (e.g. box_fetch(), box_push()).
httrfor progress bars means that some work-around can be removed
box_search(and convenience functions
box_search_trash) allow use of box.com's superb searching facilities to find files and folders. Various parameters can be set to search filenames, file contents, and to limit searches to certain file types. Results are summarised by default, can be coerced via
as.data.frame. They can also be passed in place of a file_id to other boxr functions (e.g.
box_dl) to perform an operation on the first result.
box_read_excelFinally support for everyone else's favorite way to store data!
box_writeA convenience function to convert R objects to common file types (e.g. .json, .csv, .tsv, .xlsx, etc.), and upload to box. Using the default write function (rio::export), the file type can be determined automatically from the filename provided.
box_add_descriptionA simple way to add a description to a file on box.com. These are a useful way to decribe the contents of a file, and can also be used like commit messages on GitHub, to describe recent changes made.
box_fresh_authA convenience function for users having trouble authenticating -- it will delete existing tokens (which are by default hidden files) for a fresh authentication process
boxr_object_listcan be passed directly to functions in place of a file_id string
boxr_object_listnow have an
magrittrpipes is added to the README
box_readnow accepts a user specified read function, which is now by default
box_readwill now try and do the right thing for files without an extension by considering the MIME type of the API response
box_getwdno longer logs an uninformative message
options(boxr.progress = TRUE)is now respected consistently
httr(see jeroenooms/curl#30 and hadley/httr#252)
Note: Skipped a version increment for CRAN iterations
Now up on CRAN:
This release contains small changes to help new users get started (especially those who don't get to see the GitHub README).
vignette("boxr")) is now more oriented towards getting new users up and running (fc931cd), providing much of the same information as at
?box_auth, but with screenshots and friendlier formatting
!file.exists("~/.boxr_oauth")), the code to generate the Getting Started vignette is presented (e18864d)
?boxrnow takes the user to a summary of the package, which links back to the Getting Started vignette (#31)
boxr v0.2.6 is on CRAN, the following will do the trick:
box_setwd()now write to the correct options vars (e.g., work properly again) (#27)
box_readhave been added (#25):
box_previous_versionsallows you to query previous versions of a file
box_dlcan now download specific versions of a file, via either the