pavex_cli_client/
client.rs

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
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
use std::{path::PathBuf, process::Command};

use pavex::blueprint::Blueprint;

use crate::commands::generate::GenerateBuilder;
use crate::commands::new::NewBuilder;
use crate::config::Color;

/// A fluent API for configuring and executing `pavex`'s CLI commands.
#[derive(Clone, Debug)]
pub struct Client {
    pavex_cli_path: Option<PathBuf>,
    color: Color,
    debug: bool,
    log: bool,
    log_filter: Option<String>,
    perf_profile: bool,
}

impl Default for Client {
    fn default() -> Self {
        Self {
            pavex_cli_path: None,
            color: Color::Auto,
            debug: false,
            log: false,
            log_filter: None,
            perf_profile: false,
        }
    }
}

impl Client {
    /// Create a new `Client` with the default configuration.
    pub fn new() -> Self {
        Self::default()
    }

    /// Convert this `Client` into a `std::process::Command` that will run `pavex`
    /// with the chosen configuration.
    fn command(self) -> Command {
        let pavex_path = self.pavex_cli_path.unwrap_or_else(|| "pavex".into());
        let mut cmd = Command::new(pavex_path);

        match self.color {
            Color::Auto => {}
            Color::Always => {
                cmd.arg("--color").arg("always");
            }
            Color::Never => {
                cmd.arg("--color").arg("never");
            }
        }

        if self.debug {
            cmd.arg("--debug");
        }

        if self.log {
            cmd.arg("--log");
        }

        if let Some(filter) = self.log_filter {
            cmd.arg("--log-filter").arg(filter);
        }

        if self.perf_profile {
            cmd.arg("--perf-profile");
        }

        cmd
    }

    /// Start building the configuration for the code-generator.
    ///
    /// You must specify:
    ///
    /// - The `Blueprint` for the application that you want to generate;
    /// - The directory where the generated code should be written.
    pub fn generate(self, blueprint: Blueprint, output_directory: PathBuf) -> GenerateBuilder {
        let cmd = self.command();
        GenerateBuilder::new(cmd, blueprint, output_directory)
    }
}

/// Setters for optional configuration knobs on `Client`.
impl Client {
    /// Set the path to the `pavex` executable.
    ///
    /// If this is not set, we will assume that `pavex` is in the `PATH`.
    pub fn pavex_cli_path(mut self, path: PathBuf) -> Self {
        self.pavex_cli_path = Some(path);
        self
    }

    /// Set whether to use colors in the output of Pavex's code generator.
    ///
    /// If this is not set, Pavex will automatically determine whether to use colors or not.
    pub fn color(mut self, color: Color) -> Self {
        self.color = color;
        self
    }

    /// Enable debug mode.
    ///
    /// This will print additional debug information when running `pavex` commands.
    pub fn debug(mut self) -> Self {
        self.debug = true;
        self
    }

    /// Disable debug mode.
    ///
    /// `pavex` will not print additional debug information when running commands.  
    /// This is the default behaviour.
    pub fn no_debug(mut self) -> Self {
        self.debug = false;
        self
    }

    /// Start building the configuration for the `new` command.
    ///
    /// You must specify the path where the new project should be created.
    pub fn new_command(self, path: PathBuf) -> NewBuilder {
        let cmd = self.command();
        NewBuilder::new(cmd, path)
    }

    /// Enable logging.
    ///
    /// `pavex` will emit internal log messages to the console.
    pub fn log(mut self) -> Self {
        self.log = true;
        self
    }

    /// Disable logging.
    ///
    /// `pavex` will not emit internal log messages to the console.
    /// This is the default behaviour.
    pub fn no_log(mut self) -> Self {
        self.log = false;
        self
    }

    /// Set the log filter.
    ///
    /// Control which logs are emitted if `--log` or `--perf-profile` are enabled.
    /// If no filter is specified, Pavex will default to `info,pavex=trace`.
    pub fn log_filter(mut self, filter: String) -> Self {
        self.log_filter = Some(filter);
        self
    }

    /// Enable performance profiling.
    ///
    /// `pavex` will serialize to disk tracing information to profile command execution.
    pub fn perf_profile(mut self) -> Self {
        self.perf_profile = true;
        self
    }

    /// Disable performance profiling.
    ///
    /// `pavex` will not serialize to disk tracing information to profile command execution.
    /// This is the default behaviour.
    pub fn no_perf_profile(mut self) -> Self {
        self.perf_profile = false;
        self
    }
}