udp 3.1.0

A lightweight and efficient Rust library for building UDP servers with request-response handling.
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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use crate::*;

/// Provides a default implementation for PanicData.
impl Default for PanicData {
    /// Creates a default PanicData with empty message and no location.
    ///
    /// # Returns
    ///
    /// - `Self` - A new instance with default values.
    #[inline(always)]
    fn default() -> Self {
        Self {
            message: String::new(),
            location: None,
        }
    }
}

/// Implementation of methods for PanicData.
impl PanicData {
    /// Creates a new PanicData from a panic message.
    ///
    /// # Arguments
    ///
    /// - `AsRef<str>` - The panic message.
    ///
    /// # Returns
    ///
    /// - `Self` - A new PanicData instance.
    pub fn from_message<M>(message: M) -> Self
    where
        M: AsRef<str>,
    {
        Self {
            message: message.as_ref().to_owned(),
            location: None,
        }
    }

    /// Creates a new PanicData from a JoinError (for panics in spawned tasks).
    ///
    /// # Arguments
    ///
    /// - `JoinError` - The JoinError from a panicked task.
    ///
    /// # Returns
    ///
    /// - `Self` - A new PanicData instance.
    pub fn from_join_error(error: tokio::task::JoinError) -> Self {
        Self {
            message: error.to_string(),
            location: None,
        }
    }

    /// Gets the panic message.
    ///
    /// # Returns
    ///
    /// - `&String` - Reference to the panic message.
    pub fn get_message(&self) -> &String {
        &self.message
    }

    /// Gets the panic location if available.
    ///
    /// # Returns
    ///
    /// - `Option<&String>` - Reference to the location string if available.
    pub fn get_location(&self) -> Option<&String> {
        self.location.as_ref()
    }

    /// Sets the panic location.
    ///
    /// # Arguments
    ///
    /// - `AsRef<str>` - The location string (file:line).
    pub fn set_location<L>(&mut self, location: L)
    where
        L: AsRef<str>,
    {
        self.location = Some(location.as_ref().to_owned());
    }
}

/// Implementation of Display for PanicData.
impl Display for PanicData {
    /// Formats the PanicData for display.
    ///
    /// # Arguments
    ///
    /// - `f` - Formatter for the output.
    ///
    /// # Returns
    ///
    /// - `fmt::Result` - Result of formatting operation.
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "Panic: {}", self.get_message())?;
        if let Some(location) = self.get_location() {
            write!(f, " at {location}")?;
        }
        Ok(())
    }
}

/// Implementation of StdError for PanicData.
impl StdError for PanicData {}