fork of zeroconf to apply patches
Go to file
Gavin Li 401b8b5759 Properly implement TEventLoop::poll for AvahiEventLoop
As of Avahi 0.7, the sleep_time arg passed to
`avahi_simple_poll_iterate()` is utilized. Properly implementing this
reduces CPU spent polling while improving responsiveness.
2022-01-15 00:21:02 -08:00
.github/workflows Run clippy in workflow 2021-08-20 15:32:17 -04:00
examples 0.10.2 2021-08-20 15:48:04 -04:00
scripts Run clippy in workflow 2021-08-20 15:32:17 -04:00
zeroconf Properly implement TEventLoop::poll for AvahiEventLoop 2022-01-15 00:21:02 -08:00
zeroconf-macros Increment versions 2020-09-29 14:21:23 -04:00
.gitignore Add ServiceType 2021-08-19 16:09:16 -04:00
Cargo.lock 0.10.2 2021-08-20 15:48:04 -04:00
Cargo.toml Move from magiclip project 2020-09-24 18:03:10 -04:00
LICENSE Initial commit 2020-09-24 18:01:28 -04:00
README.md Fix ServiceType logic 2021-08-20 13:02:12 -04:00

README.md

zeroconf

zeroconf is a cross-platform library that wraps underlying ZeroConf/mDNS implementations such as Bonjour or Avahi, providing an easy and idiomatic way to both register and browse services.

Prerequisites

On Linux:

$ sudo apt install xorg-dev libxcb-shape0-dev libxcb-xfixes0-dev clang avahi-daemon libavahi-client-dev

TODO

  • Windows support
  • You tell me...

Examples

Register a service

When registering a service, you may optionally pass a "context" to pass state through the callback. The only requirement is that this context implements the Any trait, which most types will automatically. See MdnsService for more information about contexts.

use std::any::Any;
use std::sync::{Arc, Mutex};
use std::time::Duration;
use zeroconf::prelude::*;
use zeroconf::{MdnsService, ServiceRegistration, ServiceType, TxtRecord};

#[derive(Default, Debug)]
pub struct Context {
    service_name: String,
}

fn main() {
    let mut service = MdnsService::new(ServiceType::new("http", "tcp").unwrap(), 8080);
    let mut txt_record = TxtRecord::new();
    let context: Arc<Mutex<Context>> = Arc::default();

    txt_record.insert("foo", "bar").unwrap();

    service.set_registered_callback(Box::new(on_service_registered));
    service.set_context(Box::new(context));
    service.set_txt_record(txt_record);

    let event_loop = service.register().unwrap();

    loop {
        // calling `poll()` will keep this service alive
        event_loop.poll(Duration::from_secs(0)).unwrap();
    }
}

fn on_service_registered(
    result: zeroconf::Result<ServiceRegistration>,
    context: Option<Arc<dyn Any>>,
) {
    let service = result.unwrap();

    println!("Service registered: {:?}", service);

    let context = context
        .as_ref()
        .unwrap()
        .downcast_ref::<Arc<Mutex<Context>>>()
        .unwrap()
        .clone();

    context.lock().unwrap().service_name = service.name().clone();

    println!("Context: {:?}", context);

    // ...
}

Browsing services

use std::any::Any;
use std::sync::Arc;
use std::time::Duration;
use zeroconf::prelude::*;
use zeroconf::{MdnsBrowser, ServiceDiscovery, ServiceType};

fn main() {
    let mut browser = MdnsBrowser::new(ServiceType::new("http", "tcp").unwrap());

    browser.set_service_discovered_callback(Box::new(on_service_discovered));

    let event_loop = browser.browse_services().unwrap();

    loop {
        // calling `poll()` will keep this browser alive
        event_loop.poll(Duration::from_secs(0)).unwrap();
    }
}

fn on_service_discovered(
    result: zeroconf::Result<ServiceDiscovery>,
    _context: Option<Arc<dyn Any>>,
) {
    println!("Service discovered: {:?}", result.unwrap());

    // ...
}

Resources