wamp 0.1.0

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

#![cfg_attr(feature = "serde_macros", feature(custom_derive, plugin))]
#![cfg_attr(feature = "serde_macros", plugin(serde_macros))]

extern crate serde;
extern crate serde_json;
extern crate ws;
extern crate url;
extern crate rmp;
extern crate rmp_serde;
extern crate rand;
extern crate eventual;

#[macro_use]
extern crate log;

mod messages;
mod utils;
pub mod client;
pub mod router;

use ws::Error as WSError;
use std::fmt;
use url::ParseError;
use std::sync::mpsc::SendError;
use serde_json::Error as JSONError;
use rmp_serde::decode::Error as MsgPackError;

pub use messages::{URI, Dict, List, Value, Reason, MatchingPolicy, InvocationPolicy, CallError, ArgList, ArgDict};
use messages::{ErrorType, Message};
pub use client::{Client, Connection};
pub use router::Router;

pub type CallResult<T> = Result<T, CallError>;
pub type WampResult<T> = Result<T, Error>;
pub type ID = u64;

#[derive(Debug)]
pub struct Error {
    kind: ErrorKind
}

#[derive(Debug)]
pub enum ErrorKind {
    WSError(WSError),
    URLError(ParseError),
    UnexpectedMessage(&'static str), // Used when a peer receives another message before Welcome or Hello
    ThreadError(SendError<messages::Message>),
    ConnectionLost,
    Closing(String),
    JSONError(JSONError),
    MsgPackError(MsgPackError),
    MalformedData,
    InvalidMessageType(Message),
    InvalidState(&'static str),
    Timeout,
    ErrorReason(ErrorType, ID, Reason),
}
impl Error {
    fn new(kind: ErrorKind) -> Error {
        Error {
            kind: kind
        }
    }

    fn get_description(&self) -> String {
        format!("WAMP Error: {}", self.kind.description())
    }

    #[inline]
    fn get_kind(self) -> ErrorKind{
        self.kind
    }
}


impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "{}", self.get_description())
    }
}

impl ErrorKind {
    fn description(&self) -> String {
        match self {
            &ErrorKind::WSError(ref e) => e.to_string(),
            &ErrorKind::UnexpectedMessage(s) => s.to_string(),
            &ErrorKind::URLError(ref e) => e.to_string(),
            &ErrorKind::ThreadError(ref e) => e.to_string(),
            &ErrorKind::ConnectionLost => "Connection Lost".to_string(),
            &ErrorKind::Closing(ref s) => s.clone(),
            &ErrorKind::JSONError(ref e) => e.to_string(),
            &ErrorKind::MsgPackError(ref e) => e.to_string(),
            &ErrorKind::MalformedData => "Malformed Data".to_string(),
            &ErrorKind::InvalidMessageType(ref t) => format!("Invalid Message Type: {:?}", t),
            &ErrorKind::InvalidState(ref s) => s.to_string(),
            &ErrorKind::Timeout => "Connection timed out".to_string(),
            &ErrorKind::ErrorReason(_, _, ref s) => s.to_string(),
        }
    }
}