flashcron 0.1.0

A lightning-fast, ultra-efficient cron daemon written in Rust - Schedule tasks at the speed of light
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

//! Error types for FlashCron

use std::path::PathBuf;
use thiserror::Error;

/// Result type alias using FlashCron's Error type
pub type Result<T> = std::result::Result<T, Error>;

/// Main error type for FlashCron
#[derive(Error, Debug)]
pub enum Error {
    #[error("Configuration error: {0}")]
    Config(String),

    #[error("Failed to parse config file '{path}': {source}")]
    ConfigParse {
        path: PathBuf,
        #[source]
        source: Box<toml::de::Error>,
    },

    #[error("Failed to read config file '{path}': {source}")]
    ConfigRead {
        path: PathBuf,
        #[source]
        source: std::io::Error,
    },

    #[error("Invalid cron expression '{expr}': {reason}")]
    CronParse { expr: String, reason: String },

    #[error("Job '{job_name}' not found")]
    JobNotFound { job_name: String },

    #[error("Job '{job_name}' failed with exit code {exit_code}")]
    JobFailed { job_name: String, exit_code: i32 },

    #[error("Job '{job_name}' timed out after {timeout_secs}s")]
    JobTimeout { job_name: String, timeout_secs: u64 },

    #[error("Failed to spawn job '{job_name}': {source}")]
    JobSpawn {
        job_name: String,
        #[source]
        source: std::io::Error,
    },

    #[error("Scheduler error: {0}")]
    Scheduler(String),

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Channel send error")]
    ChannelSend,

    #[error("Shutdown signal received")]
    Shutdown,
}

impl Error {
    /// Create a configuration error
    pub fn config(msg: impl Into<String>) -> Self {
        Self::Config(msg.into())
    }

    /// Create a cron parse error
    pub fn cron_parse(expr: impl Into<String>, reason: impl Into<String>) -> Self {
        Self::CronParse {
            expr: expr.into(),
            reason: reason.into(),
        }
    }

    /// Create a job not found error
    pub fn job_not_found(name: impl Into<String>) -> Self {
        Self::JobNotFound {
            job_name: name.into(),
        }
    }

    /// Create a job failed error
    pub fn job_failed(name: impl Into<String>, exit_code: i32) -> Self {
        Self::JobFailed {
            job_name: name.into(),
            exit_code,
        }
    }

    /// Create a job timeout error
    pub fn job_timeout(name: impl Into<String>, timeout_secs: u64) -> Self {
        Self::JobTimeout {
            job_name: name.into(),
            timeout_secs,
        }
    }

    /// Check if this is a shutdown error
    pub fn is_shutdown(&self) -> bool {
        matches!(self, Self::Shutdown)
    }
}