asterisk-rs-agi 0.8.0

Async Rust FastAGI server for Asterisk Gateway Interface
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

use asterisk_rs_core::error::ProtocolError;

/// errors specific to the AGI protocol
#[derive(Debug, thiserror::Error)]
#[non_exhaustive]
pub enum AgiError {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("channel hung up during AGI session")]
    ChannelHungUp,

    #[error("invalid AGI response: {raw}")]
    InvalidResponse { raw: String },

    #[error("AGI command failed with code {code}: {message}")]
    CommandFailed { code: u16, message: String },

    #[error("invalid AGI argument: {details}")]
    InvalidArgument { details: String },

    #[error("invalid AGI request: {details}")]
    InvalidRequest { details: String },

    #[error("command already in flight; channel is not cancel-safe")]
    CommandInFlight,

    #[error("channel is poisoned due to a previous incomplete command")]
    ChannelPoisoned,

    #[error("AGI command timed out after {elapsed:?}")]
    CommandTimeout { elapsed: std::time::Duration },

    #[error("AGI request prelude timed out after {elapsed:?}")]
    RequestTimeout { elapsed: std::time::Duration },

    #[error("AGI response exceeds the {limit}-byte limit")]
    ResponseTooLarge { limit: usize },

    #[error("protocol error: {0}")]
    Protocol(#[from] ProtocolError),

    #[error("invalid configuration: {details}")]
    InvalidConfig { details: String },

    #[error("AGI session task failed: {details}")]
    SessionTaskFailed { details: String },
}

pub type Result<T> = std::result::Result<T, AgiError>;