drive-v3 0.6.0

A library for interacting the Google Drive 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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use crate::{Credentials, resources};

/// A Google Drive
/// [discovery document](https://developers.google.com/discovery/v1/reference/apis),
/// which is a machine-readable specification for describing and consuming REST
/// APIs.
///
/// It is used to build client libraries, IDE plugins, and other tools
/// that interact with Google APIs.
///
/// This discovery document contains the Google Drive API requests which are
/// currently implemented in [`drive_v3`](crate).
#[derive(Debug, Clone)]
pub struct Drive {
    /// Uses the
    /// [v3.about](https://developers.google.com/drive/api/reference/rest/v3/about)
    /// resource to get information about the user, the user's Drive, and system
    /// capabilities.
    pub about: resources::About,

    /// Uses the
    /// [v3.apps](https://developers.google.com/drive/api/reference/rest/v3/apps)
    /// resource to get information about a user's apps.
    pub apps: resources::Apps,

    /// Uses the
    /// [v3.changes](https://developers.google.com/drive/api/reference/rest/v3/changes)
    /// resource to get information about a change to a file or shared drive.
    pub changes: resources::Changes,

    /// Uses the
    /// [v3.channels](https://developers.google.com/drive/api/reference/rest/v3/channels)
    /// resource to manage channels.
    pub channels: resources::Channels,

    /// Uses the
    /// [v3.comments](https://developers.google.com/drive/api/reference/rest/v3/comments)
    /// resource to manage comments.
    pub comments: resources::Comments,

    /// Uses the
    /// [v3.drives](https://developers.google.com/drive/api/reference/rest/v3/drives)
    /// resource to manage comments.
    pub drives: resources::Drives,

    /// Uses the
    /// [v3.files](https://developers.google.com/drive/api/reference/rest/v3/files)
    /// resource to get information about the user's files.
    pub files: resources::Files,

    /// Uses the
    /// [v3.permissions](https://developers.google.com/drive/api/reference/rest/v3/permissions)
    /// resource to get information about permissions.
    pub permissions: resources::Permissions,

    /// Uses the
    /// [v3.replies](https://developers.google.com/drive/api/reference/rest/v3/replies)
    /// resource to get information about replies.
    pub replies: resources::Replies,

    /// Uses the
    /// [v3.revisions](https://developers.google.com/drive/api/reference/rest/v3/revisions)
    /// resource to get information about replies.
    pub revisions: resources::Revisions,
}

impl Drive {
    /// Creates a new `Drive` discovery document, with the given [`Credentials`].
    pub fn new( credentials: &Credentials ) -> Self {
        Self {
            about: resources::About::new(credentials),
            apps: resources::Apps::new(credentials),
            changes: resources::Changes::new(credentials),
            channels: resources::Channels::new(credentials),
            comments: resources::Comments::new(credentials),
            drives: resources::Drives::new(credentials),
            files: resources::Files::new(credentials),
            permissions: resources::Permissions::new(credentials),
            replies: resources::Replies::new(credentials),
            revisions: resources::Revisions::new(credentials),
        }
    }
}

#[cfg(test)]
mod tests {
    use super::Drive;
    use crate::utils::test::VALID_CREDENTIALS;
    use crate::resources::{About, Apps, Files, Changes, Channels, Comments,
        Drives, Permissions, Replies, Revisions};

    #[test]
    fn new_test() {
        let credentials = VALID_CREDENTIALS.clone();
        let drive = Drive::new(&credentials);

        assert_eq!( drive.about, About::new(&credentials) );
        assert_eq!( drive.apps, Apps::new(&credentials) );
        assert_eq!( drive.changes, Changes::new(&credentials) );
        assert_eq!( drive.channels, Channels::new(&credentials) );
        assert_eq!( drive.comments, Comments::new(&credentials) );
        assert_eq!( drive.drives, Drives::new(&credentials) );
        assert_eq!( drive.files, Files::new(&credentials) );
        assert_eq!( drive.permissions, Permissions::new(&credentials) );
        assert_eq!( drive.replies, Replies::new(&credentials) );
        assert_eq!( drive.revisions, Revisions::new(&credentials) );
    }
}