#json-rpc #rpc #json #serde

rs-jsonrpc-core

Transport agnostic rust implementation of JSON-RPC 2.0 Specification

1 stable release

Uses old Rust 2015

8.0.0 May 14, 2019

#104 in #json-rpc

Download history 3/week @ 2024-02-12 10/week @ 2024-02-19 23/week @ 2024-02-26 18/week @ 2024-03-04 22/week @ 2024-03-11

74 downloads per month
Used in 5 crates

MIT license

49KB
1K SLoC

rs-jsonrpc-core

Transport agnostic rust implementation of JSON-RPC 2.0 Specification.

Documentation

  • - server side
  • - client side

Example

Cargo.toml

[dependencies]
rs-jsonrpc-core = "4.0"

main.rs

extern crate rs_jsonrpc_core;

use rs_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

extern crate rs_jsonrpc_core;

use rs_jsonrpc_core::*;
use rs_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

~0.9–1.6MB
~36K SLoC