use clap::builder::{PossibleValuesParser, TypedValueParser};
use clap::{Parser, Subcommand, ValueEnum};
use telar_project::PageRenderer;
use telar_project::protocol::A11yLevel;
use crate::runner::config::BackendArg;
#[derive(Parser)]
#[command(
name = "cargo-telar",
bin_name = "cargo telar",
disable_help_subcommand = true
)]
pub(crate) struct Cli {
#[command(subcommand)]
pub(crate) command: Option<TelarCommand>,
}
#[derive(Subcommand)]
pub(crate) enum TelarCommand {
New(NewArgs),
Init(InitArgs),
Dev(DevArgs),
Preview(PreviewArgs),
Build(BuildArgs),
Test(TestArgs),
Check(CheckArgs),
Bake,
Transpile,
Package(PackageArgs),
Publish(PublishArgs),
Doctor,
Fmt(FmtArgs),
}
#[derive(clap::Args)]
pub(crate) struct NewArgs {
pub(crate) path: std::path::PathBuf,
#[arg(long)]
pub(crate) name: Option<String>,
#[arg(long, value_enum, default_value = "desktop")]
pub(crate) target: Target,
#[arg(long, value_enum, default_value_t)]
pub(crate) renderer: WebRenderer,
#[arg(long, conflicts_with_all = ["target", "renderer"])]
pub(crate) lib: bool,
}
#[derive(clap::Args)]
pub(crate) struct InitArgs {
pub(crate) path: Option<std::path::PathBuf>,
#[arg(long)]
pub(crate) name: Option<String>,
#[arg(long, value_enum, default_value = "desktop")]
pub(crate) target: Target,
#[arg(long, value_enum, default_value_t)]
pub(crate) renderer: WebRenderer,
#[arg(long, conflicts_with_all = ["target", "renderer"])]
pub(crate) lib: bool,
}
#[derive(clap::Args)]
pub(crate) struct PackageArgs {
#[arg(short = 'p', long, conflicts_with = "workspace")]
pub(crate) package: Option<String>,
#[arg(long)]
pub(crate) workspace: bool,
#[arg(long)]
pub(crate) check: bool,
#[arg(last = true)]
pub(crate) cargo_args: Vec<String>,
}
#[derive(clap::Args)]
pub(crate) struct PublishArgs {
#[arg(short = 'p', long, conflicts_with = "workspace")]
pub(crate) package: Option<String>,
#[arg(long)]
pub(crate) workspace: bool,
#[arg(long)]
pub(crate) dry_run: bool,
#[arg(last = true)]
pub(crate) cargo_args: Vec<String>,
}
#[derive(clap::Args)]
pub(crate) struct FmtArgs {
#[arg(long)]
pub(crate) check: bool,
pub(crate) paths: Vec<std::path::PathBuf>,
}
#[derive(clap::Args, Clone)]
pub(crate) struct CommonArgs {
#[arg(short = 'p', long)]
pub(crate) package: Option<String>,
#[arg(short = 'F', long, value_name = "FEATURES")]
pub(crate) features: Option<String>,
#[arg(long, value_enum)]
pub(crate) target: Option<Target>,
#[arg(long, value_enum)]
pub(crate) backend: Option<BackendArg>,
#[arg(long, value_enum, default_value_t)]
pub(crate) renderer: WebRenderer,
#[arg(last = true)]
pub(crate) cargo_args: Vec<String>,
}
#[derive(clap::Args)]
pub(crate) struct HotArgs {
#[command(flatten)]
pub(crate) common: CommonArgs,
#[arg(long)]
pub(crate) release: bool,
#[arg(long)]
pub(crate) no_hot_reload: bool,
#[arg(long, value_name = "PORT")]
pub(crate) port: Option<u16>,
}
#[derive(clap::Args)]
pub(crate) struct DevArgs {
#[command(flatten)]
pub(crate) hot: HotArgs,
#[arg(long, value_enum)]
pub(crate) devtools: Option<DevtoolsArg>,
}
#[derive(clap::Args)]
pub(crate) struct PreviewArgs {
#[command(flatten)]
pub(crate) hot: HotArgs,
#[arg(value_name = "ID|LINK", conflicts_with_all = ["list", "png"])]
pub(crate) preview: Option<String>,
#[arg(long, conflicts_with = "list")]
pub(crate) component: Option<String>,
#[arg(long)]
pub(crate) list: bool,
#[arg(long, value_name = "DIR", conflicts_with = "list")]
pub(crate) png: Option<std::path::PathBuf>,
#[arg(long, value_name = "DIR", conflicts_with_all = ["list", "png", "preview", "component", "no_hot_reload"])]
pub(crate) build: Option<std::path::PathBuf>,
#[arg(long, value_name = "PATH", requires = "build")]
pub(crate) base: Option<String>,
}
#[derive(clap::Args)]
pub(crate) struct CheckArgs {
#[command(flatten)]
pub(crate) common: CommonArgs,
#[arg(long)]
pub(crate) all_targets: bool,
}
#[derive(clap::Args)]
pub(crate) struct TestArgs {
#[command(flatten)]
pub(crate) common: CommonArgs,
#[arg(long)]
pub(crate) release: bool,
#[arg(long, value_name = "GLOB")]
pub(crate) preview: Option<String>,
#[arg(long, default_value_t, value_parser = a11y_level())]
pub(crate) a11y: A11yLevel,
#[arg(long, conflicts_with = "no_snapshots")]
pub(crate) update_snapshots: bool,
#[arg(long)]
pub(crate) no_snapshots: bool,
#[arg(long, num_args = 2, value_names = ["FORMAT", "PATH"])]
pub(crate) report: Option<Vec<String>>,
}
fn a11y_level() -> impl TypedValueParser<Value = A11yLevel> {
PossibleValuesParser::new(A11yLevel::ALL.map(A11yLevel::as_str))
.try_map(|word| A11yLevel::parse(&word).ok_or(format!("no accessibility level {word:?}")))
}
#[derive(clap::Args)]
pub(crate) struct BuildArgs {
#[command(flatten)]
pub(crate) common: CommonArgs,
#[arg(long, value_enum)]
pub(crate) format: Option<BuildFormat>,
#[arg(long)]
pub(crate) prerender: bool,
}
#[derive(Clone, Copy, PartialEq, Eq, ValueEnum)]
pub(crate) enum Target {
Desktop,
Android,
Tui,
Web,
}
impl Target {
pub(crate) fn feature(self, renderer: WebRenderer) -> &'static str {
match self {
Self::Desktop => "desktop",
Self::Android => "android",
Self::Tui => "tui",
Self::Web => match renderer {
WebRenderer::Dom => "web-dom",
WebRenderer::Canvas => "web",
},
}
}
}
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, ValueEnum)]
pub(crate) enum WebRenderer {
Canvas,
#[default]
Dom,
}
impl From<WebRenderer> for PageRenderer {
fn from(renderer: WebRenderer) -> Self {
match renderer {
WebRenderer::Canvas => Self::Canvas,
WebRenderer::Dom => Self::Dom,
}
}
}
#[derive(Clone, ValueEnum)]
pub(crate) enum DevtoolsArg {
On,
Off,
}
#[derive(Clone, ValueEnum)]
pub(crate) enum BuildFormat {
Appimage,
Deb,
Dmg,
Nsis,
Apk,
Dir,
}
#[cfg(test)]
#[path = "cli.test.rs"]
mod tests;