Fix examples

.gitignore

@@ -5,3 +5,5 @@ Cargo.lock
 .vscode
 .idea
 *.o
+example/protocols/*.rs
+!example/protocols/mod.rs

Cargo.toml

@@ -22,12 +22,3 @@ byteorder = "1.3.2"
 default = ["protobuf-codec"]
 protobuf-codec = ["protobuf"]
 
-[[example]]
-name = "client"
-path = "examples/client.rs"
-
-[dev-dependencies]
-log = "0.4.6"
-simple-logging = "2.0.2"
-nix = "0.15.0"
-

README.md

@@ -19,3 +19,22 @@ To generate the sources from proto files:
 ```
 $ protoc --rust_out=. --ttrpc_out=. --plugin=protoc-gen-ttrpc=`which ttrpc_rust_plugin` example.proto
 ```
+
+# Run Examples
+1. Go to the directory
+
+    `$ cd ttrpc-rust/example`
+
+2. Start the server
+
+    `$ cargo run --example server unix:///tmp/1`
+
+3. Start a client
+
+    `$ cargo run --example client /tmp/1`
+
+# Notes
+
+The version of protobuf-codegen which you are using to generate codes should be exactly same with the version of protobuf library.
+
+The reason is that [files generated by protobuf-codegen are compatible only with the same version of runtime](https://github.com/stepancheg/rust-protobuf/commit/2ab4d50c27c4dd7803b64ce1a43e2c134532c7a6)

example/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+name = "ttrpc-example"
+version = "0.1.0"
+authors = ["Hui Zhu <teawater@antfin.com>"]
+edition = "2018"
+license = "Apache-2.0"
+keywords = ["ttrpc", "protobuf", "rpc"]
+readme = "README.md"
+repository = "https://github.com/alipay/ttrpc-rust"
+homepage = "https://github.com/alipay/ttrpc-rust"
+description = "An example of ttrpc."
+
+[dependencies]
+protobuf = "2.8.0"
+bytes = "0.4.11"
+libc = "0.2.59"
+byteorder = "1.3.2"
+log = "0.4.6"
+simple-logging = "2.0.2"
+nix = "0.15.0"
+ttrpc = { path = "../" }
+
+
+[[example]]
+name = "client"
+path = "./client.rs"
+
+[[example]]
+name = "server"
+path = "./server.rs"
+
+[build-dependencies]
+protoc-rust = "2.8.0"
+cmd_lib = "0.7.8"

example/build.rs

@@ -0,0 +1,8 @@
+use cmd_lib::run_cmd;
+
+fn main() {
+  run_cmd! {
+    cd protocols;
+    ./hack/update-generated-proto.sh;
+  };
+}