pong-rs 0.3.0

A network monitoring tool that performs ICMP, TCP, and HTTP pings
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

use serde::{Deserialize, Serialize};
use std::time::Duration;
use strum_macros::Display;
use wheel_rs::serde::duration_serde;

#[derive(Debug, Serialize, Deserialize, Clone)]
#[serde(rename_all = "kebab-case")]
pub struct PongSettings {
    /// 任务列表
    pub task_groups: Vec<TaskGroupSettings>,
}

/// 任务分组配置，定义了一组相关任务的执行参数
///
/// 该结构体用于配置任务组的基本属性，包括执行间隔、超时时间和任务列表。
/// 所有字段都支持序列化和反序列化，便于从配置文件中读取和保存。
#[derive(Debug, Serialize, Deserialize, Clone)]
pub struct TaskGroupSettings {
    /// 任务组执行间隔
    #[serde(with = "duration_serde", default = "interval_default")]
    pub interval: Option<Duration>,
    /// 超时时间
    #[serde(with = "duration_serde", default = "timeout_default")]
    pub timeout: Option<Duration>,
    /// 任务列表
    pub tasks: Vec<TaskSettings>,
}

fn interval_default() -> Option<Duration> {
    Some(Duration::from_secs(3)) // 默认 3 秒
}
fn timeout_default() -> Option<Duration> {
    Some(Duration::from_secs(5)) // 默认 5 秒
}

/// 任务类型枚举，定义了支持的任务类型
///
/// 该枚举包含了三种任务类型：
/// - ICMP: 用于网络连通性测试
/// - TCP: 用于TCP端口连通性测试
/// - HTTP: 用于HTTP服务可用性测试
#[derive(Debug, Serialize, Deserialize, Display, Clone)]
pub enum TaskType {
    /// icmp
    #[serde(rename = "icmp")]
    ICMP,
    /// tcp
    #[serde(rename = "tcp")]
    TCP,
    /// http
    #[serde(rename = "http")]
    HTTP,
}

/// 任务属性
#[derive(Debug, Serialize, Deserialize, Clone)]
#[serde(rename_all = "kebab-case")]
pub struct TaskSettings {
    /// 任务类型
    pub task_type: TaskType,
    /// 目标
    pub target: String,
}