wekan-cli 2.1.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

use crate::client::cards::CardCopyPosition;
use clap::Args;
use serde_json::{Number, Value};

pub(crate) fn identifier(value: &str) -> Result<String, String> {
    let value = crate::client::trim_javascript_whitespace(value);
    if value.is_empty() || matches!(value, "." | "..") {
        Err("ID must be nonblank and cannot be . or ..".into())
    } else {
        Ok(value.to_owned())
    }
}

fn finite_number(value: &str) -> Result<Number, String> {
    let number: Number = value
        .parse()
        .map_err(|_| "position must be a number".to_owned())?;
    if number.as_f64().is_some_and(f64::is_finite) {
        Ok(number)
    } else {
        Err("position must be finite".into())
    }
}

#[derive(Debug, Args)]
pub struct PositionArgs {
    /// Zero-based destination position. Wekan floors fractions and clamps negatives.
    #[arg(long, value_parser = finite_number, allow_hyphen_values = true, conflicts_with = "position_json")]
    pub position: Option<Number>,
    /// Exact JSON position for Wekan's Number coercion; null skips repositioning.
    #[arg(long, value_name = "JSON", value_parser = json_position, allow_hyphen_values = true, conflicts_with = "position")]
    pub position_json: Option<Value>,
}
impl PositionArgs {
    pub(crate) fn into_value(self) -> Option<Value> {
        self.position_json
            .or_else(|| self.position.map(Value::Number))
    }
}
fn json_position(value: &str) -> Result<Value, String> {
    serde_json::from_str(value).map_err(|_| "expected a JSON position".into())
}

#[derive(Debug, Args)]
pub struct CardPositionArgs {
    /// Zero-based destination position. Wekan floors fractions and clamps negatives.
    #[arg(long, value_parser = finite_number, allow_hyphen_values = true, conflicts_with = "position_json")]
    pub position: Option<Number>,
    /// Exact JSON number, string, or null; null positions a card at the top.
    #[arg(long, value_name = "JSON", value_parser = card_position, allow_hyphen_values = true, conflicts_with = "position")]
    pub position_json: Option<CardCopyPosition>,
}
impl CardPositionArgs {
    pub(crate) fn into_value(self) -> Option<CardCopyPosition> {
        self.position_json
            .or_else(|| self.position.map(CardCopyPosition::Number))
    }
}
fn card_position(value: &str) -> Result<CardCopyPosition, String> {
    serde_json::from_str(value).map_err(|_| "expected a JSON number, string, or null".into())
}