aboutsummaryrefslogtreecommitdiffstats
path: root/src/zotapi.rs
blob: 2d50ef36546b6f8f295d92c8cc45c04f15b3f33a (plain) (blame)
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
// zotapi - Rust wrapper for Zot API as implemented by Hubzilla
// Copyright (C) 2023  Harald Eilertsen <haraldei@anduin.net>
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

use crate::Channel;
use url::Url;
use reqwest::{
    self,
    header::{ACCEPT},
};
use serde::Serialize;

#[derive(Debug)]
pub struct ZotApi {
    client: reqwest::Client,
    base_url: Url,
    channel: String,
    pw: String,
}

pub fn new(url: &str, channel: &str, pw: &str) -> ZotApi {
    ZotApi {
        client: reqwest::Client::new(),
        base_url: Url::parse(url).unwrap().join("api/z/1.0/").unwrap(),
        channel: String::from(channel),
        pw: String::from(pw),
    }
}

impl ZotApi {
    /**
     * Returns the channel object of the logged in channel.
     */
    pub async fn verify(&self) -> Result<Channel, Box<dyn std::error::Error>> {
        let raw = self.get("verify").send().await?.text().await?;
        let mut channel: Channel = serde_json::from_str(&raw)?;
        channel.xchan = serde_json::from_str(&raw)?;

        Ok(channel)
    }

    /**
     * Returns the version of the server.
     *
     * This API can be invoked without authentication.
     */
    pub async fn version(&self) -> Result<String, Box<dyn std::error::Error>> {
        Ok(self.get("version").send().await?.text().await?)
    }


    /// Return a RequestBuilder object that's set up with the correct
    /// path and headers for performing a zot api request.
    pub fn get(&self, path: &str) -> reqwest::RequestBuilder {
        self.client.get(&self.url(path, &()))
            .header(ACCEPT, "application/json")
            .basic_auth(self.channel.clone(), Some(self.pw.clone()))
    }

    fn url<T>(&self, path: &str, args: &T) -> String
    where
        T: Serialize + std::fmt::Debug,
    {
        let mut r = self.base_url.clone().join(path).unwrap();

        if let Ok(a) = serde_qs::to_string(dbg!(args)) {
            r.set_query(Some(&a));
        }

        r.to_string()
    }
}