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 操作將運行與上面相同的步驟
• 我將審查並合併