phoxal 0.25.0

Phoxal - production-oriented autonomous robot framework: the runtime engine and model (the api contract tree lives in phoxal-api, the typed bus in phoxal-bus).
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

//! The runner loads the resolved robot model from a robot root and exposes it to
//! `#[setup]` via `SetupContext::robot()` / `robot_root()` (D33).

use std::path::PathBuf;
use std::sync::OnceLock;
use std::time::Duration;

use phoxal::participant::{ParticipantLaunch, RealClock, run_with};
use phoxal::prelude::*;
use serial_test::serial;

static SEEN: OnceLock<(String, String)> = OnceLock::new();

#[derive(phoxal::Service)]
#[phoxal(id = "reads-robot", api = y2026_1)]
struct ReadsRobot {}

#[phoxal::behavior]
impl ReadsRobot {
    #[setup]
    async fn setup(ctx: &mut SetupContext<Self>) -> Result<Self> {
        // An official-style participant reads its typed state from the robot model.
        let robot = ctx.robot()?;
        let root = ctx.robot_root()?;
        let _ = SEEN.set((
            robot.manifest.identity.id.clone(),
            root.display().to_string(),
        ));
        Ok(Self {})
    }
}

fn fixture_dir() -> PathBuf {
    PathBuf::from(env!("CARGO_MANIFEST_DIR")).join("../fixture/robot/rgbd-imu-diff-drive")
}

#[serial]
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
async fn setup_reads_robot_model_from_the_root() {
    let fixture = fixture_dir();
    let launch = ParticipantLaunch::local("reads-robot-1", "rgbd-imu-diff-drive")
        .with_robot_root(fixture.clone());
    let shutdown = async {
        tokio::time::sleep(Duration::from_millis(50)).await;
    };

    run_with::<ReadsRobot, _, _>(launch, RealClock::new(), shutdown)
        .await
        .expect("runner should complete with a robot root");

    let (id, root) = SEEN.get().expect("setup should have read the robot model");
    assert_eq!(id, "rgbd-imu-diff-drive");
    assert!(root.ends_with("rgbd-imu-diff-drive"));
}

#[serial]
#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
async fn robot_is_absent_without_a_root() {
    // No robot root means `ctx.robot()` errors, so setup fails and the runner
    // surfaces the error.
    let launch = ParticipantLaunch::local("reads-robot-2", "robot");
    let shutdown = async {
        tokio::time::sleep(Duration::from_millis(50)).await;
    };
    let result = run_with::<ReadsRobot, _, _>(launch, RealClock::new(), shutdown).await;
    assert!(
        result.is_err(),
        "setup should fail when no robot model is bound"
    );
}