dioxus-grpc 0.0.4

Easy interface for a gRPC client with Dioxus
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

<h1 align="center"> <code> dioxus-grpc </code> </h1>

`dioxus-grpc` provides a convenient way to use `gRPC` with `Dioxus`

## Example

```rs
fn app() -> Element {
    let req = use_signal(|| HelloRequest { name: String::new() });
    let greeter = use_greeter_service();

    rsx! {
        input {
            value: "{req().name}",
            oninput: move |event| req.write().name = event.value()
        }
        match &*greeter.say_hello(req).read() {
            Some(Ok(resp)) => rsx!{"[{resp.message}] - From server"},
            Some(Err(err)) => rsx!{"Couldn't get the name {err:#?}"},
            None => rsx!{"..."},
        }
    }
}
```

```proto
syntax = "proto3";

package helloworld;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}
```

_A complete example can be found here: [`./examples/`](https://github.com/tkr-sh/dioxus-grpc/blob/main/examples)_


## How to use ?

_By default, this is meant for `mobile` & `desktop`. But you can activate it for `web` with `feature = "web"`_

To use it, you will need to also use `tonic-build` (and disable the `transport` feature in case of `feature = "web`). Therefore, something like:

```toml
[build-dependencies]
    dioxus-grpc = "*"
    tonic-build = "0.13"
    # For web:
    # tonic-build = { version = "0.13", default-features = false, features = ["prost"] } 
```

But, you will also need to import some runtime dependencies:

```toml
[dependencies]
    dioxus = { version = "0.6", features = ["mobile"] }
    tonic = "0.13"
    prost = "0.13"
    # For web:
    # tonic = { version = "0.13", default-features = false, features = ["codegen", "prost"] }
    # tonic-web-wasm-client = "0.7"
```

Once this is done, you can call [`generate_hooks`]() in `./build.rs`. See the [examples](https://github.com/tkr-sh/dioxus-grpc/blob/main/examples) for more details.