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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
use serde::{Deserialize, Serialize};
/// This object represents an audio file to be treated as music by the Telegram clients.
/// # Documentation
/// <https://core.telegram.org/bots/api#audio>
#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct Audio {
/// Identifier for this file, which can be used to download or reuse the file
pub file_id: Box<str>,
/// Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
pub file_unique_id: Box<str>,
/// Duration of the audio in seconds as defined by the sender
pub duration: i64,
/// Performer of the audio as defined by the sender or by audio tags
#[serde(skip_serializing_if = "Option::is_none")]
pub performer: Option<Box<str>>,
/// Title of the audio as defined by the sender or by audio tags
#[serde(skip_serializing_if = "Option::is_none")]
pub title: Option<Box<str>>,
/// Original filename as defined by the sender
#[serde(skip_serializing_if = "Option::is_none")]
pub file_name: Option<Box<str>>,
/// MIME type of the file as defined by the sender
#[serde(skip_serializing_if = "Option::is_none")]
pub mime_type: Option<Box<str>>,
/// File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.
#[serde(skip_serializing_if = "Option::is_none")]
pub file_size: Option<i64>,
/// Thumbnail of the album cover to which the music file belongs
#[serde(skip_serializing_if = "Option::is_none")]
pub thumbnail: Option<crate::types::PhotoSize>,
}
impl Audio {
/// Creates a new `Audio`.
///
/// # Arguments
/// * `file_id` - Identifier for this file, which can be used to download or reuse the file
/// * `file_unique_id` - Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
/// * `duration` - Duration of the audio in seconds as defined by the sender
///
/// # Notes
/// Use builder methods to set optional fields.
#[must_use]
pub fn new<T0: Into<Box<str>>, T1: Into<Box<str>>, T2: Into<i64>>(
file_id: T0,
file_unique_id: T1,
duration: T2,
) -> Self {
Self {
file_id: file_id.into(),
file_unique_id: file_unique_id.into(),
duration: duration.into(),
performer: None,
title: None,
file_name: None,
mime_type: None,
file_size: None,
thumbnail: None,
}
}
/// Identifier for this file, which can be used to download or reuse the file
#[must_use]
pub fn file_id<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.file_id = val.into();
this
}
/// Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
#[must_use]
pub fn file_unique_id<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.file_unique_id = val.into();
this
}
/// Duration of the audio in seconds as defined by the sender
#[must_use]
pub fn duration<T: Into<i64>>(self, val: T) -> Self {
let mut this = self;
this.duration = val.into();
this
}
/// Performer of the audio as defined by the sender or by audio tags
#[must_use]
pub fn performer<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.performer = Some(val.into());
this
}
/// Performer of the audio as defined by the sender or by audio tags
#[must_use]
pub fn performer_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.performer = val.map(Into::into);
this
}
/// Title of the audio as defined by the sender or by audio tags
#[must_use]
pub fn title<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.title = Some(val.into());
this
}
/// Title of the audio as defined by the sender or by audio tags
#[must_use]
pub fn title_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.title = val.map(Into::into);
this
}
/// Original filename as defined by the sender
#[must_use]
pub fn file_name<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.file_name = Some(val.into());
this
}
/// Original filename as defined by the sender
#[must_use]
pub fn file_name_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.file_name = val.map(Into::into);
this
}
/// MIME type of the file as defined by the sender
#[must_use]
pub fn mime_type<T: Into<Box<str>>>(self, val: T) -> Self {
let mut this = self;
this.mime_type = Some(val.into());
this
}
/// MIME type of the file as defined by the sender
#[must_use]
pub fn mime_type_option<T: Into<Box<str>>>(self, val: Option<T>) -> Self {
let mut this = self;
this.mime_type = val.map(Into::into);
this
}
/// File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.
#[must_use]
pub fn file_size<T: Into<i64>>(self, val: T) -> Self {
let mut this = self;
this.file_size = Some(val.into());
this
}
/// File size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.
#[must_use]
pub fn file_size_option<T: Into<i64>>(self, val: Option<T>) -> Self {
let mut this = self;
this.file_size = val.map(Into::into);
this
}
/// Thumbnail of the album cover to which the music file belongs
#[must_use]
pub fn thumbnail<T: Into<crate::types::PhotoSize>>(self, val: T) -> Self {
let mut this = self;
this.thumbnail = Some(val.into());
this
}
/// Thumbnail of the album cover to which the music file belongs
#[must_use]
pub fn thumbnail_option<T: Into<crate::types::PhotoSize>>(self, val: Option<T>) -> Self {
let mut this = self;
this.thumbnail = val.map(Into::into);
this
}
}