Skip to content

Typed enum HTTP API for reqwest

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

hewigovens/reqwest-enum

Repository files navigation

reqwest-enum

crates.io CI

Type-safe and enum style API for Rust, some benefits:

  1. It abstracts away repetitive boilerplate code like url formatting, query / header encoding and response deserialization.
  2. Type-safe endpoints, readable like a spec, easy to add new or refactor existing endpoints.
  3. Async by default and lightweight JSON-RPC support.

Features:

  • Type-safe and enum style HTTP API
  • JSON-RPC with batching support
  • ...

Installation

cargo add reqwest-enum or add it to your Cargo.toml:

[dependencies]
reqwest-enum = "0.3.2"

Example

httpbin.org

  1. Define endpoints for https://httbin.org as an enum:
pub enum HttpBin {
    Get,
    Post,
    Bearer,
}
  1. Implement Target for the enum:
pub trait Target {
    fn base_url(&self) -> &'static str;
    fn method(&self) -> HTTPMethod;
    fn path(&self) -> String;
    fn query(&self) -> HashMap<&'static str, &'static str>;
    fn headers(&self) -> HashMap<&'static str, &'static str>;
    fn authentication(&self) -> Option<AuthMethod>;
    fn body(&self) -> HTTPBody;
    fn timeout(&self) -> Option<Duration>;
}
  1. Create a provider and request:
let provider = Provider::<HttpBin>::default();
let response = provider.request(HttpBin::Get).await.unwrap();
assert_eq!(response.status(), 200);

Provider also allows you to customize the request by providing a EndpointFn or RequestBuilderFn closure if default behavior is not sufficient:

  1. Need to use different endpoint based on the target.
  2. Need to insert custom headers or intercept the final request.

JSON-RPC

Full example can be found in examples/ethereum-rpc.

  1. Define Ethereum JSON-RPC methods as an enum:
pub enum EthereumRPC {
    ChainId,
    GasPrice,
    BlockNumber,
    GetBalance(&'static str),
    GetBlockByNumber(&'static str, bool),
    GetTransactionCount(&'static str, BlockParameter),
    Call(TransactionObject, BlockParameter),
    EstimateGas(TransactionObject),
    SendRawTransaction(&'static str),
}
  1. Implement Target and JsonRpcTarger for the enum:
pub trait JsonRpcTarget: Target {
    fn method_name(&self) -> &'static str;
    fn params(&self) -> Vec<Value>;
}
  1. Create a provider and request:
let provider = Provider::<EthereumRPC>::default();
let response: JsonRpcResponse<String> =
    provider.request_json(EthereumRPC::ChainId).await.unwrap();
assert_eq!(response.result, "0x1");

License

MIT or Apache-2.0

Credits

About

Typed enum HTTP API for reqwest

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published