slotgate 0.1.0

A bounded-parallelism job runner that gives each slot its own disjoint port range, so port-binding tests run in parallel without collisions.
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

// Copyright (c) 2025-2026 Umberto Gotti
// SPDX-License-Identifier: MIT

use clap::Parser;
use slotgate::executor::Executor;
use slotgate::gate_args::GateArgs;
use slotgate::job_list_builder::JobListBuilder;
use slotgate::job_runner::JobRunner;
use slotgate::job_status::JobStatus;
use slotgate::port_range_allocator::PortRangeAllocator;
use slotgate::pre_build_runner::PreBuildRunner;
use std::process::ExitCode;
use std::time::Duration;

const LIBTEST_ARGS_FOR_DISCOVERED_BINARY: [&str; 3] = ["{job}", "--exact", "--test-threads=1"];

#[tokio::main]
async fn main() -> ExitCode {
    let args = GateArgs::parse();

    let effective_args = match resolve_pre_build(&args).await {
        Ok(effective_args) => effective_args,
        Err(error) => {
            eprintln!("SLOTGATE — PRE-BUILD FAILED: {error}");
            return ExitCode::FAILURE;
        }
    };

    let jobs = JobListBuilder::build(&effective_args);

    println!(
        "SLOTGATE — {} jobs, max_parallel={}, ports {}-{} per slot",
        jobs.len(),
        effective_args.max_parallel,
        effective_args.port_range_base,
        effective_args.port_range_base as u32 + effective_args.port_range_size as u32 - 1,
    );
    println!();

    let port_allocator = PortRangeAllocator::new(
        effective_args.port_range_base,
        effective_args.port_range_size,
    );
    let job_runner = JobRunner::new(
        effective_args.port_env_base.clone(),
        effective_args.port_env_count.clone(),
        Duration::from_secs(effective_args.timeout_secs),
        effective_args.log_dir.clone(),
    );
    let executor = Executor::new(effective_args.max_parallel, port_allocator, job_runner);

    let outcomes = executor.run_all(jobs, print_outcome_as_it_completes).await;

    let mut passed = 0usize;
    let mut failed = 0usize;
    let mut timed_out = 0usize;
    for outcome in &outcomes {
        match outcome.status {
            JobStatus::Passed => passed += 1,
            JobStatus::Failed => failed += 1,
            JobStatus::TimedOut => timed_out += 1,
        }
    }

    println!();
    println!(
        "SLOTGATE — SUMMARY: {passed} passed, {failed} failed, {timed_out} timed out (of {})",
        outcomes.len()
    );

    if failed == 0 && timed_out == 0 {
        ExitCode::SUCCESS
    } else {
        ExitCode::FAILURE
    }
}

fn print_outcome_as_it_completes(outcome: &slotgate::job_outcome::JobOutcome) {
    let marker = match outcome.status {
        JobStatus::Passed => "PASS",
        JobStatus::Failed => "FAIL",
        JobStatus::TimedOut => "TIMEOUT",
    };
    println!(
        "  [{marker}] {} ({:.2}s)",
        outcome.job_name,
        outcome.duration.as_secs_f64()
    );
}

async fn resolve_pre_build(args: &GateArgs) -> Result<GateArgs, String> {
    let Some(pre_build_program) = &args.pre_build_program else {
        return Ok(args.clone());
    };

    println!(
        "SLOTGATE — PRE-BUILD: {pre_build_program} {}",
        args.pre_build_args.join(" ")
    );
    let discovered = PreBuildRunner::run(
        pre_build_program,
        &args.pre_build_args,
        args.pre_build_target_name.as_deref(),
    )
    .await?;
    println!();

    let Some(executable) = discovered else {
        return Ok(args.clone());
    };

    println!("SLOTGATE — PRE-BUILD discovered test binary: {executable}");
    println!();

    let mut effective_args = args.clone();
    effective_args.program = executable;
    effective_args.program_args = LIBTEST_ARGS_FOR_DISCOVERED_BINARY
        .iter()
        .map(|s| String::from(*s))
        .collect();
    Ok(effective_args)
}