// zotapi - Rust wrapper for Sot API as implemented by Hubzilla
// Copyright (C) 2018 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::{
error::Error,
group::{GroupFetcher, GroupMembersFetcher},
item::ItemBuilder,
abook::AbookFetcher,
abconfig::ABConfigFetcher,
xchan::XChanFetcher,
};
use reqwest::{
self,
header::{ACCEPT, CONTENT_TYPE},
StatusCode,
};
use serde::Serialize;
use serde_urlencoded;
use std::collections::BTreeMap;
use std::io::Read;
pub const ZOTAPI_ABOOK_PATH : &str = "/api/z/1.0/abook";
pub const ZOTAPI_ABCONFIG_PATH : &str = "/api/z/1.0/abconfig";
pub const ZOTAPI_CHANNEL_STREAM_PATH : &str = "/api/z/1.0/channel/stream";
pub const ZOTAPI_NETWORK_STREAM_PATH : &str = "/api/z/1.0/network/stream";
pub const ZOTAPI_GROUP_PATH : &str = "/api/z/1.0/group";
pub const ZOTAPI_GROUP_MEMBERS_PATH : &str = "/api/z/1.0/group_members";
pub const ZOTAPI_ITEM_UPDATE_PATH : &str = "/api/z/1.0/item/update";
pub const ZOTAPI_XCHAN_PATH : &str = "/api/z/1.0/xchan";
pub struct Client {
inner: reqwest::Client,
base_url: String,
user: String,
pw: String,
}
impl Client {
pub fn new(url: &str, user: &str, pw: &str) -> Client {
Client {
inner: reqwest::Client::new(),
base_url: String::from(url),
user: String::from(user),
pw: String::from(pw),
}
}
pub fn abconfig(&self) -> ABConfigFetcher {
ABConfigFetcher::new(self)
}
pub fn abook(&self) -> AbookFetcher {
AbookFetcher::new(self)
}
pub fn channel_stream(&self) -> Result<String, Error> {
self.fetch_stream(ZOTAPI_CHANNEL_STREAM_PATH, &())
}
pub fn network_stream(&self) -> Result<String, Error> {
self.fetch_stream(ZOTAPI_NETWORK_STREAM_PATH, &())
}
pub fn group(&self) -> GroupFetcher {
GroupFetcher::new(self)
}
pub fn group_members(&self) -> GroupMembersFetcher {
GroupMembersFetcher::new(self)
}
pub fn item(&self) -> ItemBuilder {
ItemBuilder::new(self)
}
pub fn xchan(&self) -> XChanFetcher {
XChanFetcher::new(self)
}
fn url<T>(&self, path: &str, args: &T) -> String
where T: Serialize
{
let r = self.base_url.clone() + path;
if let Ok(a) = serde_urlencoded::to_string(args) {
r + "?" + &a
}
else {
r
}
}
pub fn fetch_stream<T>(&self, path: &str, args: &T) -> Result<String, Error>
where T: Serialize
{
let url = dbg!(self.url(path, args));
let res = self.inner.get(&url)
.header(ACCEPT, "application/json")
.basic_auth(self.user.clone(), Some(self.pw.clone()))
.send()?;
handle_result(res)
}
pub fn post_data<T>(&self, path: &str, data: &T) -> Result<String, Error>
where T: Serialize,
{
let url = dbg!(self.url(path, &()));
let res = self.inner.post(&url)
.header(ACCEPT, "application/json")
.header(CONTENT_TYPE, "application/x-www-form-urlencoded")
.basic_auth(self.user.clone(), Some(self.pw.clone()))
.form(&data)
.send()?;
handle_result(res)
}
pub fn post_multipart(&self, path: &str, data: &BTreeMap<&str, &str>, files: &Vec<&str>) -> Result<String, Error>
{
let url = dbg!(self.url(path, &()));
let mut form = reqwest::multipart::Form::new();
for (key, value) in data.iter() {
form = form.text(key.to_string(), value.to_string());
}
for f in files.iter() {
form = form.file("media", f).unwrap();
}
let res = self.inner.post(&url)
.basic_auth(self.user.clone(), Some(self.pw.clone()))
.header(CONTENT_TYPE, "multipart/form-data")
.multipart(form)
.send()?;
handle_result(res)
}
}
// A common function for handling the response after a request.
//
// Consumes the response, and return it as a string or an error.
fn handle_result(mut res: reqwest::Response) -> Result<String, Error> {
match res.status() {
StatusCode::UNAUTHORIZED => Err(Error::Unauthorized),
StatusCode::OK => {
let mut body = String::new();
res.read_to_string(&mut body)?;
Ok(body)
},
_ => {
eprintln!("Received unknown status: {:?}", res.status());
Err(Error::Unknown)
}
}
}