tele 0.1.23

Ergonomic Telegram Bot API SDK for Rust, built on reqx
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

use std::collections::BTreeMap;

use serde::{Deserialize, Serialize};
use serde_json::Value;

use crate::{Error, Result};

/// Telegram file object.
#[derive(Clone, Debug, Deserialize)]
#[non_exhaustive]
pub struct File {
    pub file_id: String,
    pub file_unique_id: String,
    #[serde(default)]
    pub file_size: Option<u64>,
    #[serde(default)]
    pub file_path: Option<String>,
    #[serde(flatten)]
    pub extra: BTreeMap<String, Value>,
}

/// `getFile` request.
#[derive(Clone, Debug, Serialize)]
pub struct GetFileRequest {
    pub file_id: String,
}

impl GetFileRequest {
    pub fn new(file_id: impl Into<String>) -> Self {
        Self {
            file_id: file_id.into(),
        }
    }

    pub fn validate(&self) -> Result<()> {
        if self.file_id.trim().is_empty() {
            return Err(Error::InvalidRequest {
                reason: "file_id cannot be empty".to_owned(),
            });
        }
        if self.file_id.chars().any(char::is_control) {
            return Err(Error::InvalidRequest {
                reason: "file_id must not contain control characters".to_owned(),
            });
        }

        Ok(())
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn validates_get_file_request() {
        assert!(GetFileRequest::new("file-1").validate().is_ok());

        for file_id in ["", " ", "file\n1"] {
            assert!(matches!(
                GetFileRequest::new(file_id).validate(),
                Err(Error::InvalidRequest { .. })
            ));
        }
    }

    #[test]
    fn file_preserves_future_fields() -> std::result::Result<(), Box<dyn std::error::Error>> {
        let file: File = serde_json::from_value(serde_json::json!({
            "file_id": "file-id",
            "file_unique_id": "unique-id",
            "file_size": 42,
            "file_path": "documents/file.txt",
            "future_field": {"kept": true}
        }))?;

        assert_eq!(file.file_id, "file-id");
        assert_eq!(file.file_unique_id, "unique-id");
        assert_eq!(file.file_size, Some(42));
        assert_eq!(file.file_path.as_deref(), Some("documents/file.txt"));
        assert_eq!(
            file.extra["future_field"],
            serde_json::json!({"kept": true})
        );

        Ok(())
    }
}