yandex-tracker-cli 1.0.1

Token-efficient Yandex Tracker CLI for humans and AI agents
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

//! Project commands. Projects group issues across queues; portfolios sit above
//! them and are out of scope for v1.

use clap::Subcommand;

use crate::cli::{Session, entity};
use crate::exit::ExitCode;

#[derive(Debug, Subcommand)]
pub enum ProjectCommand {
    /// List projects.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PROJECT_LIST))]
    List {
        /// Free-text search over names and descriptions.
        #[arg(long, short = 'Q')]
        query: Option<String>,
        /// 1-based page number.
        #[arg(long, default_value_t = 1)]
        page: u32,
    },
    /// Show one project.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PROJECT_GET))]
    Get {
        /// Project id as returned by `project list`, not an issue key.
        id: String,
    },
    /// Put it inside a portfolio, or take it out of one.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PROJECT_PLACE))]
    Place {
        /// The project to move, by the id `project list` prints.
        id: String,
        /// Portfolio to put it in.
        #[arg(long, conflicts_with = "out")]
        into: Option<String>,
        /// Take it out of whichever portfolio it is in.
        #[arg(long, conflicts_with = "into")]
        out: bool,
    },
    /// Create a project.
    #[command(long_about = crate::cli::help::md(crate::cli::help::ENTITY_CREATE))]
    Create {
        #[command(flatten)]
        fields: entity::Fields,
    },
    /// Change the fields of one.
    #[command(long_about = crate::cli::help::md(crate::cli::help::ENTITY_UPDATE))]
    Update {
        /// The id `project list` prints.
        id: String,
        #[command(flatten)]
        fields: entity::Fields,
    },
    /// Delete one. Needs --yes, and nothing puts it back.
    #[command(long_about = crate::cli::help::md(crate::cli::help::ENTITY_DELETE))]
    Delete {
        /// The id `project list` prints.
        id: String,
    },
}

pub async fn run(command: &ProjectCommand, session: &Session) -> ExitCode {
    match command {
        ProjectCommand::List { query, page } => {
            entity::list("project", query.as_deref(), *page, session).await
        }
        ProjectCommand::Get { id } => entity::get("project", id, session).await,
        ProjectCommand::Place { id, into, out } => {
            if into.is_none() && !*out {
                return crate::cli::report(
                    &"say where: --into <portfolio>, or --out to remove it from one",
                    crate::exit::ExitCode::ConfirmationRequired,
                );
            }
            entity::place("project", id, into.as_deref(), session).await
        }
        ProjectCommand::Create { fields } => entity::create("project", fields, session).await,
        ProjectCommand::Update { id, fields } => {
            entity::update("project", id, fields, session).await
        }
        ProjectCommand::Delete { id } => entity::remove("project", id, session).await,
    }
}