feat(nextcloud): add command 'nextcloud board create-label'

src/nextcloud/board.rs

@@ -2,7 +2,7 @@
 use clap::Parser;
 
 use crate::execute::Execute;
-use crate::nextcloud::model::NextcloudBoardId;
+use crate::nextcloud::model::{NextcloudBoardId, NextcloudLabelColour, NextcloudLabelTitle};
 use crate::{p, FullCtx};
 
 #[derive(Parser, Debug)]
@@ -17,6 +17,13 @@ pub enum NextcloudBoardCommand {
         dump: bool,
         board_id: i64,
     },
+    CreateLabel {
+        #[clap(long, action = clap::ArgAction::SetTrue)]
+        dump: bool,
+        board_id: i64,
+        title: String,
+        colour: String,
+    },
 }
 
 impl Execute for NextcloudBoardCommand {
@@ -61,6 +68,35 @@ impl Execute for NextcloudBoardCommand {
                 }
                 Ok(())
             }
+            Self::CreateLabel {
+                dump,
+                board_id,
+                title,
+                colour,
+            } => {
+                let api_result = ctx
+                    .deck_client()
+                    .create_label(
+                        NextcloudBoardId::new(*board_id),
+                        &NextcloudLabelTitle::new(title),
+                        &NextcloudLabelColour::new(colour),
+                    )
+                    .await;
+                if *dump {
+                    p!(ctx.prt, "{}", api_result.text);
+                } else {
+                    let label = api_result.result?;
+                    p!(
+                        ctx.prt,
+                        "{}:{}:{}:{}",
+                        board_id,
+                        label.id,
+                        label.title,
+                        label.color
+                    );
+                }
+                Ok(())
+            }
         }
     }
 }

src/nextcloud/client.rs

@@ -8,7 +8,10 @@ use reqwest::multipart;
 use serde::de::DeserializeOwned;
 use serde_json::json;
 
-use crate::nextcloud::model::{NextcloudCardDescription, NextcloudCardTitle, NextcloudStackTitle};
+use crate::nextcloud::model::{
+    Label, NextcloudCardDescription, NextcloudCardTitle, NextcloudLabelColour, NextcloudLabelTitle,
+    NextcloudStackTitle,
+};
 use crate::{
     api_result::APIResult,
     f,
@@ -181,6 +184,24 @@ impl<'ctx> DeckClient<'ctx> {
         .await
     }
 
+    pub(crate) async fn create_label(
+        &self,
+        board_id: NextcloudBoardId,
+        name: &NextcloudLabelTitle,
+        colour: &NextcloudLabelColour,
+    ) -> APIResult<Label> {
+        self.request_with_body(
+            f!("boards/{board_id}/labels"),
+            json!({
+                "title": name,
+                "color": colour,
+            })
+            .to_string(),
+            |net, url| net.post(url),
+        )
+        .await
+    }
+
     pub(crate) async fn get_card(
         &self,
         board_id: NextcloudBoardId,

src/nextcloud/model.rs

@@ -64,6 +64,22 @@ newtype!(
     Ord,
     "ID of a Nextcloud Label"
 );
+newtype!(
+    NextcloudLabelTitle,
+    String,
+    Display,
+    PartialOrd,
+    Ord,
+    "Title of a Nextcloud Label"
+);
+newtype!(
+    NextcloudLabelColour,
+    String,
+    Display,
+    PartialOrd,
+    Ord,
+    "Colour of a Nextcloud Label"
+);
 newtype!(
     NextcloudOrder,
     i64,
@@ -171,8 +187,8 @@ pub(crate) struct Card {
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
 pub(crate) struct Label {
     pub(crate) id: NextcloudLabelId,
-    pub(crate) title: String,
+    pub(crate) title: NextcloudLabelTitle,
-    pub(crate) color: String,
+    pub(crate) color: NextcloudLabelColour,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]

src/nextcloud/tests/board/create_label.rs

@@ -0,0 +1,97 @@
+//
+use super::*;
+
+#[rstest::fixture]
+fn board_id() -> NextcloudBoardId {
+    NextcloudBoardId::new(2)
+}
+
+#[rstest::fixture]
+fn ctx() -> FullCtx {
+    let fs = given::a_filesystem();
+    let nextcloud_config = given::a_nextcloud_config();
+    let hostname = &nextcloud_config.hostname;
+    let board_id = board_id();
+
+    let mock_net = given::a_network();
+    mock_net
+        .on()
+        .post(crate::f!(
+            "{hostname}/index.php/apps/deck/api/v1.0/boards/{board_id}/labels",
+        ))
+        .body(
+            json!({
+                "title": "my green label",
+                "color": "31CC7C",
+            })
+            .to_string(),
+        )
+        .respond(StatusCode::OK)
+        .body(include_str!(
+            "../../../tests/responses/nextcloud-board-create-label.json"
+        ))
+        .expect("mock request");
+
+    FullCtx {
+        fs: fs.as_real(),
+        net: mock_net.into(),
+        prt: given::a_printer(),
+        cfg: AppConfig {
+            trello: given::a_trello_config(),
+            nextcloud: nextcloud_config,
+        },
+    }
+}
+
+#[rstest::rstest]
+#[test_log::test(tokio::test)]
+async fn dump(ctx: FullCtx, board_id: NextcloudBoardId) {
+    //given
+    let prt = ctx.prt.clone();
+    let prt = prt.as_test().unwrap();
+
+    //when
+    Command::Nextcloud(NextcloudCommand::Board(
+        NextcloudBoardCommand::CreateLabel {
+            dump: true,
+            board_id: board_id.into(),
+            title: "my green label".to_string(),
+            colour: "31CC7C".to_string(),
+        },
+    ))
+    .execute(&ctx)
+    .await
+    .expect("execute");
+
+    //then
+    let output = prt.output();
+    assert_peq!(
+        output.trim(),
+        include_str!("../../../tests/responses/nextcloud-board-create-label.json").trim()
+    );
+}
+
+#[rstest::rstest]
+#[test_log::test(tokio::test)]
+async fn no_dump(ctx: FullCtx, board_id: NextcloudBoardId) {
+    //given
+    let prt = ctx.prt.clone();
+    let prt = prt.as_test().unwrap();
+
+    //when
+    Command::Nextcloud(NextcloudCommand::Board(
+        NextcloudBoardCommand::CreateLabel {
+            dump: false,
+            board_id: board_id.into(),
+            title: "my green label".to_string(),
+            colour: "31CC7C".to_string(),
+        },
+    ))
+    .execute(&ctx)
+    .await
+    .expect("execute");
+
+    //then
+    let output = prt.output();
+    assert_peq!(output.trim(), "2:54:my green label:31CC7C");
+}

src/nextcloud/tests/board/mod.rs

@@ -1,5 +1,6 @@
 //
 use super::*;
 
+mod create_label;
 mod get;
 mod labels;

src/tests/responses/nextcloud-board-create-label.json

@@ -0,0 +1,9 @@
+{
+  "id": 54,
+  "title": "my green label",
+  "color": "31CC7C",
+  "boardId": 1,
+  "cardId": null,
+  "lastModified": null,
+  "ETag": "d41d8cd98f00b204e9800998ecf8427e"
+}