# `tarantool-rs` - Asyncronous Tokio-based client for Tarantool (WIP)
[](https://crates.io/crates/tarantool-rs)
[](https://docs.rs/tarantool-rs/latest)

`tarantool-rs` - asyncronous Tokio-based client for [Tarantool](https://www.tarantool.io).
Documentation available on [docs.rs](https://docs.rs/tarantool-rs/latest).
### Supported Traantool versions
Supported and tested Tarantool versions:
* `2.10.x`;
* `2.11.x`.
Other (especially newer) should work as well, but not tested. Versions below `2.10.x`
doesn't have transactions support, so transaction API won't work.
### Example
If you have `clients` space with 2 "columns": `id` and `name`:
``` rust
let conn = Connection::builder().build("127.0.0.1:3301").await?;
let space = conn.space("clients").await?.expect("clients space exists");
space.insert((1, "John Doe")).await?;
let clients = space.select::<(i64, String), _>(None, None, Some(IteratorType::All), ()).await?;
```
For more examples of how to use this crate check `examples/` folder.
## Features
* [x] authorization
* [x] evaluating Lua expressions
* [x] remote function calling
* [x] CRUD operations
* [x] transaction control (begin/commit/rollback)
* [x] reconnection in background
* [x] SQL requests
* [ ] chunked responses
* [ ] watchers and events
* [ ] connection pooling
* [ ] automatic schema fetching and reloading
* [ ] graceful shutdown protocol support
* [ ] pre Tarantool 2.10 versions support
* [ ] customizable connection features (streams/watchers/mvcc)
* [ ] custom Tarantool MP types (UUID, ...)
* [ ] ...