rung 0.2.0

Useful command-line tools for Angular projects written in Rust.
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

//! # Angular utils
//!
//! Provides a collection of utilities to work with Angular configuration.

use anyhow::Result;
use log::info;
use serde::Deserialize;
use std::collections::HashMap;
use std::fs::File;
use std::io::BufReader;
use std::path::PathBuf;

use crate::utils;

/// Workspace configuration file
#[derive(Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct WorkspaceConfig {
    #[serde(rename = "$schema")]
    pub schema: Option<String>,
    /// File format version
    pub version: u32,
    /// Path where new projects will be created.
    pub new_project_root: Option<String>,
    /// Default project name used in commands.
    pub default_project: Option<String>,
    pub projects: Option<HashMap<String, Project>>,
    pub cli: Option<CliOptions>,
    // todo: schematics
}

/// Workspace project
#[derive(Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct Project {
    /// Project type.
    pub project_type: ProjectType,
    pub cli: Option<CliOptions>,
    /// The prefix to apply to generated selectors.
    pub prefix: Option<String>,
    /// Root of the project files.
    pub root: Option<String>,
    /// The root of the source files, assets and index.html file structure.
    pub source_root: Option<String>,
    // todo: schematics
    // todo: i18n
    // todo: architect
    // todo: targets
}

/// Types of the workspace projects
#[derive(PartialEq, Deserialize, Debug)]
#[serde(rename_all = "lowercase")]
pub enum ProjectType {
    Application,
    Library,
}

/// Angular CLI Options
#[derive(Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct CliOptions {
    /// The default schematics collection to use.
    pub default_collection: Option<String>,
    /// Specify which package manager tool to use.
    pub package_manager: Option<PackageManager>,
    /// Control CLI specific console warnings
    pub warnings: Option<CliWarnings>,
    // todo: analytics
}

/// Angular CLI Warnings
#[derive(Deserialize, Debug)]
#[serde(rename_all = "camelCase")]
pub struct CliWarnings {
    /// Show a warning when the global version is newer than the local one.
    pub version_mismatch: bool,
}

/// Types of the supported package managers
#[derive(Deserialize, Debug)]
#[serde(rename_all = "lowercase")]
pub enum PackageManager {
    Npm,
    Cnpm,
    Yarn,
    Pnpm,
}

/// Loads Angular workspace configuration from the file.
pub fn read_config(path: PathBuf) -> Result<WorkspaceConfig> {
    let file = File::open(path)?;
    let reader = BufReader::new(file);
    let config: WorkspaceConfig = serde_json::from_reader(reader)?;

    Ok(config)
}

/// Lists the projects within the workspace configuration
pub fn list_projects(config: &WorkspaceConfig) -> Result<()> {
    let projects = &config.projects.as_ref().unwrap();

    for (key, value) in projects.iter() {
        println!("{} ({:?})", key, value.project_type);
    }

    Ok(())
}

/// List workspace projects based on a specific type
pub fn list_projects_by_type(config: &WorkspaceConfig, project_type: ProjectType) -> Result<()> {
    let projects = &config.projects.as_ref().unwrap();

    for (key, value) in projects.iter() {
        if value.project_type == project_type {
            println!("{}", key);
        }
    }

    Ok(())
}

/// Create new Angular application
pub fn new_application(name: &str, dir: &PathBuf) -> Result<bool> {
    info!("Creating new workspace: {}", name);

    std::fs::create_dir_all(dir)?;

    let args = &["new", name, "--skip-install", "--skip-git"];
    let result = utils::exec_command(dir, "ng", args);

    Ok(result)
}