pmomdns (0.1.0)
Installation
[registries.forgejo]
index = "sparse+ " # Sparse index
# index = " " # Git
[net]
git-fetch-with-cli = truecargo add pmomdns@0.1.0 --registry forgejoAbout this package
pmomdns
Le démon mDNS unique du processus, doublé d'une recherche en unicast de secours : la découverte des
appareils AirPlay (_raop._tcp) et Chromecast (_googlecast._tcp) de PMOMusic.
Fonctionnalités
- Un seul
ServiceDaemon(mdns-sd) par processus, créé au premier appel dedaemon(). browse(type): les événements d'un type de service, vus par le démon et par une recherche en unicast (RFC 6762 §6.7) qui trouve les appareils même quand leurs réponses multicast n'arrivent pas.- Ré-export de
mdns_sd: une seule version de la bibliothèque pour tous les consommateurs. - Un type d'erreur unique,
PmomdnsError.
Installation
[dependencies]
pmomdns = { version = "0.1", registry = "pmo" }
Depuis les sources : git clone du dépôt, puis cargo build. En développement conjoint avec
pmomusic, make génère le patch local (.cargo/config.toml) qui résout pmomdns vers ce dossier.
Documentation
cargo doc --open, ou le wiki du dépôt (publié par la CI à chaque release).
use pmomdns::mdns_sd::ServiceEvent;
let events = pmomdns::browse("_raop._tcp.local.")?;
while let Ok(event) = events.recv() {
if let ServiceEvent::ServiceResolved(service) = event {
println!("{} : {:?}", service.get_fullname(), service.get_addresses());
}
}
# Ok::<(), pmomdns::PmomdnsError>(())
Pour annoncer un service, on prend le démon partagé : pmomdns::daemon()?.register(info).
API
| Élément | Rôle |
|---|---|
daemon() |
Le démon du processus (handle Clone), créé au premier appel, jamais arrêté |
browse(service_type) |
Receiver<ServiceEvent> : démon + recherche unicast |
mdns_sd |
Ré-export de la bibliothèque (ServiceEvent, ServiceInfo, ResolvedService…) |
PmomdnsError |
Daemon(mdns_sd::Error) ou Thread { operation, source } ; #[non_exhaustive] |
Result<T> |
Result<T, PmomdnsError> |
Particularités
- Un seul démon partagé. Un
ServiceDaemontient les sockets UDP 5353 et sa boucle : deux démons dans un processus, ce sont deux écouteurs et deux caches. Les consommateurs passent toujours pardaemon(), jamais parServiceDaemon::new(). browse()et nondaemon()?.browse(). Le démon pose ses questions depuis le port 5353 ; les appareils répondent par multicast, ce qui n'arrive jamais sur certains réseaux (borne filtrant le multicast, macOS dontmDNSRespondertient le port).browse()ajoute une recherche en unicast. Conséquences : un service peut être rendu deux fois enServiceResolved(traitement idempotent côté consommateur) ; la recherche unicast ne rend jamais deServiceRemoved, c'est au démon.- Ré-export de
mdns_sd. Les consommateurs ne déclarent pasmdns-sdeux-mêmes : la version est celle depmomdns. Montermdns-sdest donc un changement d'API de cette crate. - Contrainte
flume/if-addrs. LeReceiverrendu parbrowse()est celui deflume0.12, version demdns-sd0.21 :flumedoit rester sur la même version quemdns-sd, pas celle d'un workspace voisin (0.11 danspmomusic).if-addrssuit aussimdns-sd, pour énumérer les interfaces comme lui. Les deux se montent avecmdns-sd. - Modules internes (privés) :
wire: le strict nécessaire du format DNS (fabriquer une question, lire PTR / SRV / TXT / A, compression de noms comprise) ;catalog: accumule les enregistrements reçus, dit ce qui manque (SRV, TXT, A) et rend les services complets sous la formeResolvedServicedemdns-sd, une fois par changement ;unicast: un fil par recherche, une prise UDP par interface IPv4 (port éphémère), questions à 1 s, 2 s puis toutes les 20 s.
- Erreurs. Pas de repli silencieux : la création du démon et le lancement d'un fil échouent
avec
PmomdnsError. Un échec d'envoi d'une question unicast est ignoré (réseau tombé, interface sans multicast) : la question suivante réessaie.
Développement
make help # commandes (kit crate-kit)
make ci # fmt-check + clippy + tests + doc
cargo test live -- --ignored --nocapture # recherche unicast sur un réseau réel avec appareils
Les tests unitaires sont dans src/tests/ (un fichier par module) ; tests/api.rs couvre l'API
publique sans appareil. Le test live_unicast_search_finds_devices est #[ignore] : il demande
un réseau avec des appareils AirPlay et Chromecast.
Dépendances
mdns-sd: démon mDNS,ServiceInfo,ResolvedService.flume(0.12, featuresasync) : canaux, même version quemdns-sd.if-addrs: interfaces réseau, même version quemdns-sd.socket2: prises UDP liées à une interface (multicast sortant, TTL).thiserror:PmomdnsError.tracing: journal de débogage.
License
CeCILL v2.1 (voir LICENSE, traduction anglaise : LICENSE.en).
Dependencies
| ID | Version |
|---|---|
| flume | ^0.12 |
| if-addrs | ^0.15 |
| mdns-sd | ^0.21 |
| socket2 | ^0.6 |
| thiserror | ^2.0 |
| tracing | ^0.1 |