jsonrpc_core/
lib.rs

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
75
76
77
78
79
//! ### Transport agnostic jsonrpc library.
//!
//! Right now it supports only server side handling requests.
//!
//! ```rust
//! use jsonrpc_core::IoHandler;
//! use jsonrpc_core::Value;
//! let mut io = IoHandler::new();
//! io.add_sync_method("say_hello", |_| {
//!     Ok(Value::String("Hello World!".into()))
//! });
//!
//! let request = r#"{"jsonrpc": "2.0", "method": "say_hello", "params": [42, 23], "id": 1}"#;
//! let response = r#"{"jsonrpc":"2.0","result":"Hello World!","id":1}"#;
//!
//! assert_eq!(io.handle_request_sync(request), Some(response.to_string()));
//! ```

#![deny(missing_docs)]

use std::pin::Pin;

#[macro_use]
extern crate log;
#[macro_use]
extern crate serde_derive;

#[cfg(feature = "futures")]
pub use futures;
#[cfg(feature = "futures-executor")]
pub use futures_executor;
pub use futures_util;

#[doc(hidden)]
pub extern crate serde;
#[doc(hidden)]
pub extern crate serde_json;

mod calls;
mod io;

pub mod delegates;
pub mod middleware;
pub mod types;

/// A Result type.
pub type Result<T> = std::result::Result<T, Error>;

/// A `Future` trait object.
pub type BoxFuture<T> = Pin<Box<dyn std::future::Future<Output = T> + Send>>;

pub use crate::calls::{
	Metadata, RemoteProcedure, RpcMethod, RpcMethodSimple, RpcMethodSync, RpcNotification, RpcNotificationSimple,
	WrapFuture,
};
pub use crate::delegates::IoDelegate;
pub use crate::io::{
	Compatibility, FutureOutput, FutureResponse, FutureResult, FutureRpcResult, IoHandler, IoHandlerExtension,
	MetaIoHandler,
};
pub use crate::middleware::{Middleware, Noop as NoopMiddleware};
pub use crate::types::*;

use serde_json::Error as SerdeError;

/// workaround for https://github.com/serde-rs/json/issues/505
/// Arbitrary precision confuses serde when deserializing into untagged enums,
/// this is a workaround
pub fn serde_from_str<'a, T>(input: &'a str) -> std::result::Result<T, SerdeError>
where
	T: serde::de::Deserialize<'a>,
{
	if cfg!(feature = "arbitrary_precision") {
		let val = serde_json::from_str::<Value>(input)?;
		T::deserialize(val)
	} else {
		serde_json::from_str::<T>(input)
	}
}