2024-12-17 07:09:49 +00:00
|
|
|
//
|
2024-12-08 17:23:54 +00:00
|
|
|
use bytes::Bytes;
|
|
|
|
use kxio::net::{Net, ReqBuilder};
|
2024-12-08 19:31:10 +00:00
|
|
|
use serde_json::json;
|
2024-12-08 17:23:54 +00:00
|
|
|
|
2024-12-17 07:19:31 +00:00
|
|
|
use crate::nextcloud::model::NextcloudLabelId;
|
2024-12-17 07:09:49 +00:00
|
|
|
use crate::{
|
|
|
|
api_result::APIResult,
|
|
|
|
f,
|
2024-12-17 07:19:31 +00:00
|
|
|
nextcloud::model::{
|
|
|
|
Board, Card, NextcloudBoardId, NextcloudCardId, NextcloudHostname, NextcloudPassword,
|
|
|
|
NextcloudStackId, NextcloudUsername, Stack,
|
2024-12-17 07:09:49 +00:00
|
|
|
},
|
|
|
|
FullCtx,
|
|
|
|
};
|
|
|
|
|
2024-12-08 17:23:54 +00:00
|
|
|
pub(crate) struct DeckClient<'ctx> {
|
|
|
|
ctx: &'ctx FullCtx,
|
|
|
|
hostname: &'ctx NextcloudHostname,
|
|
|
|
username: &'ctx NextcloudUsername,
|
|
|
|
password: &'ctx NextcloudPassword,
|
|
|
|
}
|
|
|
|
|
|
|
|
// Uses the API described here: https://deck.readthedocs.io/en/stable/API/#cards
|
|
|
|
impl<'ctx> DeckClient<'ctx> {
|
|
|
|
pub fn new(ctx: &'ctx FullCtx) -> Self {
|
|
|
|
Self {
|
|
|
|
ctx,
|
|
|
|
hostname: &ctx.cfg.nextcloud.hostname,
|
|
|
|
username: &ctx.cfg.nextcloud.username,
|
|
|
|
password: &ctx.cfg.nextcloud.password,
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
fn url(&self, path: impl Into<String>) -> String {
|
|
|
|
f!(
|
|
|
|
"https://{}/index.php/apps/deck/api/v1.0/{}",
|
|
|
|
self.hostname,
|
|
|
|
path.into()
|
|
|
|
)
|
|
|
|
}
|
|
|
|
|
|
|
|
async fn request<T: for<'a> serde::Deserialize<'a>>(
|
|
|
|
&self,
|
|
|
|
url: impl Into<String>,
|
|
|
|
custom: fn(&Net, String) -> ReqBuilder,
|
|
|
|
) -> APIResult<T> {
|
|
|
|
APIResult::new(
|
|
|
|
custom(&self.ctx.net, self.url(url))
|
|
|
|
.basic_auth(self.username.as_str(), Some(self.password.as_str()))
|
|
|
|
.header("accept", "application/json")
|
|
|
|
.header("content-type", "application/json")
|
|
|
|
.send()
|
|
|
|
.await,
|
|
|
|
&self.ctx.prt,
|
|
|
|
)
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
|
|
|
|
async fn request_with_body<T: for<'a> serde::Deserialize<'a>>(
|
|
|
|
&self,
|
|
|
|
url: impl Into<String>,
|
|
|
|
body: impl Into<Bytes>,
|
|
|
|
custom: fn(&Net, String) -> ReqBuilder,
|
|
|
|
) -> APIResult<T> {
|
|
|
|
APIResult::new(
|
|
|
|
custom(&self.ctx.net, self.url(url))
|
|
|
|
.basic_auth(self.username.as_str(), Some(self.password.as_str()))
|
|
|
|
.header("accept", "application/json")
|
|
|
|
.header("content-type", "application/json")
|
|
|
|
.body(body)
|
|
|
|
.send()
|
|
|
|
.await,
|
|
|
|
&self.ctx.prt,
|
|
|
|
)
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
|
2024-12-17 07:19:31 +00:00
|
|
|
pub(crate) async fn add_label_to_card(
|
|
|
|
&self,
|
|
|
|
board_id: NextcloudBoardId,
|
|
|
|
stack_id: NextcloudStackId,
|
|
|
|
card_id: NextcloudCardId,
|
|
|
|
label_id: NextcloudLabelId,
|
|
|
|
) -> APIResult<()> {
|
2024-12-08 19:31:10 +00:00
|
|
|
self.request_with_body(
|
|
|
|
f!("boards/{board_id}/stacks/{stack_id}/cards/{card_id}/assignLabel"),
|
|
|
|
json!({
|
|
|
|
"labelId": label_id
|
|
|
|
})
|
|
|
|
.to_string(),
|
|
|
|
|net, url| net.put(url),
|
|
|
|
)
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
|
2024-12-08 17:23:54 +00:00
|
|
|
pub(crate) async fn get_boards(&self) -> APIResult<Vec<Board>> {
|
|
|
|
self.request("boards", |net, url| net.get(url)).await
|
|
|
|
}
|
|
|
|
|
|
|
|
pub(crate) async fn get_stacks(&self, board_id: NextcloudBoardId) -> APIResult<Vec<Stack>> {
|
|
|
|
self.request(f!("boards/{board_id}/stacks"), |net, url| net.get(url))
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
|
|
|
|
pub(crate) async fn get_stack(
|
|
|
|
&self,
|
|
|
|
board_id: NextcloudBoardId,
|
|
|
|
stack_id: NextcloudStackId,
|
|
|
|
) -> APIResult<Stack> {
|
|
|
|
self.request(f!("boards/{board_id}/stacks/{stack_id}"), |net, url| {
|
|
|
|
net.get(url)
|
|
|
|
})
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
|
2024-12-17 07:09:49 +00:00
|
|
|
pub(crate) async fn create_card(
|
|
|
|
&self,
|
|
|
|
board_id: NextcloudBoardId,
|
|
|
|
stack_id: NextcloudStackId,
|
|
|
|
title: &str,
|
|
|
|
description: Option<&str>,
|
|
|
|
) -> APIResult<Card> {
|
2024-12-08 19:31:10 +00:00
|
|
|
let mut body = json!({
|
2024-12-17 07:09:49 +00:00
|
|
|
"title": title,
|
2024-12-08 17:23:54 +00:00
|
|
|
});
|
|
|
|
|
2024-12-17 07:09:49 +00:00
|
|
|
if let Some(desc) = &description {
|
2024-12-08 17:23:54 +00:00
|
|
|
body["description"] = serde_json::Value::String(desc.to_string());
|
|
|
|
}
|
|
|
|
|
|
|
|
self.request_with_body(
|
2024-12-17 07:09:49 +00:00
|
|
|
f!("boards/{board_id}/stacks/{stack_id}/cards"),
|
2024-12-08 17:23:54 +00:00
|
|
|
body.to_string(),
|
|
|
|
|net, url| net.post(url),
|
|
|
|
)
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
|
|
|
|
pub(crate) async fn get_card(
|
|
|
|
&self,
|
|
|
|
board_id: NextcloudBoardId,
|
|
|
|
stack_id: NextcloudStackId,
|
|
|
|
card_id: NextcloudCardId,
|
|
|
|
) -> APIResult<Card> {
|
|
|
|
self.request(
|
|
|
|
f!("boards/{board_id}/stacks/{stack_id}/cards/{card_id}"),
|
|
|
|
|net, url| net.get(url),
|
|
|
|
)
|
|
|
|
.await
|
|
|
|
}
|
|
|
|
}
|