48 stable releases (15 major)

new 15.0.0 Sep 18, 2020
14.2.0 Jun 3, 2020
14.1.0 Apr 14, 2020
14.0.5 Nov 28, 2019
0.2.0 Jan 19, 2016

#1 in #jsonrpc

Download history 23020/week @ 2020-05-30 26348/week @ 2020-06-06 22606/week @ 2020-06-13 17675/week @ 2020-06-20 19261/week @ 2020-06-27 17900/week @ 2020-07-04 19266/week @ 2020-07-11 18707/week @ 2020-07-18 19401/week @ 2020-07-25 20192/week @ 2020-08-01 20049/week @ 2020-08-08 19629/week @ 2020-08-15 17127/week @ 2020-08-22 17000/week @ 2020-08-29 16894/week @ 2020-09-05 17502/week @ 2020-09-12

79,922 downloads per month
Used in 160 crates (65 directly)

MIT license

60KB
1.5K SLoC

jsonrpc-core

Transport agnostic rust implementation of JSON-RPC 2.0 Specification.

Documentation

  • - server side
  • - client side

Example

Cargo.toml

[dependencies]
jsonrpc-core = "4.0"

main.rs

use jsonrpc_core::*;

fn main() {
	let mut io = IoHandler::default();
	io.add_method("say_hello", |_params: Params| {
		Ok(Value::String("hello".into()))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	assert_eq!(io.handle_request_sync(request), Some(response.to_owned()));
}

Asynchronous responses

main.rs

use jsonrpc_core::*;
use jsonrpc_core::futures::Future;

fn main() {
	let io = IoHandler::new();
	io.add_async_method("say_hello", |_params: Params| {
		futures::finished(Value::String("hello".into()))
	});

	let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
	let response = r#"{"jsonrpc":"2.0","result":"hello","id":1}"#;

	assert_eq!(io.handle_request(request).wait().unwrap(), Some(response.to_owned()));
}

Publish-Subscribe

See examples directory.

Dependencies

~1–1.7MB
~40K SLoC