yt-cli 0.1.0

Command line interface for JetBrains YouTrack
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

use serde_json::json;
use usage_rs::{Args, RunAsyncWith};
use yt::fields::schema::SchemaField;
use yt::output::{Format, Table};

use crate::cli::Ctx;

/// Show a project's custom fields
#[derive(Args)]
#[usage(effect = "read")]
pub(crate) struct Fields {
    /// Project short name
    #[usage(arg, name = "PROJECT")]
    project: String,
}

impl RunAsyncWith<&Ctx> for Fields {
    type Output = yt::Result<()>;

    async fn run_async_with(self, ctx: &Ctx) -> Self::Output {
        let client = ctx.client().await?;
        let projects = yt::api::projects::list(client).await?;
        let project = yt::api::projects::find(&projects, &self.project)?;
        // Always fresh: this is where people look when a value seems to be missing.
        let schema = ctx
            .schema_cache()?
            .refresh(client, &project.short_name)
            .await?;
        let json_of = |field: &SchemaField| {
            json!({
                "name": field.name,
                "aliases": field.aliases,
                "type": field.type_id,
                "multi": field.multi,
                "required": required(field),
                "values": field.values,
            })
        };
        match ctx.output.format() {
            Format::Table => {
                let mut table = Table::new(["NAME", "TYPE", "MULTI", "REQUIRED", "VALUES"]);
                for field in &schema.fields {
                    table.row([
                        field.name.clone(),
                        field.type_id.clone(),
                        yes_no(field.multi),
                        yes_no(required(field)),
                        yt::fields::choices(&field.values),
                    ]);
                }
                ctx.output.table(&table)
            }
            Format::Json => ctx
                .output
                .json(&schema.fields.iter().map(json_of).collect::<Vec<_>>()),
            Format::Ndjson => schema
                .fields
                .iter()
                .try_for_each(|field| ctx.output.ndjson(&json_of(field))),
        }
    }
}

/// A value must be given on create: the field cannot be empty and has no default.
fn required(field: &SchemaField) -> bool {
    !field.can_be_empty && !field.has_default
}

fn yes_no(value: bool) -> String {
    if value { "yes" } else { "no" }.into()
}