nest-rs-cli 1.1.0

Scaffolding CLI for NestRS — new projects, feature generators, and project health checks.
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

//! `nestrs g feature <name>` — a transport-agnostic port under
//! `crates/features/src/<name>/` (mod + module + service). Add transports
//! afterwards with `g http|graphql|ws|queue|schedule|mcp <name>`.

use std::path::PathBuf;

use super::support::{finish, resolve_start};
use crate::context::Context;
use crate::error::{CliError, CliResult};
use crate::naming::Names;
use crate::scaffold::{Renderer, Scaffold, ensure_decl};
use crate::templates::feature;

pub struct FeatureOptions {
    pub name: String,
    pub path: Option<PathBuf>,
    pub dry_run: bool,
}

pub fn run(opts: FeatureOptions) -> CliResult<()> {
    let ctx = Context::detect(&resolve_start(opts.path))?;
    let ws = ctx.workspace.ok_or(CliError::NotNestrsWorkspace)?;

    crate::naming::validate_feature_name(&opts.name).map_err(CliError::InvalidFeatureName)?;
    let names = Names::parse(&opts.name);
    let root = ws.feature_root(&names.snake);
    if root.exists() {
        return Err(CliError::FeatureExists {
            name: names.snake.clone(),
            path: root,
        });
    }

    let r = Renderer::new(&names);
    let mut s = Scaffold::new();
    s.create(root.join("mod.rs"), r.render(feature::MOD));
    s.create(root.join("module.rs"), r.render(feature::MODULE));
    s.create(root.join("service.rs"), r.render(feature::SERVICE));
    s.edit(
        ws.features_lib(),
        ensure_decl(&format!("pub mod {};", names.snake)),
    );

    finish(
        s,
        opts.dry_run,
        &ws.root,
        &format!("Created feature `{}`", names.snake),
    )?;
    print_next_steps(&names);
    Ok(())
}

fn print_next_steps(names: &Names) {
    println!();
    println!("Next steps:");
    println!("  Add a transport:  nestrs g http {}", names.kebab);
    println!(
        "                    nestrs g graphql|ws|queue|schedule|mcp {}",
        names.kebab
    );
    println!("  DB-backed CRUD?   nestrs g resource {}", names.kebab);
    println!("  Reference:        crates/features/src/users/");
}