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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use crate::{
    client::WekanClientFactory,
    command_result::{CancellationSuccess, CommandSuccess, DestructiveOperation},
    commands::{
        authenticated::AuthenticatedContext,
        client_error::map_client_error_with_not_found,
        credential_ops::{lock_credential_mutation, map_credential_load_error},
    },
    credentials::CredentialStore,
    error::{AppError, ErrorCode, ErrorDetails},
    exit_code::StableExitCode,
    input::{
        ConfirmationArgs, ConfirmationDecision, ConfirmationProvider, ConfirmationRequest,
        confirm_or_skip, escape_terminal_text,
    },
    redaction::Redactor,
};
use clap::Args;
use time::OffsetDateTime;

#[derive(Debug, Args)]
pub struct DeleteArgs {
    /// Wekan attachment ID to soft-delete.
    #[arg(value_parser = super::identifier)]
    pub attachment_id: String,
    /// Use the board-scoped delete endpoint; omit to use the legacy attachment endpoint.
    #[arg(long="board", value_parser=super::identifier)]
    pub board_id: Option<String>,
    #[command(flatten)]
    pub confirmation: ConfirmationArgs,
}

pub(super) async fn execute(
    a: DeleteArgs,
    factory: &WekanClientFactory,
    store: &dyn CredentialStore,
    confirmation: &dyn ConfirmationProvider,
) -> Result<CommandSuccess, AppError> {
    let context = AuthenticatedContext::load(factory, store)?;
    let guard = lock_credential_mutation(store, context.credential_target())?;
    let request = ConfirmationRequest::new(
        DestructiveOperation::AttachmentDelete,
        format!(
            "Delete Wekan attachment `{}`? Its file is retained for restoration.",
            escape_terminal_text(&a.attachment_id)
        ),
    );
    if confirm_or_skip(&a.confirmation, confirmation, &request)? == ConfirmationDecision::Cancelled
    {
        return Ok(CommandSuccess::Cancelled(CancellationSuccess::new(
            DestructiveOperation::AttachmentDelete,
        )));
    }
    let record = guard
        .load()
        .map_err(map_credential_load_error)?
        .ok_or_else(|| {
            AppError::new(
                ErrorCode::CredentialNotFound,
                "the credential used to prepare attachment deletion is no longer stored; no HTTP request was sent",
                StableExitCode::Credential,
            )
        })?;
    if !record.matches(context.record()) {
        return Err(AppError::new(ErrorCode::CredentialStoreFailed, "the stored credential changed while preparing attachment deletion; no HTTP request was sent", StableExitCode::Credential).with_credential_stored(true));
    }
    if record.token_expires() <= OffsetDateTime::now_utc() {
        return Err(AppError::new(
            ErrorCode::CredentialExpired,
            format!(
                "the stored credential expired at {}; no HTTP request was sent",
                context.token_expires()
            ),
            StableExitCode::Server,
        )
        .with_details(ErrorDetails {
            token_expires: Some(context.token_expires().to_owned()),
            ..ErrorDetails::default()
        }));
    }
    let response = if let Some(board_id) = a.board_id {
        context
            .client()
            .soft_delete_board_attachment(&board_id, &a.attachment_id, context.record().token())
            .await
            .map(|response| {
                CommandSuccess::AttachmentSoftDeleted(
                    crate::command_result::AttachmentSoftDeleteSuccess {
                        board_id,
                        attachment_id: a.attachment_id,
                        deleted: response.deleted,
                        batch_id: response.batch_id,
                    },
                )
            })
    } else {
        context
            .client()
            .delete_attachment(&a.attachment_id, context.record().token())
            .await
            .map(CommandSuccess::AttachmentDeleted)
    };
    drop(guard);
    let response = response.map_err(|e| {
        map_client_error_with_not_found(
            e,
            &Redactor::with_secret(context.record().token()),
            "attachment deletion",
            "the attachment was not found",
        )
    })?;
    Ok(response)
}