theater-cli 0.2.0

Command-line interface for Theater actor system
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

use anyhow::Result;
use clap::Parser;
use std::net::SocketAddr;
use tracing::debug;

use theater::id::TheaterId;

use crate::{error::CliError, output::formatters::ActorInspection, CommandContext};

#[derive(Debug, Parser)]
pub struct InspectArgs {
    /// Actor ID to inspect
    #[arg(required = true)]
    pub actor_id: TheaterId,

    /// Address of the theater server
    #[arg(short, long)]
    pub address: Option<SocketAddr>,

    /// Show detailed information
    #[arg(short, long)]
    pub detailed: bool,
}

/// Execute the inspect command asynchronously (modernized)
pub async fn execute_async(args: &InspectArgs, ctx: &CommandContext) -> Result<(), CliError> {
    debug!("Inspecting actor: {}", args.actor_id);

    // Get server address from args or config
    let address = ctx.server_address(args.address);
    debug!("Connecting to server at: {}", address);

    // Create client and connect
    let client = ctx.create_client();
    client
        .connect()
        .await
        .map_err(|e| CliError::connection_failed(address, e))?;

    // Collect all actor information
    debug!("Getting actor status");
    let status = client
        .get_actor_status(&args.actor_id.to_string())
        .await
        .map_err(|_e| CliError::actor_not_found(&args.actor_id.to_string()))?;

    debug!("Getting actor state");
    let state_result = client.get_actor_state(&args.actor_id.to_string()).await;
    let state = match state_result {
        Ok(ref state_value) => {
            if state_value.is_null() {
                None
            } else {
                Some(state_value)
            }
        }
        _ => None,
    };

    debug!("Getting actor events");
    let events_result = client.get_actor_events(&args.actor_id.to_string()).await;
    let events = match events_result {
        Ok(events) => events,
        Err(_) => vec![],
    };

    // TODO: Implement metrics when available
    let metrics: Option<serde_json::Value> = None;

    // Create inspection result and output
    let inspection = ActorInspection {
        id: args.actor_id.clone(),
        status: format!("{:?}", status),
        state: state.cloned(),
        events: events.clone(),
        metrics,
        detailed: args.detailed,
    };

    ctx.output.output(&inspection, None)?;
    Ok(())
}