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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

use std::path::Path;

use crate::error::{CliError, CliResult};
use crate::naming::Names;
use crate::scaffold::{Renderer, Scaffold, rustfmt};
use crate::templates::{hello, shared, standalone};

use super::queue_env_files;

pub fn scaffold(output: &Path, names: &Names, dry_run: bool) -> CliResult<()> {
    let root = output.join(&names.kebab);
    if root.exists() {
        return Err(CliError::AlreadyExists(root));
    }

    let r = Renderer::new(names);
    let mut s = Scaffold::new();

    s.create(root.join("Cargo.toml"), r.render(standalone::CARGO));
    s.create(
        root.join("rust-toolchain.toml"),
        r.render(shared::RUST_TOOLCHAIN),
    );
    s.create(root.join(".gitignore"), r.render(shared::GITIGNORE));
    s.create(root.join(".dockerignore"), r.render(shared::DOCKERIGNORE));
    s.create(root.join("Justfile"), r.render(standalone::JUSTFILE));
    s.create(root.join("test.just"), r.render(standalone::TEST_JUSTFILE));
    s.create(root.join("README.md"), r.render(standalone::README));
    s.create(root.join("Dockerfile"), r.render(standalone::DOCKERFILE));
    queue_env_files(&mut s, &root, names, &names.kebab, shared::ENV);

    queue_sources(&mut s, &root.join("src"), names);

    // No live infra involved ⇒ `integration`, never `e2e` (the suite norm).
    s.create(
        root.join("tests/integration/main.rs"),
        r.render(shared::SMOKE),
    );
    // Empty, but present: the test recipes filter on `binary(e2e)`, which
    // nextest refuses to parse when no such binary exists.
    s.create(root.join("tests/e2e/main.rs"), r.render(shared::E2E));

    let report = s.apply(dry_run)?;
    if !dry_run {
        rustfmt(&report.rust_files());
    }

    println!("Created standalone nestrs app at {}", root.display());
    report.print(output);
    print_next_steps(&root);
    Ok(())
}

fn queue_sources(s: &mut Scaffold, src: &Path, names: &Names) {
    let r = Renderer::new(names);
    s.create(src.join("lib.rs"), r.render(standalone::LIB));
    s.create(src.join("main.rs"), r.render(standalone::MAIN));
    s.create(src.join("module.rs"), r.render(standalone::MODULE));

    // The greeting is the shared `hello` module: same service, same `GET /`,
    // laid out for a single crate instead of a feature folder.
    let hello_r = r.with(
        "service_use",
        format!("crate::service::{}", names.service()),
    );
    s.create(src.join("service.rs"), hello_r.render(hello::SERVICE));
    s.create(src.join("controller.rs"), hello_r.render(hello::CONTROLLER));
}

fn print_next_steps(root: &Path) {
    println!();
    println!("Mode: standalone (one crate, logic in src/)");
    println!();
    println!("Next steps:");
    println!("  cd {}", root.display());
    println!("  nestrs run dev");
    println!("  Open http://localhost:3000/ in your browser");
    println!();
}