Expand description
§flawless-http
HTTP client for https://flawless.dev.
This library takes a lot of inspiration from
ureq
.
§Quick start
A simple GET request would look like this.
use flawless::workflow;
use flawless_http::get;
#[workflow("fetch")]
fn fetch() {
let request = get("https://example.com").set_header("Accept", "application/json");
let response = request.send().unwrap();
log::info!("{}", String::from_utf8(response.body()).unwrap());
}
§Body
A request can contain a body, but depending on the body type, additional request headers might be set. If headers are already manually set by the user, they are not overwritten.
§Text arguments
In case a String
or &str
type is given to body
, the "Content-Length"
header is
going to be set to the byte length of the string.
use flawless_http::post;
let response = post("https://httpbin.org/post")
.body("Hello world!")
.send();
assert!(response.is_ok());
§Form arguments
In case a slice of tuples of strings is passed in (&[(&str, &str)]
), body
will assume
a for is being submitted and URL encode it. It will set the header "Content-Type"
to
"application/x-www-form-urlencoded"
, and "Content-Length"
to the size of the encoded
content.
use flawless_http::post;
let response = post("https://httpbin.org/post")
.body([
("Hello", "world!"),
("second", "argument"),
].as_ref())
.send();
assert!(response.is_ok());
§JSON arguments
In case of a serde_json::Value
type, body
will assume that the content is of type
JSON and set the header "Content-Type"
to "application/json"
. It will also set
"Content-Length"
to the size of the serialized JSON.
use flawless_http::post;
use serde_json::json;
let response = post("https://httpbin.org/post")
.body(json!({
"Hello": "world!",
"second": "argument",
}))
.send();
assert!(response.is_ok());
Modules§
- transport
- A collection of out-of-the-box supported transport protocols.
Structs§
- Config
- Configuration settings for requests.
- Request
- An HTTP request.
- Response
- Transport
- Error indicating an issue with the underlying request transport.
Enums§
Traits§
- Into
Body - Implemented for everything that can be turned into a body.