Skip to main content

kanade_shared/
subject.rs

1pub const COMMANDS_ALL: &str = "commands.all";
2
3pub fn commands_group(name: &str) -> String {
4    format!("commands.group.{name}")
5}
6
7pub fn commands_pc(pc_id: &str) -> String {
8    format!("commands.pc.{pc_id}")
9}
10
11pub fn commands_deploy(job_id: &str) -> String {
12    format!("commands.deploy.{job_id}")
13}
14
15pub fn results(request_id: &str) -> String {
16    format!("results.{request_id}")
17}
18
19pub fn heartbeat(pc_id: &str) -> String {
20    format!("heartbeat.{pc_id}")
21}
22
23pub fn kill(job_id: &str) -> String {
24    format!("kill.{job_id}")
25}
26
27pub fn inventory(pc_id: &str, category: &str) -> String {
28    format!("inventory.{pc_id}.{category}")
29}
30
31pub const INVENTORY_HW: &str = "hw";
32pub const INVENTORY_SW: &str = "sw";
33pub const INVENTORY_NET: &str = "net";
34
35/// `logs.fetch.<pc_id>` — request/reply: operator (or backend) sends
36/// a `LogsRequest`; the addressed agent replies with the tail of its
37/// local log file. On-demand only, no stream.
38pub fn logs_fetch(pc_id: &str) -> String {
39    format!("logs.fetch.{pc_id}")
40}
41
42// v0.14: subject::inventory_request was retired alongside the
43// hardcoded inventory loop. On-demand collection now goes through
44// the normal deploy path (`kanade deploy configs/jobs/inventory-
45// hw.yaml`) — Command + ExecResult + the inventory-fact projector
46// give operators the same effect with no extra subject.
47
48#[cfg(test)]
49mod tests {
50    use super::*;
51
52    #[test]
53    fn commands_all_constant() {
54        assert_eq!(COMMANDS_ALL, "commands.all");
55    }
56
57    #[test]
58    fn commands_group_formats_name() {
59        assert_eq!(commands_group("canary"), "commands.group.canary");
60        assert_eq!(commands_group("wave1"), "commands.group.wave1");
61    }
62
63    #[test]
64    fn commands_pc_formats_id() {
65        assert_eq!(commands_pc("minipc"), "commands.pc.minipc");
66        assert_eq!(commands_pc("PC1234"), "commands.pc.PC1234");
67    }
68
69    #[test]
70    fn commands_deploy_formats_job_id() {
71        let job = "3c3c56b3-c83e-4c27-9fa9-4a75e1f5da6f";
72        assert_eq!(
73            commands_deploy(job),
74            "commands.deploy.3c3c56b3-c83e-4c27-9fa9-4a75e1f5da6f"
75        );
76    }
77
78    #[test]
79    fn results_formats_request_id() {
80        assert_eq!(results("req-1"), "results.req-1");
81    }
82
83    #[test]
84    fn heartbeat_formats_pc_id() {
85        assert_eq!(heartbeat("minipc"), "heartbeat.minipc");
86    }
87
88    #[test]
89    fn kill_formats_job_id() {
90        assert_eq!(kill("testjob1"), "kill.testjob1");
91    }
92
93    #[test]
94    fn logs_fetch_formats_pc_id() {
95        assert_eq!(logs_fetch("minipc"), "logs.fetch.minipc");
96    }
97
98    #[test]
99    fn inventory_formats_pc_id_and_category() {
100        assert_eq!(inventory("minipc", "hw"), "inventory.minipc.hw");
101        assert_eq!(inventory("minipc", INVENTORY_HW), "inventory.minipc.hw");
102        assert_eq!(inventory("minipc", INVENTORY_SW), "inventory.minipc.sw");
103        assert_eq!(inventory("minipc", INVENTORY_NET), "inventory.minipc.net");
104    }
105}