gitlab-time-report 1.3.0

Library to generate statistics and charts from GitLab time tracking data.
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

//! Structs for deserializing the JSON response from the GitLab API

use crate::model::TimeLog;
use chrono::Duration;
use serde::Deserialize;
use serde_with::{DurationSeconds, serde_as};

/// The queried GitLab repository as it appears in the GitLab API.
#[derive(Debug, Deserialize)]
pub(super) struct Project {
    /// The name of the repository.
    pub(super) name: String,
    /// The time logs of the repository.
    pub(super) timelogs: TimeLogs,
}

/// Time logs as they appear in the GitLab API with pagination information.
#[serde_as]
#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct TimeLogs {
    /// The actual time logs
    pub(super) nodes: Vec<TimeLog>,
    /// Pagination for the GitLab API
    pub(super) page_info: PageInfo,
    /// Total Time spent on the project
    #[serde_as(as = "DurationSeconds<String>")]
    pub(super) total_spent_time: Duration,
}

/// Information to aid in the pagination of the GitLab API.
#[derive(Debug, Deserialize)]
#[serde(rename_all = "camelCase")]
pub(super) struct PageInfo {
    /// When paginating forwards, are there more items?
    pub(super) has_next_page: bool,
    /// When paginating forwards, the cursor to continue.
    pub(super) end_cursor: Option<String>,
}

/// The top-level node of a GitLab API response.
#[derive(Debug, Deserialize)]
pub(super) struct ApiResponse {
    /// The response data.
    pub(super) data: Data,
    /// Possible GraphQL errors that occurred in the query.
    pub(super) errors: Option<GraphQlErrors>,
}

/// Response data of the GitLab API.
#[derive(Debug, Deserialize)]
pub(super) struct Data {
    /// The data of the project if it exists and is accessed with the right permissions.
    pub(super) project: Option<Project>,
}

/// A list of GraphQL errors that occurred during the query.
#[derive(Debug, Deserialize)]
pub(super) struct GraphQlErrors {
    pub(super) errors: Vec<GraphQlError>,
}

/// The actual GraphQL error.
#[derive(Debug, Deserialize)]
pub(super) struct GraphQlError {
    pub(super) message: String,
}