serverust_cli/
lib.rs

1//! CLI do framework **serverust**, com paridade conceitual ao `@nestjs/cli`.
2//!
3//! O binário `serverust` provê comandos para scaffolding e workflow de
4//! desenvolvimento/deploy:
5//!
6//! ```text
7//! serverust new <name>                       # cria um projeto novo
8//! serverust generate <kind> <name>           # scaffolding (resource, module, ...)
9//! serverust dev                              # cargo watch -x run
10//! serverust build [--release]                # cargo build
11//! serverust deploy lambda [--arch arm64|x86_64]
12//! serverust info                             # versões e features
13//! serverust openapi --out openapi.json       # exporta spec sem subir servidor
14//! ```
15//!
16//! Este crate expõe também a lib (`serverust_cli`) com módulos
17//! [`cli`] (definições clap), [`commands`] (construção testável de
18//! `std::process::Command`), [`scaffold`] (IO em base dir parametrizada) e
19//! [`templates`] (strings de scaffolding). A separação permite testar parse +
20//! geração de arquivos em tempdir sem spawn de processos reais.
21
22pub mod cli;
23pub mod commands;
24pub mod scaffold;
25pub mod templates;
26
27use anyhow::Result;
28
29use crate::cli::{Cli, Command, DeployTarget};
30
31/// Executa um comando da CLI já parseado.
32///
33/// Operações de IO (criação de arquivos, spawn de processos) são executadas
34/// aqui; a separação em módulos mantém a lógica testável sem efeitos colaterais.
35pub fn run(cli: Cli) -> Result<()> {
36    match cli.command {
37        Command::New { name } => {
38            let cwd = std::env::current_dir()?;
39            scaffold::new_project(&cwd, &name)?;
40            println!("✓ project created at {}/{}", cwd.display(), name);
41            Ok(())
42        }
43        Command::Generate { kind, name } => {
44            let cwd = std::env::current_dir()?;
45            scaffold::generate(&cwd, kind, &name)?;
46            println!("✓ {kind:?} '{name}' generated");
47            Ok(())
48        }
49        Command::Dev => {
50            require_cargo_subcommand("watch", "cargo install cargo-watch")?;
51            spawn_status(commands::dev_cargo_command(), "dev")
52        }
53        Command::Build { release } => spawn_status(commands::build_cargo_command(release), "build"),
54        Command::Deploy { target } => match target {
55            DeployTarget::Lambda { arch } => {
56                require_cargo_subcommand(
57                    "lambda",
58                    "cargo install cargo-lambda  # ou https://www.cargo-lambda.info/guide/installation.html",
59                )?;
60                spawn_status(commands::deploy_lambda_cargo_command(arch), "deploy lambda")
61            }
62        },
63        Command::Info => {
64            println!("{}", commands::info_text());
65            Ok(())
66        }
67        Command::Openapi { out } => spawn_status(commands::openapi_export_command(&out), "openapi"),
68    }
69}
70
71/// Confirma que `cargo-<subcommand>` está disponível no PATH antes de chamar.
72///
73/// Em vez de deixar o cargo cuspir o erro padrão (`error: no such command: ...`),
74/// emitimos uma mensagem com o comando exato de instalação. Reduz fricção para
75/// quem está descobrindo o framework e ainda não conhece o ecossistema.
76fn require_cargo_subcommand(subcommand: &str, install_hint: &str) -> Result<()> {
77    let binary = format!("cargo-{subcommand}");
78    let installed = std::process::Command::new(&binary)
79        .arg("--version")
80        .output()
81        .map(|o| o.status.success())
82        .unwrap_or(false);
83    if installed {
84        return Ok(());
85    }
86    anyhow::bail!(
87        "`cargo {subcommand}` não está disponível (necessário para este comando).\n\
88         Instale com:\n    {install_hint}"
89    );
90}
91
92fn spawn_status(mut cmd: std::process::Command, label: &str) -> Result<()> {
93    let status = cmd
94        .status()
95        .map_err(|e| anyhow::anyhow!("failed to spawn {label}: {e}"))?;
96    if !status.success() {
97        anyhow::bail!("{label} failed with status {status}");
98    }
99    Ok(())
100}
serverust_cli/lib.rs

serverust_cli/
lib.rs
