roas-http-fetcher

HTTP/HTTPS ResourceFetcher and AsyncResourceFetcher for the roas OpenAPI loader.

Built on reqwest with rustls-tls. A single generic Fetcher<C> underlies two type aliases:

• HttpFetcher (= Fetcher<reqwest::blocking::Client>) — implements ResourceFetcher for Loader::register_fetcher.
• AsyncHttpFetcher (= Fetcher<reqwest::Client>) — implements AsyncResourceFetcher for Loader::register_async_fetcher. A tokio runtime must be active when the returned future is awaited.

Both forms are Clone so a single fetcher can be registered for both http:// and https:// prefixes on the same Loader, sharing one underlying connection pool. Schemes other than http / https are rejected with LoaderError::UnsupportedFetcherUri. The default constructor builds a client with a 30-second request timeout; try_new() is the fallible variant that surfaces TLS / IO environment failures from reqwest::ClientBuilder.

Features

• (default) JSON response bodies are parsed with serde_json.
• yaml — also accept YAML response bodies. The fetcher sniffs Content-Type first (application/yaml, application/x-yaml, text/yaml, etc.) and falls back to the URL path extension (.yaml / .yml). Pulls in serde_yaml_ng.

[dependencies]
roas-http-fetcher = { version = "0.1", features = ["yaml"] }

Usage

cargo add roas-http-fetcher

use roas::loader::Loader;
use roas_http_fetcher::HttpFetcher;

let mut loader = Loader::new();
let http = HttpFetcher::new();
loader.register_fetcher("https://", http.clone());
loader.register_fetcher("http://", http);

For async loaders use AsyncHttpFetcher with register_async_fetcher instead — same shape:

use roas::loader::Loader;
use roas_http_fetcher::AsyncHttpFetcher;

let mut loader = Loader::new();
let http = AsyncHttpFetcher::new();
loader.register_async_fetcher("https://", http.clone());
loader.register_async_fetcher("http://", http);

A non-2xx HTTP response, transport failure, or unreadable body is surfaced through LoaderError::Fetch with a HttpFetchError source.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.