wascc-actor 0.7.4

SDK for developing WebAssembly Actor modules for hosting in waSCC
Documentation
// Copyright 2015-2019 Capital One Services, LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//! # Errors
//!
//! This module contains types and utility functions for error handling

use std::error::Error as StdError;
use std::fmt;

#[derive(Debug)]
pub struct Error(Box<ErrorKind>);

pub(crate) fn new(kind: ErrorKind) -> Error {
    Error(Box::new(kind))
}

#[derive(Debug)]
pub enum ErrorKind {
    KeyValueError(String),
    MessagingError(String),
    MiscError(Box<dyn ::std::error::Error>),
    EnvVar(std::env::VarError),
    UTF8(std::string::FromUtf8Error),
    UTF8Str(std::str::Utf8Error),
    JsonMarshaling(serde_json::Error),
    HostError(String),
    BadDispatch(String),
    WapcError(wapc::errors::Error),
}

impl Error {
    pub fn kind(&self) -> &ErrorKind {
        &self.0
    }

    pub fn into_kind(self) -> ErrorKind {
        *self.0
    }
}

impl StdError for Error {
    fn description(&self) -> &str {
        match *self.0 {
            ErrorKind::KeyValueError(_) => "Key/value store error",
            ErrorKind::UTF8(_) => "UTF8 encoding failure",
            ErrorKind::MessagingError(_) => "Messaging error",
            ErrorKind::EnvVar(_) => "Environment variable error",
            ErrorKind::JsonMarshaling(_) => "JSON encoding/decoding failure",
            ErrorKind::UTF8Str(_) => "UTF8 encoding failure",
            ErrorKind::HostError(_) => "Host Error",
            ErrorKind::BadDispatch(_) => "Bad dispatch",
            ErrorKind::WapcError(_) => "waPC failure",
            ErrorKind::MiscError(_) => "Misc error",
        }
    }

    fn cause(&self) -> Option<&dyn StdError> {
        match *self.0 {
            ErrorKind::KeyValueError(_) => None,
            ErrorKind::UTF8(ref e) => Some(e),
            ErrorKind::MessagingError(_) => None,
            ErrorKind::EnvVar(ref e) => Some(e),
            ErrorKind::JsonMarshaling(ref e) => Some(e),
            ErrorKind::UTF8Str(ref e) => Some(e),
            ErrorKind::HostError(_) => None,
            ErrorKind::BadDispatch(_) => None,
            ErrorKind::WapcError(ref e) => Some(e),
            ErrorKind::MiscError(_) => None,
        }
    }
}

impl fmt::Display for Error {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self.0 {
            ErrorKind::KeyValueError(ref msg) => write!(f, "Key/Value error: {}", msg),
            ErrorKind::UTF8(ref e) => write!(f, "UTF8 encoding error: {}", e),
            ErrorKind::MessagingError(ref msg) => write!(f, "Messaging error: {}", msg),
            ErrorKind::EnvVar(ref e) => write!(f, "Environment variable error: {}", e),
            ErrorKind::JsonMarshaling(ref e) => write!(f, "JSON marshaling error: {}", e),
            ErrorKind::UTF8Str(ref e) => write!(f, "UTF8 error: {}", e),
            ErrorKind::HostError(ref e) => write!(f, "Host error: {}", e),
            ErrorKind::BadDispatch(ref e) => write!(f, "Bad dispatch, attempted operation: {}", e),
            ErrorKind::WapcError(ref e) => write!(f, "waPC error: {}", e),
            ErrorKind::MiscError(ref e) => write!(f, "Misc error: {}", e),
        }
    }
}

impl From<wapc::errors::Error> for Error {
    fn from(source: wapc::errors::Error) -> Error {
        new(ErrorKind::WapcError(source))
    }
}

impl From<std::str::Utf8Error> for Error {
    fn from(source: std::str::Utf8Error) -> Error {
        Error(Box::new(ErrorKind::UTF8Str(source)))
    }
}

impl From<serde_json::Error> for Error {
    fn from(source: serde_json::Error) -> Error {
        Error(Box::new(ErrorKind::JsonMarshaling(source)))
    }
}

impl From<std::env::VarError> for Error {
    fn from(source: std::env::VarError) -> Error {
        Error(Box::new(ErrorKind::EnvVar(source)))
    }
}

impl From<std::string::FromUtf8Error> for Error {
    fn from(source: std::string::FromUtf8Error) -> Error {
        Error(Box::new(ErrorKind::UTF8(source)))
    }
}

impl From<Box<dyn ::std::error::Error + Send + Sync>> for Error {
    fn from(source: Box<dyn ::std::error::Error + Send + Sync>) -> Error {
        Error(Box::new(ErrorKind::MiscError(source)))
    }
}

impl From<Box<dyn ::std::error::Error>> for Error {
    fn from(source: Box<dyn ::std::error::Error>) -> Error {
        Error(Box::new(ErrorKind::MiscError(source)))
    }
}