xref: /tonic/examples/README.md (revision 61555ff2)
1# Examples
2
3Set of examples that show off the features provided by `tonic`.
4
5## Helloworld
6
7### Client
8
9```bash
10$ cargo run --bin helloworld-client
11```
12
13### Server
14
15```bash
16$ cargo run --bin helloworld-server
17```
18
19## RouteGuide
20
21### Client
22
23```bash
24$ cargo run --bin routeguide-client
25```
26
27### Server
28
29```bash
30$ cargo run --bin routeguide-server
31```
32
33## Authentication
34
35### Client
36
37```bash
38$ cargo run --bin authentication-client
39```
40
41### Server
42
43```bash
44$ cargo run --bin authentication-server
45```
46
47## Load Balance
48
49### Client
50
51```bash
52$ cargo run --bin load-balance-client
53```
54
55### Server
56
57```bash
58$ cargo run --bin load-balance-server
59```
60
61## Dynamic Load Balance
62
63### Client
64
65```bash
66$ cargo run --bin dynamic-load-balance-client
67```
68
69### Server
70
71```bash
72$ cargo run --bin dynamic-load-balance-server
73```
74
75## TLS (rustls)
76
77### Client
78
79```bash
80$ cargo run --bin tls-client
81```
82
83### Server
84
85```bash
86$ cargo run --bin tls-server
87```
88
89## Health Checking
90
91### Server
92
93```bash
94$ cargo run --bin health-server
95```
96
97## Server Reflection
98
99### Server
100```bash
101$ cargo run --bin reflection-server
102```
103
104## Tower Middleware
105
106### Server
107
108```bash
109$ cargo run --bin tower-server
110```
111
112## Autoreloading Server
113
114### Server
115```bash
116systemfd --no-pid -s http::[::1]:50051 -- cargo watch -x 'run --bin autoreload-server'
117```
118
119### Notes:
120
121If you are using the `codegen` feature, then the following dependencies are
122**required**:
123
124* [bytes](https://crates.io/crates/bytes)
125* [prost](https://crates.io/crates/prost)
126* [prost-derive](https://crates.io/crates/prost-derive)
127
128The autoload example requires the following crates installed globally:
129
130* [systemfd](https://crates.io/crates/systemfd)
131* [cargo-watch](https://crates.io/crates/cargo-watch)
132