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
|
//! A collection of newtypes defining type-strong IDs.
use chrono::NaiveDateTime;
use internal::prelude::*;
use serde::de::{Deserialize, Deserializer};
use std::fmt::{Display, Formatter, Result as FmtResult};
use super::utils::U64Visitor;
macro_rules! id_u64 {
($(#[$attr:meta] $name:ident;)*) => {
$(
#[$attr]
#[derive(Copy, Clone, Default, Debug, Eq, Hash, PartialOrd, Ord, Serialize)]
#[allow(derive_hash_xor_eq)]
pub struct $name(pub u64);
impl $name {
/// Retrieves the time that the Id was created at.
pub fn created_at(&self) -> NaiveDateTime {
let offset = (self.0 >> 22) / 1000;
NaiveDateTime::from_timestamp(1_420_070_400 + offset as i64, 0)
}
}
// This is a hack so functions can accept iterators that either:
// 1. return the id itself (e.g: `MessageId`)
// 2. return a reference to it (`&MessageId`).
impl AsRef<$name> for $name {
fn as_ref(&self) -> &Self {
self
}
}
impl From<u64> for $name {
fn from(id_as_u64: u64) -> $name {
$name(id_as_u64)
}
}
impl PartialEq for $name {
fn eq(&self, other: &Self) -> bool {
self.0 == other.0
}
}
impl PartialEq<u64> for $name {
fn eq(&self, u: &u64) -> bool {
self.0 == *u
}
}
impl Display for $name {
fn fmt(&self, f: &mut Formatter) -> FmtResult {
Display::fmt(&self.0, f)
}
}
impl<'de> Deserialize<'de> for $name {
fn deserialize<D: Deserializer<'de>>(deserializer: D) -> StdResult<Self, D::Error> {
deserializer.deserialize_any(U64Visitor).map($name)
}
}
)*
}
}
id_u64! {
/// An identifier for an Application.
ApplicationId;
/// An identifier for a Channel
ChannelId;
/// An identifier for an Emoji
EmojiId;
/// An identifier for a Guild
GuildId;
/// An identifier for an Integration
IntegrationId;
/// An identifier for a Message
MessageId;
/// An identifier for a Role
RoleId;
/// An identifier for a User
UserId;
/// An identifier for a [`Webhook`](struct.Webhook.html).
WebhookId;
/// An identifier for an audit log entry.
AuditLogEntryId;
}
|