jsonrpce 0.1.0

JSON-RPC 2.0 for Rust
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

# jsonrpc

JSON-RPC 2.0 implementation for Rust.

## Features

- **Transport Agnostic**: Decouples protocol logic from I/O. Comes with `Stdio`
  and `InMemory` transports out of the box.
- **Type-Safe Handlers**: Handlers are just Rust functions. Parameters are
  automatically deserialized, and results are serialized.

## Demo

Let's build a simple calculator server over `Stdio`:

```rust
use serde::Deserialize;
use jsonrpc::{Error, Server};

#[derive(Deserialize)]
struct AddParams {
    a: i32,
    b: i32,
}

fn add(_: &(), params: AddParams) -> Result<i32, Error> {
    Ok(params.a + params.b)
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    Server::stdio(()).method("add", add).run()?;
    Ok(())
}
```

Compile and run it, then pipe in some JSON-RPC commands:

```sh
echo '{"jsonrpc": "2.0", "method": "add", "params": {"a": 10, "b": 20}, "id": 1}' | cargo run --example stdio
```

Output:

```json
{ "jsonrpc": "2.0", "result": 30, "id": 1 }
```

## Installation

TODO: add installation via git

## Usage

TODO: add usage

## License

MIT