slotgate 0.5.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

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

// The test names one file declares, read rather than parsed.

use slotgate::config::test_name_reader::TestNameReader;

// A harness attribute above something that is not a function belongs to nothing.
#[test]
fn names_in_a_file_whose_attribute_precedes_a_struct_finds_none() {
    // Arrange & Act
    let names = TestNameReader::names_in("#[test]\nstruct NotATest;\n");

    // Assert
    assert!(names.is_empty(), "{names:?}");
}

// `#[serial]` and friends stack between the harness attribute and the function.
#[test]
fn names_in_a_file_whose_attributes_stack_still_finds_the_test() {
    // Arrange & Act
    let names = TestNameReader::names_in("#[test]\n#[serial]\nfn alpha() {}\n");

    // Assert
    assert_eq!(names, ["alpha"]);
}

// An attribute whose path merely contains `test` is not a harness.
#[test]
fn names_in_a_file_with_a_non_harness_attribute_finds_none() {
    // Arrange & Act
    let names = TestNameReader::names_in("#[cfg(test)]\nfn helper() {}\n");

    // Assert
    assert!(names.is_empty(), "{names:?}");
}

#[test]
fn names_in_a_file_with_an_async_harness_finds_the_test() {
    // Arrange & Act
    let names = TestNameReader::names_in("#[tokio::test]\nasync fn beta() {}\n");

    // Assert
    assert_eq!(names, ["beta"]);
}

#[test]
fn names_in_a_file_with_no_harness_attributes_finds_none() {
    // Arrange & Act
    let names = TestNameReader::names_in("pub mod widget_tests;\nfn helper() {}\n");

    // Assert
    assert!(names.is_empty(), "{names:?}");
}

#[test]
fn names_in_a_file_with_several_tests_finds_them_in_order() {
    // Arrange & Act
    let names = TestNameReader::names_in("#[test]\nfn alpha() {}\n\n#[test]\nfn beta() {}\n");

    // Assert
    assert_eq!(names, ["alpha", "beta"]);
}