openethereum/util/src/error.rs

204 lines
6.0 KiB
Rust
Raw Normal View History

2016-02-05 13:40:41 +01:00
// Copyright 2015, 2016 Ethcore (UK) Ltd.
// This file is part of Parity.
// Parity is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// Parity is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License
// along with Parity. If not, see <http://www.gnu.org/licenses/>.
2016-01-17 13:11:25 +01:00
//! General error types for use in ethcore.
use rustc_serialize::hex::FromHexError;
use network::NetworkError;
use rlp::DecoderError;
use io;
2016-02-15 16:01:52 +01:00
use std::fmt;
2016-03-13 21:54:06 +01:00
use hash::H256;
2016-01-17 13:11:25 +01:00
#[derive(Debug)]
/// Error in database subsystem.
2016-01-17 13:11:25 +01:00
pub enum BaseDataError {
/// An entry was removed more times than inserted.
2016-03-13 21:54:06 +01:00
NegativelyReferencedHash(H256),
2016-01-17 13:11:25 +01:00
}
impl fmt::Display for BaseDataError {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
2016-05-22 18:41:45 +02:00
match *self {
BaseDataError::NegativelyReferencedHash(hash) =>
f.write_fmt(format_args!("Entry {} removed from database more times \
than it was added.", hash)),
}
}
}
2016-01-17 13:11:25 +01:00
#[derive(Debug)]
/// General error type which should be capable of representing all errors in ethcore.
pub enum UtilError {
/// Error concerning the crypto utility subsystem.
2016-01-17 13:11:25 +01:00
Crypto(::crypto::CryptoError),
/// Error concerning the Rust standard library's IO subsystem.
2016-01-17 13:11:25 +01:00
StdIo(::std::io::Error),
/// Error concerning our IO utility subsystem.
2016-01-17 13:11:25 +01:00
Io(io::IoError),
/// Error concerning the network address parsing subsystem.
2016-01-17 13:11:25 +01:00
AddressParse(::std::net::AddrParseError),
/// Error concerning the network address resolution subsystem.
2016-01-17 13:11:25 +01:00
AddressResolve(Option<::std::io::Error>),
/// Error concerning the hex conversion logic.
2016-01-17 13:11:25 +01:00
FromHex(FromHexError),
/// Error concerning the database abstraction logic.
2016-01-17 13:11:25 +01:00
BaseData(BaseDataError),
/// Error concerning the network subsystem.
2016-01-17 13:11:25 +01:00
Network(NetworkError),
/// Error concerning the RLP decoder.
2016-01-17 13:11:25 +01:00
Decoder(DecoderError),
/// Miscellaneous error described by a string.
2016-01-18 12:41:31 +01:00
SimpleString(String),
/// Error from a bad input size being given for the needed output.
2016-01-17 13:11:25 +01:00
BadSize,
/// Error from snappy.
Snappy(::snappy::InvalidInput),
2016-01-17 13:11:25 +01:00
}
impl fmt::Display for UtilError {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
match *self {
UtilError::Crypto(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::StdIo(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::Io(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::AddressParse(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::AddressResolve(Some(ref err)) => f.write_fmt(format_args!("{}", err)),
UtilError::AddressResolve(_) => f.write_str("Failed to resolve network address."),
UtilError::FromHex(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::BaseData(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::Network(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::Decoder(ref err) => f.write_fmt(format_args!("{}", err)),
UtilError::SimpleString(ref msg) => f.write_str(&msg),
UtilError::BadSize => f.write_str("Bad input size."),
UtilError::Snappy(ref err) => f.write_fmt(format_args!("{}", err)),
}
}
}
2016-02-15 16:01:52 +01:00
#[derive(Debug, PartialEq, Eq)]
/// Error indicating an expected value was not found.
pub struct Mismatch<T: fmt::Debug> {
/// Value expected.
pub expected: T,
/// Value found.
pub found: T,
}
2016-05-20 21:27:20 +02:00
impl<T: fmt::Debug + fmt::Display> fmt::Display for Mismatch<T> {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
f.write_fmt(format_args!("Expected {}, found {}", self.expected, self.found))
}
}
2016-07-01 21:34:50 +02:00
#[derive(Debug, PartialEq, Eq, Clone)]
2016-02-15 16:01:52 +01:00
/// Error indicating value found is outside of a valid range.
pub struct OutOfBounds<T: fmt::Debug> {
/// Minimum allowed value.
pub min: Option<T>,
/// Maximum allowed value.
pub max: Option<T>,
/// Value found.
pub found: T,
}
2016-05-20 21:19:26 +02:00
impl<T: fmt::Debug + fmt::Display> fmt::Display for OutOfBounds<T> {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
let msg = match (self.min.as_ref(), self.max.as_ref()) {
2016-05-22 18:41:45 +02:00
(Some(min), Some(max)) => format!("Min={}, Max={}", min, max),
(Some(min), _) => format!("Min={}", min),
(_, Some(max)) => format!("Max={}", max),
(None, None) => "".into(),
2016-05-20 21:19:26 +02:00
};
f.write_fmt(format_args!("Value {} out of bounds. {}", self.found, msg))
}
}
2016-01-17 13:11:25 +01:00
impl From<FromHexError> for UtilError {
fn from(err: FromHexError) -> UtilError {
UtilError::FromHex(err)
}
}
impl From<BaseDataError> for UtilError {
fn from(err: BaseDataError) -> UtilError {
UtilError::BaseData(err)
}
}
impl From<NetworkError> for UtilError {
fn from(err: NetworkError) -> UtilError {
UtilError::Network(err)
}
}
impl From<::std::io::Error> for UtilError {
fn from(err: ::std::io::Error) -> UtilError {
UtilError::StdIo(err)
}
}
impl From<io::IoError> for UtilError {
fn from(err: io::IoError) -> UtilError {
UtilError::Io(err)
}
}
impl From<::crypto::CryptoError> for UtilError {
fn from(err: ::crypto::CryptoError) -> UtilError {
UtilError::Crypto(err)
}
}
impl From<::std::net::AddrParseError> for UtilError {
fn from(err: ::std::net::AddrParseError) -> UtilError {
UtilError::AddressParse(err)
}
}
impl From<::rlp::DecoderError> for UtilError {
fn from(err: ::rlp::DecoderError) -> UtilError {
UtilError::Decoder(err)
}
}
2016-01-18 12:41:31 +01:00
impl From<String> for UtilError {
fn from(err: String) -> UtilError {
UtilError::SimpleString(err)
}
}
impl From<::snappy::InvalidInput> for UtilError {
fn from(err: ::snappy::InvalidInput) -> UtilError {
UtilError::Snappy(err)
}
}
2016-01-17 13:11:25 +01:00
// TODO: uncomment below once https://github.com/rust-lang/rust/issues/27336 sorted.
/*#![feature(concat_idents)]
macro_rules! assimilate {
($name:ident) => (
impl From<concat_idents!($name, Error)> for Error {
fn from(err: concat_idents!($name, Error)) -> Error {
Error:: $name (err)
}
}
)
}
assimilate!(FromHex);
assimilate!(BaseData);*/