FeignHTTP

FeignHTTP is a declarative HTTP client. Based on rust macros.

Features

• Easy to use
• Asynchronous request
• Configurable timeout settings
• Supports form, plain text and JSON
• Selectable HTTP backends (reqwest or isahc)

Usage

FeignHTTP mark macros on asynchronous functions, you need a runtime for support async/await. You can use async-std or tokio.

async-std:

toml [dependencies] async-std = { version = "1", features = ["attributes", "tokio1"] }

The feature tokio1 is need when use reqwest as the HTTP backend.

tokio:

toml [dependencies] tokio = { version = "1", features = ["full"] }

Add feignhttp in your Cargo.toml and use default feature:

toml feignhttp = { version = "0.4" }

Then add the following code:

```rust use feignhttp::get;

[get("https://api.github.com")]

async fn github() -> feignhttp::Result {}

[tokio::main]

async fn main() -> Result<(), Box> { let r = github().await?; println!("result: {}", r);

Ok(())

} ```

The get attribute macro specifies get request, feignhttp::Result<String> specifies the return result. It will send get request to https://api.github.com and receive a plain text body.

Using non-default HTTP backend:

toml feignhttp = { version = "0.4", default-features = false, features = ["isahc-client"] }

The default-features = false option disable default reqwest.

For more examples, click here.

Documentation

Read the documentation for more details.

License

FeignHTTP is provided under the MIT license. See LICENSE.