Struct HttpInventorySource 

pub struct HttpInventorySource { /* private fields */ }

Fetches inventory data from an HTTP endpoint.

Perfect for dynamic inventories backed by CMDBs, GraphQL, REST APIs, or static web-hosted files. The client eagerly fetches the document, interpolates environment variables, and parses it using the requested InventoryFormat. Convenience builders make it easy to add headers or authentication inline—ideal for CI pipelines or tooling that needs to refresh inventory snapshots periodically.

Examples

use nornir_rs::{HttpInventorySource, InventoryFormat};

let source = HttpInventorySource::new("https://example.com/inventory", InventoryFormat::Json)?;
// Configure headers or TLS options here.
let _source = source.with_header("Authorization", "Bearer <token>");

Implementations

impl HttpInventorySource

pub fn new( url: impl Into<String>, format: InventoryFormat, ) -> Result<Self, InventoryError>

Creates a source that fetches data from url and parses it using format.

pub fn with_header( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Adds an HTTP header to the GET request.

pub fn with_basic_auth( self, username: impl Into<String>, password: impl Into<String>, ) -> Self

Configures HTTP basic authentication.

pub fn with_bearer_token(self, token: impl Into<String>) -> Self

Configures bearer token authentication.

pub fn with_api_key( self, header: impl Into<String>, value: impl Into<String>, ) -> Self

Adds an API key header (e.g., X-API-Key).

Trait Implementations

impl InventorySource for HttpInventorySource

fn load(&self) -> Result<Inventory, InventoryError>

Loads inventory data.

fn name(&self) -> &str

Human-friendly identifier for logging/observability.