Enum TaskMonitorError

Source

pub enum TaskMonitorError {
    ConfigParse(String),
    CircularDependency(String),
    DependencyNotFound {
        dependency_task_name: String,
        task_name: String,
    },
    ControlError(ControlCommandError),
}

Expand description

Main error type for task monitoring operations.

Covers various error conditions that can occur during task monitoring setup and execution, including configuration parsing, dependency validation, and runtime communication errors.

§Examples

§Handling Circular Dependencies

use std::collections::HashMap;
use tcrm_monitor::monitor::{TaskMonitor, config::TaskSpec, error::TaskMonitorError};
use tcrm_task::tasks::config::TaskConfig;

let mut tasks = HashMap::new();
tasks.insert(
    "a".to_string(),
    TaskSpec::new(TaskConfig::new("echo").args(["a"]))
        .dependencies(["b"])
);
tasks.insert(
    "b".to_string(),
    TaskSpec::new(TaskConfig::new("echo").args(["b"]))
        .dependencies(["a"])
);

match TaskMonitor::new(tasks) {
    Err(TaskMonitorError::CircularDependency(task)) => {
        println!("Circular dependency involving: {}", task);
        panic!("Expected circular dependency error");
    }
    _ => panic!("Expected error"),
}

§Handling Missing Dependencies

use std::collections::HashMap;
use tcrm_monitor::monitor::{TaskMonitor, config::TaskSpec, error::TaskMonitorError};
use tcrm_task::tasks::config::TaskConfig;

let mut tasks = HashMap::new();
tasks.insert(
    "build".to_string(),
    TaskSpec::new(TaskConfig::new("cargo").args(["build"]))
        .dependencies(["nonexistent"])
);

match TaskMonitor::new(tasks) {
    Err(TaskMonitorError::DependencyNotFound { task_name, dependency_task_name }) => {
        println!("Task '{}' depends on missing task '{}'", task_name, dependency_task_name);
        panic!("Expected missing dependency error");
    }
    _ => panic!("Expected error"),
}

Variants§

§

ConfigParse(String)

Configuration parsing failed.

This error occurs when task configuration cannot be parsed or contains invalid values.

§Examples

use tcrm_monitor::monitor::error::TaskMonitorError;

let error = TaskMonitorError::ConfigParse("Invalid timeout value".to_string());
assert!(error.to_string().contains("Config parse error"));

§

CircularDependency(String)

A circular dependency was detected in the task graph.

Contains the name of a task involved in the circular dependency.

§Examples

use tcrm_monitor::monitor::error::TaskMonitorError;

let error = TaskMonitorError::CircularDependency("task_a".to_string());
assert!(error.to_string().contains("Circular dependency"));

§

DependencyNotFound

A task depends on another task that doesn’t exist.

This error is returned during task graph validation when a dependency is specified that doesn’t correspond to any defined task.

§Examples

use tcrm_monitor::monitor::error::TaskMonitorError;

let error = TaskMonitorError::DependencyNotFound {
    task_name: "build".to_string(),
    dependency_task_name: "nonexistent".to_string()
};
assert!(error.to_string().contains("not found"));