plex-api 0.0.12

Library for communication with Plex server. Work in progress, not ready for any use. See github for details.
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

use crate::{
    http_client::HttpClient, isahc_compat::StatusCodeExt, url::MYPLEX_PRIVACY_PATH, Error,
};
use http::StatusCode;
use serde::Deserialize;

#[derive(Debug, Deserialize)]
#[cfg_attr(feature = "tests_deny_unknown_fields", serde(deny_unknown_fields))]
#[serde(rename_all = "camelCase")]
#[allow(dead_code)]
struct PrivacyApiResponse {
    opt_out_playback: bool,
    opt_out_library_stats: bool,
    domain: String,
    base_url: String,
    metrics: Vec<Metric>,
}

#[derive(Debug)]
pub struct Privacy {
    pub opt_out_playback: bool,
    pub opt_out_library_stats: bool,

    client: HttpClient,
}

#[derive(Debug, Deserialize)]
#[cfg_attr(feature = "tests_deny_unknown_fields", serde(deny_unknown_fields))]
#[allow(dead_code)]
struct Metric {
    event: String,
    status: String,
}

impl Privacy {
    /// Returns current privacy settings, see [Privacy Preferences on plex.tv](https://www.plex.tv/about/privacy-legal/privacy-preferences/#opd).
    #[tracing::instrument(level = "debug", skip_all)]
    pub async fn new(client: HttpClient) -> crate::Result<Self> {
        let p: PrivacyApiResponse = client.get(MYPLEX_PRIVACY_PATH).json().await?;
        Ok(Self {
            opt_out_playback: p.opt_out_playback,
            opt_out_library_stats: p.opt_out_library_stats,
            client,
        })
    }

    /// Changes privacy settings, see [Privacy Preferences on plex.tv](https://www.plex.tv/about/privacy-legal/privacy-preferences/#opd).
    #[tracing::instrument(level = "debug", skip(self))]
    pub async fn update(
        &mut self,
        opt_out_playback: bool,
        opt_out_library_stats: bool,
    ) -> crate::Result<()> {
        let params = vec![
            ("optOutPlayback", if opt_out_playback { "1" } else { "0" }),
            (
                "optOutLibraryStats",
                if opt_out_library_stats { "1" } else { "0" },
            ),
        ];
        let response = self
            .client
            .put(MYPLEX_PRIVACY_PATH)
            .form(&params)?
            .send()
            .await?;
        if response.status().as_http_status() == StatusCode::NO_CONTENT {
            self.opt_out_library_stats = opt_out_library_stats;
            self.opt_out_playback = opt_out_playback;
            Ok(())
        } else {
            Err(Error::from_response(response).await)
        }
    }
}