Skip to main content

Http

Struct Http 

Source
pub struct Http { /* private fields */ }
Expand description

Loader for the http source: fetches configuration bytes through a user-supplied closure.

This crate ships no HTTP client — you provide the transport as an HttpFetchFn when calling Http::new. The loader validates options, calls your closure with the resolved URL, headers, timeout, and TLS policy, then normalizes the returned entries (see the module docs).

§Example

use std::collections::HashMap;
use std::time::Duration;
use tanzim_load::{http::{Http, Url}, Load, Payload};
use tanzim_source::SourceBuilder;

// A real fetch would call an HTTP client here; this canned closure needs no network.
let http = Http::new(Box::new(
    |url: &Url, _headers: &HashMap<String, String>, _timeout: Duration, _insecure: bool| {
        Ok(vec![Payload {
            source: SourceBuilder::new()
                .with_source("http")
                .with_resource(url.as_str())
                .build()
                .unwrap(),
            maybe_name: Some("app".into()),
            maybe_format: Some("json".into()),
            content: br#"{"debug":true}"#.to_vec(),
        }])
    },
));

let source = SourceBuilder::new()
    .with_source("http")
    .with_resource("https://example.com/config.json")
    .build()
    .unwrap();

let payloads = http.load(source).unwrap();
assert_eq!(payloads[0].maybe_name.as_deref(), Some("app"));

Implementations§

Source§

impl Http

Source

pub fn new(fetch: HttpFetchFn) -> Self

Create an HTTP loader driven by fetch, the closure that performs the actual request.

Trait Implementations§

Source§

impl Load for Http

Source§

fn name(&self) -> &str

Human-readable name used in error messages.
Source§

fn supported_source_list(&self) -> Vec<String>

Source strings this loader handles (e.g. ["env"], ["file"], ["http", "https"]).
Source§

fn load(&self, source: Source) -> Result<Vec<Payload>, Error>

Load raw bytes from the source. Returns one Payload per config entry found.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Http

§

impl !UnwindSafe for Http

§

impl Freeze for Http

§

impl Send for Http

§

impl Sync for Http

§

impl Unpin for Http

§

impl UnsafeUnpin for Http

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more