nextcloud-users 0.1.1

Nextcloud user provisioning and server capabilities client
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

use serde::{Deserialize, Serialize};

use super::ServerStatus;
use crate::wire::lossy_opt_u64;

/// Core capabilities exposed by the server.
#[derive(Clone, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
pub struct CoreCapabilities {
    /// Recommended poll interval for client sync in seconds.
    #[serde(
        default,
        alias = "pollinterval",
        alias = "poll_interval",
        deserialize_with = "lossy_opt_u64"
    )]
    pub poll_interval: Option<u64>,
    /// Relative or absolute path to the WebDAV endpoint root (e.g. `"remote.php/webdav"`).
    #[serde(default, alias = "webdav-root", alias = "webdav_root")]
    pub webdav_root: Option<String>,
    /// Server installation and runtime status.
    #[serde(default)]
    pub status: Option<ServerStatus>,
}

impl CoreCapabilities {
    /// Recommended background polling interval in seconds.
    pub const fn poll_interval(&self) -> Option<u64> {
        self.poll_interval
    }

    /// Root WebDAV path advertised by the instance.
    pub fn webdav_root(&self) -> Option<&str> {
        self.webdav_root.as_deref()
    }

    /// Server operational status.
    pub fn status(&self) -> Option<&ServerStatus> {
        self.status.as_ref()
    }
}