rosu 0.6.0

An osu!api v1 wrapper
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

use super::{Pending, UserIdentification};
use crate::{
    model::{GameMode, User},
    routing::Route,
    Osu,
};

/// Retrieve a [`User`]
///
/// [`User`]: crate::model::User
pub struct GetUser<'a> {
    fut: Option<Pending<'a>>,
    osu: &'a Osu,

    user: Option<UserIdentification>,
    mode: Option<GameMode>,
    event_days: Option<u32>,
}

impl<'a> GetUser<'a> {
    #[inline]
    pub(crate) fn new(osu: &'a Osu, user: impl Into<UserIdentification>) -> Self {
        Self {
            fut: None,
            osu,
            event_days: None,
            mode: None,
            user: Some(user.into()),
        }
    }

    /// Optional, defaults to `Osu`
    #[inline]
    pub fn mode(mut self, mode: GameMode) -> Self {
        self.mode.replace(mode);

        self
    }

    /// Optional, must be between 1 and 31, defaults to 1
    #[inline]
    pub fn event_days(mut self, event_days: u32) -> Self {
        self.event_days.replace(event_days.min(31).max(1));

        self
    }

    fn start(&mut self) {
        let route = Route::GetUser {
            user: self.user.take().unwrap(),
            mode: self.mode.take(),
            event_days: self.event_days.take(),
        };

        #[cfg(feature = "metrics")]
        self.osu.0.metrics.users.inc();

        self.fut.replace(Box::pin(self.osu.request_bytes(route)));
    }
}

poll_req!(GetUser<'_>, User);