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
83
84
85
86
87
88
89
90
91
92

//! Portfolio commands. A portfolio groups projects and other portfolios; the
//! entity endpoints treat it as one more type, so only the word differs.

use clap::Subcommand;

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

#[derive(Debug, Subcommand)]
pub enum PortfolioCommand {
    /// List portfolios.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PORTFOLIO_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 portfolio.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PORTFOLIO_GET))]
    Get {
        /// Portfolio id as returned by `portfolio list`.
        id: String,
    },
    /// List the portfolios and projects inside one.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PORTFOLIO_CONTENTS))]
    Contents {
        /// Portfolio id as returned by `portfolio list`.
        id: String,
        /// 1-based page number.
        #[arg(long, default_value_t = 1)]
        page: u32,
    },
    /// Put it inside a portfolio, or take it out of one.
    #[command(long_about = crate::cli::help::md(crate::cli::help::PORTFOLIO_PLACE))]
    Place {
        /// The portfolio to move, by the id `portfolio 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 portfolio.
    #[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 `portfolio 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 `portfolio list` prints.
        id: String,
    },
}

pub async fn run(command: &PortfolioCommand, session: &Session) -> ExitCode {
    match command {
        PortfolioCommand::List { query, page } => {
            entity::list("portfolio", query.as_deref(), *page, session).await
        }
        PortfolioCommand::Get { id } => entity::get("portfolio", id, session).await,
        PortfolioCommand::Contents { id, page } => entity::contents(id, *page, session).await,
        PortfolioCommand::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("portfolio", id, into.as_deref(), session).await
        }
        PortfolioCommand::Create { fields } => entity::create("portfolio", fields, session).await,
        PortfolioCommand::Update { id, fields } => {
            entity::update("portfolio", id, fields, session).await
        }
        PortfolioCommand::Delete { id } => entity::remove("portfolio", id, session).await,
    }
}