ghrs 0.1.3

A simple client for GitHub v3 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
87

//! The Event API
use crate::model::Event;
use crate::{Client, Page};

/// A client for the Event API.
///
/// See <https://docs.github.com/en/rest/reference/activity#events>.
pub struct EventsHandler<'a> {
    client: &'a Client,
}

impl<'a> EventsHandler<'a> {
    pub fn new(client: &'a Client) -> EventsHandler {
        EventsHandler { client }
    }

    pub fn list_user_events(&self, user: impl Into<String>) -> ListUserEventsBuilder {
        ListUserEventsBuilder::new(self, user)
    }
}

/// A builder for listing user events
pub struct ListUserEventsBuilder<'a> {
    handler: &'a EventsHandler<'a>,
    user: String,
    accept: Option<String>,
    per_page: Option<u8>,
    page: Option<u8>,
}

impl<'a> ListUserEventsBuilder<'a> {
    fn new(handler: &'a EventsHandler, user: impl Into<String>) -> Self {
        ListUserEventsBuilder {
            handler,
            user: user.into(),
            accept: None,
            per_page: None,
            page: None,
        }
    }

    /// List events for the authenticated user.
    ///
    /// See <https://docs.github.com/en/rest/reference/activity#list-events-for-the-authenticated-user>.
    /// ```no_run
    /// let client = ghrs::Client::new();
    /// let events = client.events().list_user_events("user").per_page(100).send();
    /// ```
    pub fn send(&self) -> Result<Page<Event>, ureq::Error> {
        let mut request = ureq::get(&format!(
            "{}/users/{}/events",
            self.handler.client.base_url, self.user
        ));

        if let Some(token) = self.handler.client.token.clone() {
            request = request.set("Authorization", &format!("token {}", token));
        }
        if let Some(accept) = self.accept.clone() {
            request = request.set("Accept", &accept);
        }
        if let Some(per_page) = self.per_page {
            request = request.query("per_page", &per_page.to_string());
        }
        if let Some(page) = self.page {
            request = request.query("page", &page.to_string());
        }

        let response = request.call()?;
        let user_events = Page::from_response(response)?;
        Ok(user_events)
    }

    pub fn accept(mut self, accept: impl Into<String>) -> Self {
        self.accept = Some(accept.into());
        self
    }

    pub fn per_page(mut self, per_page: impl Into<u8>) -> Self {
        self.per_page = Some(per_page.into());
        self
    }

    pub fn page(mut self, page: impl Into<u8>) -> Self {
        self.page = Some(page.into());
        self
    }
}