astro-dnssd
cargo install astro-dnssd

astro-dnssd

Simple Rust wrapper around DNS-SD

by AstroHQ

0.2.0 (see all)License:MIT OR Apache-2.0
cargo install astro-dnssd
Readme

Astro DNS-SD

Build Status License Cargo Documentation

Minimal but friendly safe wrapper around dns-sd(Bonjour, mDNS, Zeroconf DNS) APIs.

Documentation

Features

Complete

  • Service registration
  • TXTRecord support for service registration

In Progress

  • Service browsing

Todo

  • How to check for more (select() on socket, but has to be win32 friendly)
  • Record creation
  • Name resolution
  • Port map
  • Tests
  • Documentation
  • Pure Rust TXT code?
  • Interior mutability? (Can we reduce the &mut arguments some?)

Build Requirements

astro-dnssd requires the Bonjour SDK.

  • Windows: Download the SDK here
  • Linux: Install avahi-compat-libdns_sd for your distro of choice.

Technical Background

This website provides a good overview of the DNS-SD protocol.

Example

    use astro_dnssd::register::DNSServiceBuilder;
    use astro_dnssd::txt::TXTRecord;
    let mut txt = TXTRecord::new();
    let _ = txt.insert("s", Some("open"));
    let mut service = DNSServiceBuilder::new("_rust._tcp")
        .with_port(2048)
        .with_name("MyRustService")
        .with_txt_record(txt)
        .build()
        .unwrap();
    let _result = service.register(|reply| match reply {
        Ok(reply) => println!("Successful reply: {:?}", reply),
        Err(e) => println!("Error registering: {:?}", e),
    });
    loop {
        service.process_result();
    }

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

GitHub Stars

11

LAST COMMIT

1yr ago

MAINTAINERS

3

CONTRIBUTORS

6

OPEN ISSUES

9

OPEN PRs

0
VersionTagPublished
0.2.0
2yrs ago
0.1.3
2yrs ago
0.1.2
2yrs ago
0.1.1
2yrs ago
No alternatives found
No tutorials found
Add a tutorial