curl-rest

A Reqwest-like REST client built on libcurl for true blocking requests.

Install

cargo add curl-rest

libcurl dependency

curl-rest is backed by libcurl, so your build will need a libcurl development package available on the system (for example, installed via your OS package manager). If you prefer a vendored build or static linking, enable the appropriate curl/curl-sys features in your application so Cargo propagates them to this crate.

This crate exposes a few convenience features (default is ssl):

ssl: enable OpenSSL-backed TLS (libcurl's default).
rustls: enable Rustls-backed TLS (disable default features in your dependency to avoid OpenSSL).
static-curl: build and link against a bundled libcurl.
static-ssl: build and link against a bundled OpenSSL.
vendored: enables both static-curl and static-ssl.

Usage

let resp = curl_rest::Client::default()
    .get()
    .header(curl_rest::Header::Accept("application/json".into()))
    .query_param_kv("page", "1")
    .send("https://example.com/api/users")
    .expect("request failed");

println!("Status: {}", resp.status);
for header in &resp.headers {
    println!("{}: {}", header.name, header.value);
}
println!("{}", String::from_utf8_lossy(&resp.body));

Default User-Agent

let resp = curl_rest::Client::with_user_agent("my-app/1.0")
    .get()
    .header(curl_rest::Header::Accept("application/json".into()))
    .send("https://example.com/api/users")?;
// Ok::<(), curl_rest::Error>(())

If you set a User-Agent header explicitly, it overrides the default.

Headers

let resp = curl_rest::Client::default()
    .get()
    .header(curl_rest::Header::Authorization("Bearer token".into()))
    .header(curl_rest::Header::Accept("application/json".into()))
    .header(curl_rest::Header::Custom(
        "X-Request-Id".into(),
        "req-12345".into(),
    ))
    .send("https://example.com/private")?;
for header in &resp.headers {
    println!("{}: {}", header.name, header.value);
}
// Ok::<(), curl_rest::Error>(())

Response headers are available on resp.headers as ordered name/value pairs.

Query params

let resp = curl_rest::Client::default()
    .get()
    .query_param_kv("q", "rust")
    .query_param_kv("page", "2")
    .send("https://example.com/search")?;
// Ok::<(), curl_rest::Error>(())

JSON body

let resp = curl_rest::Client::default()
    .post()
    .body_json(r#"{"name":"stanley"}"#)
    .send("https://example.com/users")?;
// Ok::<(), curl_rest::Error>(())

Examples

cargo run --example curl -- GET https://example.com
TOKEN=secret cargo run --example headers -- https://example.com/private

Benchmarks

cargo bench

License

MIT

curl-rest 0.3.2