simpdiscover

简单发现

Simpdiscover 是一个简单的 Rust 箱，可帮助使用 UDP 广播数据报或“信标”发现局域网 (LAN) 内的服务。

服务的“发布者”可以是另一台机器上的进程，也可以是同一台机器上的另一个线程或进程。

目标

• LAN 范围内的命名服务检测及其 IP 地址
• 易于理解和使用
• 体积小，对库的依赖少，内存和 CPU 占用空间小
• 简单的信标格式，易于使用，并且不会在库中引入特定的文件格式支持

非目标

• 跨 LAN、WAN、Web 或云发现服务。

目前已实施

• 可以设置为发送信标的 BeaconSender 结构：
  • 具有特定的信标内容字符串
  • 在特定端口上
  • 方法：
    • 在给定时间段内循环发送
    • 只发送一个信标
• 可以设置为接收信标的简单 BeaconListener 结构：
  • 匹配特定的消息内容
  • 使用阻止发送者并等待收到消息的方法
    • 具有可选的等待超时值或无无限期等待
• 使用该库作为示例的简单“宣布”和“监听”二进制文件
• 一些文档测试以保持 API 文档的正确性
• Github Action 进行构建，然后进行 Clippy 检查，然后测试所有内容

“宣布”二进制文件

使用cargo run --bin announce从存储库运行这个二进制文件，或者只是announce您是否已经安装了带有cargo的箱子。

它需要一个可选的命令行参数来指定要宣布的信标消息的字符串： cargo run --bin announce -- Hello

“听”二进制文件

使用cargo run --bin listen从存储库运行此二进制文件，或者如果您已经安装了带有 Cargo 的板条箱，则仅listen 。

它需要一个可选的命令行参数来指定退出前等待的信标消息的字符串： cargo run --bin listen -- Hello

未来的工作

我已经记下大部分关于未来工作的笔记，并将它们转换为 GitHub 问题。

有些只是关于我不明白的事情的问题，希望 UDP 和 rust 方面的专家向我解释它们。

请发表评论或启动任何您有兴趣实施的内容。

如果附有一些文档评论、文档测试或测试，PR 显然是受欢迎的。

开发商

• 克隆/分叉存储库并下载：
• cd进入目录
• 添加更改、添加文档注释和/或文档测试和测试。
• cargo build
• cargo test
• cargo clippy -- -D warnings
• 创建公关
• Github 操作将运行与上面相同的步骤
• 我将审查并合并