14 releases

0.6.0 Jan 13, 2021
0.5.3 Oct 8, 2020
0.5.2 Mar 4, 2020
0.5.0-alpha.1 Dec 10, 2019
0.2.1 Feb 7, 2019

#45 in HTTP server

Download history 40/week @ 2020-10-02 76/week @ 2020-10-09 23/week @ 2020-10-16 31/week @ 2020-10-23 25/week @ 2020-10-30 27/week @ 2020-11-06 21/week @ 2020-11-13 63/week @ 2020-11-20 35/week @ 2020-11-27 36/week @ 2020-12-04 26/week @ 2020-12-11 30/week @ 2020-12-18 31/week @ 2020-12-25 34/week @ 2021-01-01 56/week @ 2021-01-08 57/week @ 2021-01-15

137 downloads per month
Used in roa-jsonrpc

MIT license

46KB
1K SLoC

jsonrpc-v2

Docs Crates.io

A very small and very fast JSON-RPC 2.0 server-focused framework.

Provides integrations for both hyper and actix-web (both 1.x and 2.x). Enable features actix-web-v1-integration, actix-web-v2-integration, or hyper-integration depending on need.

actix-web-v2-integration is enabled by default. Make sure to add default-features = false if using hyper or actix-web 1.x.

Also see the easy-errors feature flag (not enabled by default). Enabling this flag will implement ErrorLike for anything that implements Display, and the display value will be provided in the message field of the JSON-RPC 2.0 Error response.

Otherwise, custom errors should implement ErrorLike to map errors to the JSON-RPC 2.0 Error response.

Individual method handlers are async functions that can take various kinds of args (things that can be extracted from the request, like the Params or Data), and should return a Result<Item, Error> where the Item is serializable. See examples below.

Usage

use jsonrpc_v2::{Data, Error, Params, Server};

#[derive(serde::Deserialize)]
struct TwoNums {
    a: usize,
    b: usize,
}

async fn add(Params(params): Params<TwoNums>) -> Result<usize, Error> {
    Ok(params.a + params.b)
}

async fn sub(Params(params): Params<(usize, usize)>) -> Result<usize, Error> {
    Ok(params.0 - params.1)
}

async fn message(data: Data<String>) -> Result<String, Error> {
    Ok(String::from(&*data))
}

#[actix_rt::main]
async fn main() -> std::io::Result<()> {
    let rpc = Server::new()
        .with_data(Data::new(String::from("Hello!")))
        .with_method("sub", sub)
        .with_method("message", message)
        .finish();

    actix_web::HttpServer::new(move || {
        let rpc = rpc.clone();
        actix_web::App::new().service(
            actix_web::web::service("/api")
                .guard(actix_web::guard::Post())
                .finish(rpc.into_web_service()),
        )
    })
    .bind("0.0.0.0:3000")?
    .run()
    .await
}

Current version: 0.6.0

License: MIT

Dependencies

~1.8–3.5MB
~75K SLoC