wekan-cli 2.0.0

Agent-first, human-friendly command-line client for Wekan
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use crate::{
    client::WekanClientFactory,
    command_result::{
        BoardDependencyCollectionSuccess, CardDependencyCollectionSuccess, CommandSuccess,
        DependencyLine, DependencySummary,
    },
    commands::{
        authenticated::AuthenticatedContext, client_error::map_client_error_with_not_found,
    },
    credentials::CredentialStore,
    error::AppError,
    redaction::Redactor,
};
use clap::Args;

#[derive(Debug, Args)]
#[command(
    after_help = "Examples:\n  wekan dependency list --board board-id\n  wekan dependency list --board board-id --card source-card-id"
)]
pub struct ListArgs {
    /// Wekan board ID.
    #[arg(long = "board", value_parser = super::identifier, help_heading = "Target")]
    board_id: String,
    /// Limit the request to this source card's outgoing dependencies.
    #[arg(long = "card", value_parser = super::identifier, help_heading = "Target")]
    card_id: Option<String>,
}

pub(super) async fn execute(
    args: ListArgs,
    factory: &WekanClientFactory,
    store: &dyn CredentialStore,
) -> Result<CommandSuccess, AppError> {
    let context = AuthenticatedContext::load(factory, store)?;
    let redactor = Redactor::with_secret(context.record().token());
    let map_error = |error| {
        map_client_error_with_not_found(
            error,
            &redactor,
            "dependency listing",
            "the Wekan board or source card was not found",
        )
    };
    if let Some(card_id) = args.card_id {
        let dependencies = context
            .client()
            .card_dependencies(&args.board_id, &card_id, context.record().token())
            .await
            .map_err(map_error)?;
        Ok(CommandSuccess::CardDependencies(
            CardDependencyCollectionSuccess {
                board_id: args.board_id,
                card_id,
                dependencies: dependencies
                    .into_iter()
                    .map(|d| DependencySummary {
                        target_card_id: d.target_card_id,
                        dependency_type: d.dependency_type.as_str().to_owned(),
                        color: d.color,
                        icon: d.icon,
                    })
                    .collect(),
            },
        ))
    } else {
        let dependencies = context
            .client()
            .board_dependencies(&args.board_id, context.record().token())
            .await
            .map_err(map_error)?;
        Ok(CommandSuccess::BoardDependencies(
            BoardDependencyCollectionSuccess {
                board_id: args.board_id,
                dependencies: dependencies
                    .into_iter()
                    .map(|d| DependencyLine {
                        source_card_id: d.source_card_id,
                        source_title: d.source_title,
                        source_card_number: d.source_card_number,
                        target_card_id: d.target_card_id,
                        target_title: d.target_title,
                        target_card_number: d.target_card_number,
                        dependency_type: d.dependency_type.as_str().to_owned(),
                        color: d.color,
                        icon: d.icon,
                    })
                    .collect(),
            },
        ))
    }
}