Release boxr v0.3.1 · r-box/boxr

New Features

box_search (and convenience functions box_search_files, box_search_folders, 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_excel Finally support for everyone else's favorite way to store data!
box_write A 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_description A 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_auth A convenience function for users having trouble authenticating -- it will delete existing tokens (which are by default hidden files) for a fresh authentication process
S3 classes for files, folders, and object lists
Objects of class boxr_object_list can be passed directly to functions in place of a file_id string
Objects of class boxr_object_list now have an as.data.frame method

Example of usage with magrittr pipes is added to the README
box file/folder id's are now validated locally before requests are sent
Filenames are now validated locally, with helpful/informative error mesages
box_read now accepts a user specified read function, which is now by default rio::import
box_read will now try and do the right thing for files without an extension by considering the MIME type of the API response
S3 classes and methods have been consolidated into three basic types, and functions now use them in a consistent manner. Now documented for those interested (?boxr_S3_classes)
Print methods: Prettier and more informative
box_getwd no longer logs an uninformative message
Documentation / collaboration improvements (improved function documentation, variable naming conventions, and a code of conduct)
Improved tests

options(boxr.progress = TRUE) is now respected consistently
Fix for spurious warnings comming from the latest version of httr (see jeroen/curl#30 and r-lib/httr#252)
Fix for weird reporting for certain valid API queries, which return exactly 0 results