opy-cli 0.1.56

Standalone OPY CLI: check, compile, inspect, and version.
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use std::path::PathBuf;

use clap::{Args, Parser, Subcommand, ValueEnum};

#[derive(Debug, Parser)]
#[command(
    name = "opy-cli",
    disable_version_flag = true,
    disable_help_subcommand = true,
    subcommand_precedence_over_arg = true,
    about = "Workshop-independent OPY tooling",
    after_help = EXIT_CODES
)]
pub(crate) struct Cli {
    #[command(subcommand)]
    pub(crate) command: Option<Command>,

    /// Print the same version identity as the `version` command.
    #[arg(short = 'V', long, global = true, action = clap::ArgAction::SetTrue)]
    pub(crate) version: bool,

    /// Presentation renderer; `auto` detects terminals, CI, and GitHub Actions.
    #[arg(long, global = true, value_enum, default_value_t = RendererArg::Auto)]
    pub(crate) renderer: RendererArg,

    /// ANSI color policy.
    #[arg(long, global = true, value_enum, default_value_t = ColorArg::Auto)]
    pub(crate) color: ColorArg,
}

pub(crate) const EXIT_CODES: &str = "EXIT CODES:
    0  clean or successful operation
    1  source diagnostics
    2  usage or I/O error";

#[derive(Debug, Subcommand)]
pub(crate) enum Command {
    /// Parse, preprocess, and resolve; print diagnostics to stderr.
    Check(CheckArgs),
    /// Compile OPY source into canonical Workshop text.
    Compile(CompileArgs),
    /// Print the resolved program model as JSON.
    Inspect(FileArgs),
    /// Generate static shell completion from this command model.
    Completion(CompletionArgs),
    /// Show the top-level help.
    Help,
    /// Print crate and language protocol identities.
    Version,
}

#[derive(Debug, Args)]
pub(crate) struct CheckArgs {
    #[command(flatten)]
    pub(crate) file: FileArgs,

    /// Output format; JSON contains only the check result and diagnostics.
    #[arg(long, value_enum, default_value_t = OutputFormatArg::Text)]
    pub(crate) format: OutputFormatArg,
}

#[derive(Debug, Args)]
pub(crate) struct CompileArgs {
    #[command(flatten)]
    pub(crate) file: FileArgs,

    /// Output format; JSON contains the versioned compile report.
    #[arg(long, value_enum, default_value_t = OutputFormatArg::Text)]
    pub(crate) format: OutputFormatArg,

    /// Workshop locale declared by the canonical catalog.
    #[arg(long, default_value = "en-US", value_name = "LOCALE")]
    pub(crate) language: String,
}

#[derive(Debug, Args)]
pub(crate) struct FileArgs {
    /// Main OPY source file.
    #[arg(value_name = "MAIN.OPY")]
    pub(crate) main: PathBuf,
}

#[derive(Debug, Args)]
pub(crate) struct CompletionArgs {
    /// Shell to generate completion for.
    #[arg(value_enum, value_name = "SHELL")]
    pub(crate) shell: ShellArg,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq, ValueEnum)]
pub(crate) enum RendererArg {
    Auto,
    Terminal,
    Plain,
    #[value(name = "github-actions", alias = "github")]
    GithubActions,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq, ValueEnum)]
pub(crate) enum ColorArg {
    Auto,
    Always,
    Never,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq, ValueEnum)]
pub(crate) enum OutputFormatArg {
    Text,
    #[value(alias = "machine")]
    Json,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq, ValueEnum)]
pub(crate) enum ShellArg {
    Bash,
    Zsh,
    Fish,
    #[value(name = "powershell", alias = "pwsh")]
    PowerShell,
}