yt-cli 0.1.1

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

use usage_rs::{Args, RunAsyncWith};
use yt::output::Format;

use super::article_json;
use crate::cli::Ctx;

/// Show an article
#[derive(Args)]
#[usage(effect = "read")]
pub(crate) struct Show {
    /// Article ID (KB-A-12) or article URL
    #[usage(arg, name = "ID")]
    id: String,
    /// Open the article in the browser instead of printing it
    #[usage(short, long)]
    web: bool,
}

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

    async fn run_async_with(self, ctx: &Ctx) -> Self::Output {
        let instance = ctx.instance()?;
        let id = instance.article_id(&self.id)?;
        if self.web {
            let url = instance.article_url(&id);
            if !yt::browser::open(&ctx.env, url.as_str()) {
                ctx.output.write(url.as_str())?;
            }
            return Ok(());
        }
        let client = ctx.client().await?;
        let article = yt::api::articles::get(client, &id).await?;
        match ctx.output.format() {
            Format::Json => return ctx.output.json(&article_json(&instance, &article)),
            Format::Ndjson => return ctx.output.ndjson(&article_json(&instance, &article)),
            Format::Table => {}
        }
        let mut rows: Vec<(String, String)> = Vec::new();
        if let Some(project) = &article.project {
            rows.push(("Project".into(), project.short_name.clone()));
        }
        if let Some(parent) = &article.parent_article {
            rows.push(("Parent".into(), parent.id_readable.clone()));
        }
        if !article.child_articles.is_empty() {
            let children: Vec<&str> = article
                .child_articles
                .iter()
                .map(|child| child.id_readable.as_str())
                .collect();
            rows.push(("Children".into(), children.join(", ")));
        }
        if let Some(author) = &article.reporter {
            rows.push(("Author".into(), author.login.clone()));
        }
        rows.push(("Created".into(), yt::time::local(article.created)));
        rows.push(("Updated".into(), yt::time::local(article.updated)));
        rows.push(("URL".into(), instance.article_url(&id).to_string()));
        let heading = format!("{id}  {}", article.summary.as_deref().unwrap_or(""));
        ctx.output.write(&crate::cli::details(
            &heading,
            rows,
            article.content.as_deref(),
        ))
    }
}