libawr 0.1.3

基于 ricq 的 QQ 机器人框架，提供一致、易用、简洁的 API。
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

//! 账号信息。
//! 
//! 更多信息请参考 [`AccountInfo`]。

use std::sync::Arc;

use async_trait::async_trait;
use thiserror::Error;

use crate::meta::selector::{Selector, SingleSelector};
use crate::Client;

box_error_impl!(
    ReadAccountInfoError,
    ReadAccountInfoErrorImpl,
    "读取账号信息失败"
);

#[derive(Debug, Error)]
enum ReadAccountInfoErrorImpl {}

/// 账号信息。
///
/// # Python
/// ```python
/// class AccountInfo:
///     @property
///     def nickname(self) -> str: ...
///     @property
///     def age(self) -> int: ...
///     @property
///     def gender(self) -> int: ...
/// ```
#[derive(Debug, Clone)]
pub struct AccountInfo {
    /// 昵称。
    pub nickname: String,
    /// 年龄。
    pub age: u8,
    /// 性别。
    pub gender: u8,
}

/// 账号信息选择器。
///
/// # Python
/// ```python
/// class AccountInfoSelector:
///     ...
/// ```
#[derive(Debug, Clone)]
pub struct AccountInfoSelector {
    client: Arc<Client>,
}

impl AccountInfoSelector {
    pub(crate) fn new(client: Arc<Client>) -> Self {
        Self { client }
    }
}

#[async_trait]
impl Selector for AccountInfoSelector {
    type Target = AccountInfo;
    type Error = ReadAccountInfoError;

    async fn flush(&self) -> &Self {
        self
    }

    fn as_client(&self) -> &Arc<Client> {
        &self.client
    }
}

#[async_trait]
impl SingleSelector for AccountInfoSelector {
    async fn fetch(&self) -> Result<Self::Target, Self::Error> {
        let account_info = self.client.inner.account_info.read().await;
        Ok(AccountInfo {
            nickname: account_info.nickname.clone(),
            age: account_info.age,
            gender: account_info.gender,
        })
    }
}