Skip to main content

Client

Struct Client 

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

Client for discovering ESPHome devices using mDNS. This client allows you to discover devices on the local network that are running ESPHome and have the mDNS service enabled.

Requires the discovery feature to be enabled.

§Usage:

use esphome_client::discovery::Client;

#[tokio::main]
async fn main() {
    let mut discovery_results = Client::default().discover().expect("Results");
    while let Ok(device) = discovery_results.next().await {   
        println!("Discovered device: {device:?}");
    }
}

Implementations§

Source§

impl Client

Source

pub fn with_interface_ip(self, addr: IpAddr) -> Self

Set the interface ip to discover devices on. If not set, it will use the all interfaces.

Source

pub fn with_interface(self, interface: &str) -> Self

Set the interface name to discover devices on. If not set, it will use the all interfaces.

Source

pub fn with_service_name(self, service_name: impl Into<String>) -> Self

Set the service name to filter devices by. If not set, it will default to _esphomelib._tcp.local.

Source

pub const fn with_interval(self, interval: Duration) -> Self

Set custom ip check interval. Defaults to the default interval of the mdns-sd crate.

Source

pub fn discover(self) -> Result<ResultStream, Error>

Initialize the discovery client and start discovering devices.

§Errors

Will return Error if discovery cannot be started due to initialization issues,

Trait Implementations§

Source§

impl Debug for Client

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for Client

Source§

fn default() -> Client

Returns the “default value” for a type. Read more

Auto Trait Implementations§

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> Same for T

Source§

type Output = T

Should always be Self
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