# rust-dropbox
[](https://crates.io/crates/rust-dropbox)
A convenient tool binding to the Dropbox APIv2,
Now it can operate `user_check`,`upload(file size below 150 MB)`, `move` and `download`.
It will handle error messages from Dropbox api.
And there is a async api can be activate by feature `non-blocking`.
For use, you need a Dropbox [access token](https://www.dropbox.com/developers/apps/)
# Installation
- Find on [crates.io](https://crates.io/crates/rust-dropbox)
- Use [cargo-edit](https://crates.io/crates/cargo-edit)
```sh
cargo add rust-dropbox
```
# How to use
### blocking api
- upload
```rust
use rust_dropbox::*
use std::env;
use std::{
fs::File,
io::Read,
};
let token = env::var("DROPBOX_TOKEN").unwrap();
let mut file = File::open("./profile.jpg").unwrap();
let mut buf: Vec<u8> = Vec::new();
file.read_to_end(&mut buf).unwrap();
let client = client::DBXClient::new(&token);
let option = UploadOptionBuilder::new().build();
let res = client.upload(buf, "/test/profile.jpg", option);
assert!(res.is_ok())
```
- move
```rust
use rust_dropbox::*
use std::env;
let token = env::var("DROPBOX_TOKEN").unwrap();
let client = client::DBXClient::new(&token);
let option = MoveCopyOptionBuilder::new()
.allow_ownership_transfer()
.allow_shared_folder()
.allow_auto_rename()
.build();
let res = client.move_file("/test/profile.jpg", "/profile.jpg", option);
assert!(res.is_ok())
```
- download
```rust
use rust_dropbox::*
use std::env;
use std::{
fs::File,
io::Write,
};
let token = env::var("DROPBOX_TOKEN").unwrap();
let client = client::DBXClient::new(&token);
let res = client.download("/profile.jpg");
let bytes = res.unwrap();
let mut file = File::create("new_profile.jpg").unwrap();
file.write_all(&bytes).unwrap();
```
### To use non-blocking api
```toml
rust-dropbox={version=*,default-features=false,features=["non-blocking"]}
```