stctl 0.3.0

The framework experience for Yew.
Documentation 
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

use std::path::PathBuf;
use std::sync::Arc;

use anyhow::{Context, Result};
use clap::{Parser, Subcommand};
use tokio::fs;

use crate::manifest::Manifest;

#[derive(Parser, Debug)]
pub(crate) struct ServeCommand {
    /// Open browser after the development server is ready.
    #[arg(long)]
    pub open: bool,
    /// The name of the env profile. [Default: the same name as the build profile]
    #[arg(long)]
    pub env: Option<String>,
}

#[derive(Parser, Debug)]
pub(crate) struct BuildCommand {
    /// Build artifacts in release mode, with optimizations.
    #[arg(long)]
    pub release: bool,
    /// The name of the env profile. [Default: the same name as the build profile]
    #[arg(long)]
    pub env: Option<String>,
    /// The build target for backend binary. [Default: the native target of the building
    /// environment]
    #[arg(long)]
    pub backend_target: Option<String>,
}

#[derive(Subcommand, Debug)]
pub(crate) enum CliCommand {
    /// Start the development server, serve backend and frontend, watch file changes and
    /// rebuild if needed.
    Serve(ServeCommand),
    /// Build the server and client for final distribution.
    Build(BuildCommand),
    /// Cleans the artifact generated by stctl, cargo and trunk.
    Clean,
}

#[derive(Parser, Debug)]
#[command(author, version, about = "Command line tool for stellation.", long_about = None)]
pub(crate) struct Cli {
    /// The path to the manifest file.
    ///
    /// If you omit this value, it will load from current working directory.
    #[arg(short, long, value_name = "FILE", default_value = "stellation.toml")]
    pub manifest_path: PathBuf,

    #[command(subcommand)]
    pub command: CliCommand,
}

impl Cli {
    pub async fn load_manifest(&self) -> Result<Arc<Manifest>> {
        let manifest_str = fs::read_to_string(&self.manifest_path).await.context(
            "failed to load manifest, do you have stellation.toml in the current directory?",
        )?;

        toml::from_str(&manifest_str)
            .map(Arc::new)
            .context("failed to parse stellation.toml")
    }
}