tgbotrs 0.2.0

A fully-featured, auto-generated Telegram Bot API library for Rust. All 285 types and 165 methods - strongly typed, fully async.
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

use bytes::Bytes;
use serde::{Deserialize, Serialize, Serializer};

/// A file to be sent via the Telegram Bot API.
///
/// - `FileId` - reference a file already on Telegram's servers
/// - `Url` - let Telegram download the file from a URL
/// - `Memory` - upload raw bytes directly via multipart
#[derive(Debug, Clone)]
pub enum InputFile {
    FileId(String),
    Url(String),
    Memory { filename: String, data: Bytes },
}

impl InputFile {
    pub fn file_id(id: impl Into<String>) -> Self {
        InputFile::FileId(id.into())
    }

    pub fn url(url: impl Into<String>) -> Self {
        InputFile::Url(url.into())
    }

    pub fn memory(filename: impl Into<String>, data: impl Into<Bytes>) -> Self {
        InputFile::Memory {
            filename: filename.into(),
            data: data.into(),
        }
    }
}

// Memory files are handled separately when building multipart requests.
// FileId and Url serialize to their string value.
impl Serialize for InputFile {
    fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error> {
        match self {
            InputFile::FileId(id) => serializer.serialize_str(id),
            InputFile::Url(url) => serializer.serialize_str(url),
            InputFile::Memory { filename, .. } => {
                serializer.serialize_str(&format!("attach://{}", filename))
            }
        }
    }
}

impl<'de> Deserialize<'de> for InputFile {
    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
        let s = String::deserialize(deserializer)?;
        if s.starts_with("http://") || s.starts_with("https://") {
            Ok(InputFile::Url(s))
        } else {
            Ok(InputFile::FileId(s))
        }
    }
}

impl From<String> for InputFile {
    fn from(s: String) -> Self {
        InputFile::FileId(s)
    }
}
impl From<&str> for InputFile {
    fn from(s: &str) -> Self {
        InputFile::FileId(s.to_string())
    }
}

/// A field that accepts either an [`InputFile`] or a plain string (file_id / URL).
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(untagged)]
pub enum InputFileOrString {
    File(InputFile),
    String(String),
}

impl From<InputFile> for InputFileOrString {
    fn from(f: InputFile) -> Self {
        InputFileOrString::File(f)
    }
}
impl From<String> for InputFileOrString {
    fn from(s: String) -> Self {
        InputFileOrString::String(s)
    }
}
impl From<&str> for InputFileOrString {
    fn from(s: &str) -> Self {
        InputFileOrString::String(s.to_string())
    }
}