elastic_types 
elastic_types elastic_types is a library for statically-defined document mappings for Rust. It provides tools to define, encode and decode document types efficiently, however they're stored in Elasticsearch.
Define your Elasticsearch types as PORS (Plain Old Rust Structures) and generate an equivalent Elasticsearch mapping from them, where correctness is enforced by Rust's type system. It provides rust implementations of the core Elasticsearch datatypes (like date, geo_point).
It's especially helpful for the date and geo_point types, where serialisation for the various formats is provided for you.
This library makes heavy use of serde for serialisation. We also try not to reinvent the wheel wherever possible and rely on some common dependencies for types, such as chrono for dates and rust-geo for geometry.
This library is the document serialisation provider for the higher-level elastic client.
Add elastic_types to your Cargo.toml:
[dependencies]
elastic_types = "*"
elastic_types_derive = "*"
And reference it in your crate root:
```rust
extern crate elastictypesderive; extern crate elastic_types; ```
Define a custom Elasticsearch type called mytype:
```rust
pub struct MyType { pub timestamp: Timestamp, pub mystring: String, pub mynum: i32 }
type Timestamp = Date
You can then get the mapping for your type as json:
rust
let mapping = serde_json::to_string(&MyType::index_mapping()).unwrap();
Which looks like:
json
{
"properties": {
"timestamp": {
"type": "date",
"format": "epoch_millis"
},
"my_string": {
"type": "text",
"fields": {
"keyword": {
"type": "keyword",
"ignore_above": 256
}
}
},
"my_num": {
"type": "integer"
}
}
}
Types that derive ElasticType are themselves serialisable, which can be very helpful when using types with special formats, like date. Take the following document:
json
{
"id": 15,
"timestamp": 1435935302478,
"title": "my timestamped object"
}
Using the Date type for the timestamp, we can correctly deserialise the document as a strongly typed object:
```rust
struct MyType { id: i32, timestamp: Timestamp, title: String }
type Timestamp = Date
let de: MyType = serdejson::fromstr(json).unwrap();
assert_eq!(2015, de.timestamp.year()); ```
elastic_types_deriveProvides custom derive plugins for Elasticsearch datatypes and mappings in elastic_types and date-specific plugins for the date datatype.