Struct Config 

pub struct Config {
    pub keep_going: bool,
    pub watch: Vec<PathBuf>,
    pub readiness_fallback_timeout: Duration,
    pub prefix_width: usize,
    pub colors: Vec<AnsiColors>,
    pub show_timestamps: bool,
    pub prox_color: AnsiColors,
    pub handle_control_c: bool,
    pub output_idle_debounce_ms: u64,
}

Configuration for the process manager

Fields

keep_going: bool

Whether to continue running/watching on a process exit

watch: Vec<PathBuf>

Global watch paths

readiness_fallback_timeout: Duration

Timeout for process readiness if a readiness pattern is not specified

prefix_width: usize

Width of the process prefix in log output

colors: Vec<AnsiColors>

Colors to use for process output prefixes

show_timestamps: bool

Whether to show timestamps in prox logs (not process logs)

prox_color: AnsiColors

Color for prox system logs

handle_control_c: bool

Whether to hook and handle Ctrl-C internally (SIGINT) (default: true for lib. Ignored for bin.)

output_idle_debounce_ms: u64

Debounce time in milliseconds after which output is considered idle

Implementations

impl Config

pub fn builder() -> ConfigBuilder<((), (), (), (), (), (), (), (), ())>

Create a builder for building Config. On the builder, call .keep_going(...)(optional), .watch(...)(optional), .readiness_fallback_timeout(...)(optional), .prefix_width(...)(optional), .colors(...)(optional), .show_timestamps(...)(optional), .prox_color(...)(optional), .handle_control_c(...)(optional), .output_idle_debounce_ms(...)(optional) to set the values of the fields. Finally, call .build() to create the instance of Config.

Examples found in repository

examples/basic_usage.rs (line 10)

fn main() -> anyhow::Result<()> {
    // Example: Simple process manager with multiple services
    let mut manager = Prox::builder()
        .config(
            Config::builder()
                .readiness_fallback_timeout(Duration::from_secs(15))
                .build(),
        )
        .procs(
            [
                Proc::builder()
                    .name("api".into())
                    .command("cargo".into())
                    .args(vec!["run".into(), "--bin".into(), "api".into()])
                    .working_dir(PathBuf::from("./api"))
                    .readiness_pattern("Server listening".into())
                    .watch(vec![
                        PathBuf::from("./api/src"),
                        PathBuf::from("./shared/src"),
                    ])
                    .env(HashMap::from_iter([("LOG_LEVEL".into(), "debug".into())]))
                    .color(AnsiColors::BrightGreen)
                    .build(),
                Proc::builder()
                    .name("database".into())
                    .command("docker".into())
                    .args(["run".into()].into())
                    .env(
                        [
                            ("POSTGRES_DB".into(), "myapp".into()),
                            ("POSTGRES_PASSWORD".into(), "password".into()),
                        ]
                        .into(),
                    )
                    .readiness_pattern("database system is ready to accept connections".into())
                    .build(),
                Proc::builder()
                    .name("frontend".into())
                    .command("npm".into())
                    .args(vec!["run".into(), "dev".into()])
                    .working_dir(PathBuf::from("./frontend"))
                    .readiness_pattern("Local:".into())
                    .watch(vec![PathBuf::from("./frontend/src")])
                    .color(AnsiColors::BrightYellow)
                    .build(),
            ]
            .into(),
        )
        .build();

    println!("Starting development environment...");

    // Start all processes - this will block until Ctrl+C or a process exits
    manager.start()?;

    Ok(())
}

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Config

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.