Struct Hosts 

pub struct Hosts(/* private fields */);

Collection of hosts keyed by name.

This type wraps a CustomTreeMap<Host> and is the primary container used for host inventory data. The map keys are host names used for logging/output.

Deserialization

• Unknown fields in individual Host entries are rejected (via #[serde(deny_unknown_fields)] on Host)
• The Hosts wrapper itself accepts any valid map structure

Examples

use genja_core::inventory::{Host, Hosts, BaseBuilderHost};

let mut hosts = Hosts::new();
let host = Host::builder().hostname("10.0.0.1").build();
hosts.add_host("router1", host);
assert_eq!(hosts.len(), 1);

Implementations

impl Hosts

pub fn new() -> Self

Creates an empty host collection.

Use add_host or map insertion methods to populate it.

pub fn add_host<N>(&mut self, name: N, host: Host)

where N: Into<String>,

Inserts a host into the collection under the provided name.

If a host with the same name already exists, it will be replaced with the new host. The name serves as the unique identifier for the host and is used in logs and output.

Parameters

• name - A string-like value that will be used as the unique identifier for the host. This name is used in logs and output to reference the host.
• host - The Host instance to insert into the collection.

Examples

use genja_core::inventory::{Host, Hosts, BaseBuilderHost};

let mut hosts = Hosts::new();
let host = Host::builder().hostname("10.0.0.1").build();
hosts.add_host("router1", host);
assert_eq!(hosts.len(), 1);

Trait Implementations

impl BaseMethods for Hosts

fn schema() -> String

where Self: Sized + JsonSchema,

impl Clone for Hosts

fn clone(&self) -> Hosts

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Hosts

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Hosts

fn default() -> Self

Returns the “default value” for a type.

impl Deref for Hosts

type Target = <Hosts as DerefTarget>::Target

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Hosts

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl DerefTarget for Hosts

type Target = CustomTreeMap<Host>

impl<'de> Deserialize<'de> for Hosts

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Hosts

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for Hosts

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.