Struct InterfaceBuilder

pub struct InterfaceBuilder { /* private fields */ }

A builder for constructing Interface instances.

The InterfaceBuilder struct provides a fluent API for building Interface objects. It allows you to chain method calls to set various fields, culminating in a build() method that constructs the Interface.

Examples

use interface_rs::interface::{Interface, Family};

let iface = Interface::builder("eth0")
    .with_auto(true)
    .with_allow("hotplug")
    .with_family(Family::Inet)
    .with_method("dhcp")
    .with_option("mtu", "1500")
    .build();

Implementations

impl InterfaceBuilder

pub fn new(name: impl Into<String>) -> Self

Creates a new InterfaceBuilder with the specified interface name.

Arguments

• name - The name of the interface (e.g., "eth0").

Examples

use interface_rs::interface::Interface;

let builder = Interface::builder("eth0");

pub fn with_auto(self, auto: bool) -> Self

Sets whether the interface should start automatically.

Arguments

• auto - A boolean indicating if the interface should start automatically.

Examples

let builder = builder.with_auto(true);

pub fn with_allow(self, allow: impl Into<String>) -> Self

Adds an allow-* directive to the interface.

Arguments

• allow - A string representing the allow directive (e.g., "hotplug").

Examples

let builder = builder.with_allow("hotplug");

pub fn with_family(self, family: Family) -> Self

Sets the address family of the interface.

Arguments

• family - The Family of the interface (e.g., Family::Inet).

Examples

use interface_rs::interface::{Interface, Family};
let builder = Interface::builder("eth0")
    .with_family(Family::Inet);

pub fn with_method(self, method: impl Into<String>) -> Self

Sets the method of configuration for the interface.

Arguments

• method - A string representing the method (e.g., "static", "dhcp").

Examples

let builder = Interface::builder("eth0")
    .with_method("dhcp");

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

Adds an option to the interface.

Arguments

• key - The option name (e.g., "address").
• value - The option value (e.g., "192.168.1.100").

Examples

let builder = Interface::builder("eth0")
    .with_option("address", "192.168.1.100");

pub fn with_mapping(self, mapping: Mapping) -> Self

Sets the mapping configuration for the interface.

Arguments

• mapping - A Mapping struct representing the mapping configuration.

Examples

use interface_rs::interface::{Interface, Mapping};
let mapping = Mapping {
    script: "/usr/local/bin/map-script".to_string(),
    maps: vec!["eth0".to_string()],
};
let builder = Interface::builder("eth0")
    .with_mapping(mapping);

pub fn build(self) -> Interface

Builds the Interface instance.

Returns

An Interface with the specified configuration.

Examples

use interface_rs::interface::{Interface, Family};
let iface = Interface::builder("eth0")
    .with_auto(true)
    .with_family(Family::Inet)
    .with_method("dhcp")
    .build();

Trait Implementations

impl Clone for InterfaceBuilder

fn clone(&self) -> InterfaceBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InterfaceBuilder

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

Formats the value using the given formatter.