adds rust bindings and grpc lib

.gitignore

@@ -1 +1,2 @@
 .idea
+target/

Cargo.toml

@@ -0,0 +1,4 @@
+[workspace]
+members = [
+  "rust"
+]

rust/Cargo.toml

@@ -0,0 +1,31 @@
+[package]
+name = "stac-proto"
+version = "0.1.0"
+authors = ["sunny-g <sunny.gonna@gmail.com>"]
+edition = "2018"
+publish = false
+build = "build.rs"
+
+[lib]
+name = "stac_proto"
+path = "src/lib.rs"
+
+[dependencies]
+futures = "0.1"
+grpcio = { version = "0.4", features = ["openssl"] }
+protobuf = { version = "2", features = ["with-serde"] }
+serde = { version = "1.0", features = ["derive"] }
+
+[dev-dependencies]
+futures03 = { package = "futures", version = "0.3", features = ["compat", "executor"] }
+futures03-test = { package = "futures-test", version = "0.3" }
+lazy_static = "1.4"
+
+[build-dependencies]
+lazy_static = "1.4"
+protobuf-codegen = { version = "2" }
+protoc-grpcio = "1.1"
+
+[features]
+default = ["with-serde"]
+with-serde = ["protobuf/with-serde"]

rust/README.md

@@ -0,0 +1,15 @@
+# stac-proto
+
+## Install
+
+```bash
+$ cargo build
+
+# to rebuild proto modules
+REBUILD=true cargo build
+# then in the `geometry`, `query` and `stac` modules,
+# add the line `use serde::{Deserialize, Serialize};` to the other imports.
+```
+
+See `tests/mod.rs` for a full example using the client, though this will
+ require a valid authentication token.

rust/build.rs

@@ -0,0 +1,36 @@
+extern crate protoc_grpcio;
+
+fn main() {
+    if std::env::var("REBUILD").is_err() {
+        return;
+    }
+
+    let proto_lib_root = "src/proto";
+    let proto_root = "../proto";
+    let proto_files = [
+        "epl/protobuf/geometry.proto",
+        "epl/protobuf/query.proto",
+        "epl/protobuf/stac.proto",
+        "epl/protobuf/geometry_service.proto",
+        "epl/protobuf/stac_service.proto",
+    ];
+
+    println!("cargo:rerun-if-changed={}", proto_root);
+    protoc_grpcio::compile_grpc_protos(
+        &proto_files,
+        &[proto_root],
+        &proto_lib_root,
+        Some(protobuf_codegen::Customize {
+            serde_derive: Some(true),
+            ..Default::default()
+        }),
+    )
+    .expect("Failed to compile gRPC definitions!");
+
+    println!(
+        "gRPC definitions successfully created!\
+         Be sure to add a `use serde::{{Serialize, Deserialize}};` line to the \
+         non-service modules.\
+         "
+    )
+}

rust/src/lib.rs

@@ -0,0 +1,11 @@
+//! stac-proto
+
+mod proto;
+
+pub use proto::geometry::*;
+pub use proto::geometry_service::*;
+pub use proto::geometry_service_grpc::*;
+pub use proto::query::*;
+pub use proto::stac::*;
+pub use proto::stac_service::*;
+pub use proto::stac_service_grpc::*;