//! Error and Result module. use std::error::Error as StdError; use std::fmt; use std::io::Error as IoError; use std::str::Utf8Error; use httparse; use openssl::ssl::error::SslError; use url; use solicit::http::HttpError as Http2Error; use self::Error::{ Method, Uri, Version, Header, Status, Io, Ssl, TooLarge, Http2, Utf8 }; /// Result type often returned from methods that can have hyper `Error`s. pub type Result = ::std::result::Result; /// A set of errors that can occur parsing HTTP streams. #[derive(Debug)] pub enum Error { /// An invalid `Method`, such as `GE,T`. Method, /// An invalid `RequestUri`, such as `exam ple.domain`. Uri(url::ParseError), /// An invalid `HttpVersion`, such as `HTP/1.1` Version, /// An invalid `Header`. Header, /// A message head is too large to be reasonable. TooLarge, /// An invalid `Status`, such as `1337 ELITE`. Status, /// An `io::Error` that occurred while trying to read or write to a network stream. Io(IoError), /// An error from the `openssl` library. Ssl(SslError), /// An HTTP/2-specific error, coming from the `solicit` library. Http2(Http2Error), /// Parsing a field as string failed Utf8(Utf8Error), #[doc(hidden)] __Nonexhaustive(Void) } #[doc(hidden)] pub enum Void {} impl fmt::Debug for Void { fn fmt(&self, _: &mut fmt::Formatter) -> fmt::Result { match *self {} } } impl fmt::Display for Error { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.write_str(self.description()) } } impl StdError for Error { fn description(&self) -> &str { match *self { Method => "Invalid Method specified", Version => "Invalid HTTP version specified", Header => "Invalid Header provided", TooLarge => "Message head is too large", Status => "Invalid Status provided", Uri(ref e) => e.description(), Io(ref e) => e.description(), Ssl(ref e) => e.description(), Http2(ref e) => e.description(), Utf8(ref e) => e.description(), Error::__Nonexhaustive(ref void) => match *void {} } } fn cause(&self) -> Option<&StdError> { match *self { Io(ref error) => Some(error), Ssl(ref error) => Some(error), Uri(ref error) => Some(error), Http2(ref error) => Some(error), _ => None, } } } impl From for Error { fn from(err: IoError) -> Error { Io(err) } } impl From for Error { fn from(err: url::ParseError) -> Error { Uri(err) } } impl From for Error { fn from(err: SslError) -> Error { match err { SslError::StreamError(err) => Io(err), err => Ssl(err), } } } impl From for Error { fn from(err: Utf8Error) -> Error { Utf8(err) } } impl From for Error { fn from(err: httparse::Error) -> Error { match err { httparse::Error::HeaderName => Header, httparse::Error::HeaderValue => Header, httparse::Error::NewLine => Header, httparse::Error::Status => Status, httparse::Error::Token => Header, httparse::Error::TooManyHeaders => TooLarge, httparse::Error::Version => Version, } } } impl From for Error { fn from(err: Http2Error) -> Error { Error::Http2(err) } } #[cfg(test)] mod tests { use std::error::Error as StdError; use std::io; use httparse; use openssl::ssl::error::SslError; use solicit::http::HttpError as Http2Error; use url; use super::Error; use super::Error::*; #[test] fn test_cause() { let orig = io::Error::new(io::ErrorKind::Other, "other"); let desc = orig.description().to_owned(); let e = Io(orig); assert_eq!(e.cause().unwrap().description(), desc); } macro_rules! from { ($from:expr => $error:pat) => { match Error::from($from) { e @ $error => { assert!(e.description().len() > 5); } , _ => panic!("{:?}", $from) } } } macro_rules! from_and_cause { ($from:expr => $error:pat) => { match Error::from($from) { e @ $error => { let desc = e.cause().unwrap().description(); assert_eq!(desc, $from.description().to_owned()); assert_eq!(desc, e.description()); }, _ => panic!("{:?}", $from) } } } #[test] fn test_from() { from_and_cause!(io::Error::new(io::ErrorKind::Other, "other") => Io(..)); from_and_cause!(url::ParseError::EmptyHost => Uri(..)); from_and_cause!(SslError::SslSessionClosed => Ssl(..)); from_and_cause!(Http2Error::UnknownStreamId => Http2(..)); from!(SslError::StreamError(io::Error::new(io::ErrorKind::Other, "ssl negotiation")) => Io(..)); from!(httparse::Error::HeaderName => Header); from!(httparse::Error::HeaderName => Header); from!(httparse::Error::HeaderValue => Header); from!(httparse::Error::NewLine => Header); from!(httparse::Error::Status => Status); from!(httparse::Error::Token => Header); from!(httparse::Error::TooManyHeaders => TooLarge); from!(httparse::Error::Version => Version); } }