{"header":{"message":"Import implementation from fehler 1.0.0-alpha.1\n","description":null,"timestamp":"2019-10-05T03:10:41Z","authors":[{"email":"dtolnay@gmail.com","name":"David Tolnay"}]},"hash":"CITEDKPB6MKVZUEYEDE5ZKTNVY35HCOAXKDPYG7YLLEOVFNMSRXQC","authors":[],"deps":{"hashes":[["CITEDKPB6MKVZUEYEDE5ZKTNVY35HCOAXKDPYG7YLLEOVFNMSRXQC","Import implementation from fehler 1.0.0-alpha.1\n"],["AA",null]],"deps":[],"known":[]},"hunks":[{"FileAdd":{"meta":{"basename":"src","metadata":576},"context":[{"change":1,"pos":0}],"contents":[]}},{"FileAdd":{"meta":{"basename":"as_error.rs","metadata":0},"context":[{"change":0,"pos":6}],"contents":[{"Add":"use std::error::Error;"},{"Add":""},{"Add":"use crate::Exception;"},{"Add":""},{"Add":"/// View type as an error object."},{"Add":"pub trait AsError {"},{"Add":" /// View type as an error object."},{"Add":" fn as_error(&self) -> &(dyn Error + Send + Sync + 'static);"},{"Add":"}"},{"Add":""},{"Add":"impl AsError for T {"},{"Add":" fn as_error(&self) -> &(dyn Error + Send + Sync + 'static) {"},{"Add":" self"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl AsError for dyn Error + Send + Sync + 'static {"},{"Add":" fn as_error(&self) -> &(dyn Error + Send + Sync + 'static) {"},{"Add":" self"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl AsError for Exception {"},{"Add":" fn as_error(&self) -> &(dyn Error + Send + Sync + 'static) {"},{"Add":" &**self"},{"Add":" }"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"context.rs","metadata":0},"context":[{"change":0,"pos":6}],"contents":[{"Add":"use std::backtrace::Backtrace;"},{"Add":"use std::fmt::{self, Debug, Display};"},{"Add":"use std::error::Error;"},{"Add":""},{"Add":"use crate::Exception;"},{"Add":""},{"Add":"/// Provides the `context` method for `Result`."},{"Add":"pub trait Context {"},{"Add":" /// Wrap the error value with additional context."},{"Add":" fn context(self, context: C) -> Result;"},{"Add":""},{"Add":" /// Wrap the error value with additional context lazily."},{"Add":" fn with_context(self, f: F) -> Result where"},{"Add":" C: Display + Send + Sync + 'static,"},{"Add":" F: FnOnce(&E) -> C;"},{"Add":"}"},{"Add":""},{"Add":"impl Context for Result {"},{"Add":" fn context(self, context: C) -> Result {"},{"Add":" self.map_err(|error| Exception::from(ContextError { error, context }))"},{"Add":" }"},{"Add":""},{"Add":" fn with_context(self, f: F) -> Result where"},{"Add":" C: Display + Send + Sync + 'static,"},{"Add":" F: FnOnce(&E) -> C"},{"Add":" {"},{"Add":" self.map_err(|error| Exception::from(ContextError { context: f(&error), error }))"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Context for Result {"},{"Add":" fn context(self, context: C) -> Result {"},{"Add":" self.map_err(|error| Exception::from(ContextError { error, context }))"},{"Add":" }"},{"Add":""},{"Add":" fn with_context(self, f: F) -> Result where"},{"Add":" C: Display + Send + Sync + 'static,"},{"Add":" F: FnOnce(&Exception) -> C"},{"Add":" {"},{"Add":" self.map_err(|error| Exception::from(ContextError { context: f(&error), error }))"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"struct ContextError {"},{"Add":" error: E,"},{"Add":" context: C,"},{"Add":"}"},{"Add":""},{"Add":"impl Debug for ContextError {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" write!(f, \"{:?}\\n\\n{}\", self.error, self.context)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Display for ContextError {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" Display::fmt(&self.context, f)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Error for ContextError {"},{"Add":" fn backtrace(&self) -> Option<&Backtrace> {"},{"Add":" self.error.backtrace()"},{"Add":" }"},{"Add":""},{"Add":" fn cause(&self) -> Option<&dyn Error> {"},{"Add":" Some(&self.error)"},{"Add":" }"},{"Add":""},{"Add":" fn source(&self) -> Option<&(dyn Error + 'static)> {"},{"Add":" Some(&self.error)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Error for ContextError {"},{"Add":" fn backtrace(&self) -> Option<&Backtrace> {"},{"Add":" Some(self.error.backtrace())"},{"Add":" }"},{"Add":""},{"Add":" fn cause(&self) -> Option<&dyn Error> {"},{"Add":" Some(&*self.error)"},{"Add":" }"},{"Add":""},{"Add":" fn source(&self) -> Option<&(dyn Error + 'static)> {"},{"Add":" Some(&*self.error)"},{"Add":" }"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"exception.rs","metadata":0},"context":[{"change":0,"pos":6}],"contents":[{"Add":"use std::any::TypeId;"},{"Add":"use std::backtrace::{Backtrace, BacktraceStatus};"},{"Add":"use std::error::Error;"},{"Add":"use std::fmt::{self, Debug, Display};"},{"Add":"use std::mem;"},{"Add":"use std::ops::{Deref, DerefMut};"},{"Add":"use std::ptr;"},{"Add":""},{"Add":"/// The `Exception type, a wrapper around a dynamic error type."},{"Add":"///"},{"Add":"/// `Exception` functions a lot like `Box`, with these differences:"},{"Add":"///"},{"Add":"/// - `Exception` requires that the error is `Send`, `Sync`, and `'static`"},{"Add":"/// - `Exception` guarantees that a backtrace will exist, even if the error type"},{"Add":"/// did not provide one"},{"Add":"/// - `Exception` is represented as a narrow pointer - exactly one word in size,"},{"Add":"/// instead of two."},{"Add":"pub struct Exception {"},{"Add":" inner: Box>,"},{"Add":"}"},{"Add":""},{"Add":"impl Exception {"},{"Add":" /// Create a new exception from any error type."},{"Add":" ///"},{"Add":" /// The error type must be threadsafe and `'static`, so that the `Exception` will be as well."},{"Add":" ///"},{"Add":" /// If the error type does not provide a backtrace, a backtrace will be created here to ensure"},{"Add":" /// that a backtrace exists."},{"Add":" pub fn new(error: E) -> Exception where"},{"Add":" E: Error + Send + Sync + 'static"},{"Add":" {"},{"Add":" Exception::construct(error, TypeId::of::())"},{"Add":" }"},{"Add":""},{"Add":" #[doc(hidden)]"},{"Add":" pub fn new_adhoc(message: M) -> Exception where"},{"Add":" M: Display + Debug + Send + Sync + 'static"},{"Add":" {"},{"Add":" Exception::construct(MessageError(message), TypeId::of::())"},{"Add":" }"},{"Add":""},{"Add":" fn construct(error: E, type_id: TypeId) -> Exception where"},{"Add":" E: Error + Send + Sync + 'static,"},{"Add":" {"},{"Add":" unsafe {"},{"Add":" let backtrace = match error.backtrace() {"},{"Add":" Some(_) => None,"},{"Add":" None => Some(Backtrace::capture()),"},{"Add":" };"},{"Add":" let obj: TraitObject = mem::transmute(&error as &dyn Error);"},{"Add":" let vtable = obj.vtable;"},{"Add":" let inner = InnerException { vtable, type_id, backtrace, error };"},{"Add":" Exception {"},{"Add":" inner: mem::transmute(Box::new(inner))"},{"Add":" }"},{"Add":" }"},{"Add":" }"},{"Add":""},{"Add":" /// View this exception as the underlying error."},{"Add":" pub fn as_error(&self) -> &(dyn Error + Send + Sync + 'static) {"},{"Add":" &**self"},{"Add":" }"},{"Add":""},{"Add":" /// View this exception as the underlying error, mutably."},{"Add":" pub fn as_error_mut(&mut self) -> &mut (dyn Error + Send + Sync + 'static) {"},{"Add":" &mut **self"},{"Add":" }"},{"Add":""},{"Add":" /// Get the backtrace for this Exception."},{"Add":" pub fn backtrace(&self) -> &Backtrace {"},{"Add":" // NB: this unwrap can only fail if the underlying error's backtrace method is"},{"Add":" // nondeterministic, which would only happen in maliciously constructed code"},{"Add":" self.inner.backtrace.as_ref().or_else(|| self.inner.error().backtrace())"},{"Add":" .expect(\"exception backtrace capture failed\")"},{"Add":" }"},{"Add":""},{"Add":" /// An iterator of errors contained by this Exception."},{"Add":" ///"},{"Add":" /// This iterator will visit every error in the \"cause chain\" of this exception, beginning with"},{"Add":" /// the error that this exception was created from."},{"Add":" pub fn errors(&self) -> Errors<'_> {"},{"Add":" Errors { next: Some(self.inner.error()) }"},{"Add":" }"},{"Add":""},{"Add":" /// Returns `true` if `E` is the type wrapped by this exception."},{"Add":" pub fn is(&self) -> bool {"},{"Add":" TypeId::of::() == self.inner.type_id"},{"Add":" }"},{"Add":""},{"Add":" /// Attempt to downcast the exception to a concrete type."},{"Add":" pub fn downcast(self) -> Result {"},{"Add":" if let Some(error) = self.downcast_ref::() {"},{"Add":" unsafe {"},{"Add":" let error = ptr::read(error);"},{"Add":" drop(ptr::read(&self.inner));"},{"Add":" mem::forget(self);"},{"Add":" Ok(error)"},{"Add":" }"},{"Add":" } else {"},{"Add":" Err(self)"},{"Add":" }"},{"Add":" }"},{"Add":""},{"Add":" /// Downcast this exception by reference."},{"Add":" pub fn downcast_ref(&self) -> Option<&E> {"},{"Add":" if self.is::() {"},{"Add":" unsafe { Some(&*(self.inner.error() as *const dyn Error as *const E)) }"},{"Add":" } else { None }"},{"Add":" }"},{"Add":""},{"Add":" /// Downcast this exception by mutable reference."},{"Add":" pub fn downcast_mut(&mut self) -> Option<&mut E> {"},{"Add":" if self.is::() {"},{"Add":" unsafe { Some(&mut *(self.inner.error_mut() as *mut dyn Error as *mut E)) }"},{"Add":" } else { None }"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl From for Exception {"},{"Add":" fn from(error: E) -> Exception {"},{"Add":" Exception::new(error)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Deref for Exception {"},{"Add":" type Target = dyn Error + Send + Sync + 'static;"},{"Add":" fn deref(&self) -> &Self::Target {"},{"Add":" self.inner.error()"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl DerefMut for Exception {"},{"Add":" fn deref_mut(&mut self) -> &mut Self::Target {"},{"Add":" self.inner.error_mut()"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Debug for Exception {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" writeln!(f, \"{}\", self.inner.error())?;"},{"Add":""},{"Add":" let mut errors = self.errors().skip(1).enumerate();"},{"Add":""},{"Add":" if let Some((n, error)) = errors.next() {"},{"Add":" writeln!(f, \"\\ncaused by:\")?;"},{"Add":" writeln!(f, \"\\t{}: {}\", n, error)?;"},{"Add":" for (n, error) in errors {"},{"Add":" writeln!(f, \"\\t{}: {}\", n, error)?;"},{"Add":" }"},{"Add":" }"},{"Add":""},{"Add":" let backtrace = self.backtrace();"},{"Add":""},{"Add":" match backtrace.status() {"},{"Add":" BacktraceStatus::Captured => {"},{"Add":" writeln!(f, \"\\n{}\", backtrace)?;"},{"Add":" }"},{"Add":" BacktraceStatus::Disabled => {"},{"Add":" writeln!(f, \"\\nbacktrace disabled; run with RUST_BACKTRACE=1 environment variable \\"},{"Add":" to display a backtrace\")?;"},{"Add":" }"},{"Add":" _ => { }"},{"Add":" }"},{"Add":""},{"Add":" Ok(())"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Display for Exception {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" write!(f, \"{}\", self.inner.error())"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"unsafe impl Send for Exception { }"},{"Add":"unsafe impl Sync for Exception { }"},{"Add":""},{"Add":"impl Drop for Exception {"},{"Add":" fn drop(&mut self) {"},{"Add":" unsafe { ptr::drop_in_place(self.inner.error_mut()) }"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"// repr C to ensure that `E` remains in the final position"},{"Add":"#[repr(C)]"},{"Add":"struct InnerException {"},{"Add":" vtable: *const (),"},{"Add":" type_id: TypeId,"},{"Add":" backtrace: Option,"},{"Add":" error: E,"},{"Add":"}"},{"Add":""},{"Add":"// repr C to ensure that transmuting from trait objects is safe"},{"Add":"#[repr(C)]"},{"Add":"struct TraitObject {"},{"Add":" data: *const (),"},{"Add":" vtable: *const (),"},{"Add":"}"},{"Add":""},{"Add":"#[repr(transparent)]"},{"Add":"struct MessageError(M);"},{"Add":""},{"Add":"impl Debug for MessageError {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" Debug::fmt(&self.0, f)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Display for MessageError {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" Display::fmt(&self.0, f)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"impl Error for MessageError { }"},{"Add":""},{"Add":"impl InnerException<()> {"},{"Add":" fn error(&self) -> &(dyn Error + Send + Sync + 'static) {"},{"Add":" unsafe {"},{"Add":" mem::transmute(TraitObject {"},{"Add":" data: &self.error,"},{"Add":" vtable: self.vtable,"},{"Add":" })"},{"Add":" }"},{"Add":" }"},{"Add":""},{"Add":" fn error_mut(&mut self) -> &mut (dyn Error + Send + Sync + 'static) {"},{"Add":" unsafe {"},{"Add":" mem::transmute(TraitObject {"},{"Add":" data: &mut self.error,"},{"Add":" vtable: self.vtable,"},{"Add":" })"},{"Add":" }"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"/// Iterator of errors in an `Exception`."},{"Add":"pub struct Errors<'a> {"},{"Add":" next: Option<&'a (dyn Error + 'static)>,"},{"Add":"}"},{"Add":""},{"Add":"impl<'a> Iterator for Errors<'a> {"},{"Add":" type Item = &'a (dyn Error + 'static);"},{"Add":" fn next(&mut self) -> Option {"},{"Add":" let next = self.next.take()?;"},{"Add":" self.next = next.source();"},{"Add":" Some(next)"},{"Add":" }"},{"Add":"}"},{"Add":""},{"Add":"#[cfg(test)]"},{"Add":"mod repr_correctness {"},{"Add":" use super::*;"},{"Add":""},{"Add":" use std::mem;"},{"Add":" use std::marker::Unpin;"},{"Add":""},{"Add":" #[test]"},{"Add":" fn size_of_exception() {"},{"Add":" assert_eq!(mem::size_of::(), mem::size_of::());"},{"Add":" }"},{"Add":""},{"Add":" #[allow(dead_code)] fn assert_exception_autotraits() where"},{"Add":" Exception: Unpin + Send + Sync + 'static"},{"Add":" { }"},{"Add":""},{"Add":" #[test]"},{"Add":" fn destructors_work() {"},{"Add":" use std::sync::*;"},{"Add":""},{"Add":" #[derive(Debug)] struct HasDrop(Box>>);"},{"Add":" impl Error for HasDrop { }"},{"Add":" impl Display for HasDrop {"},{"Add":" fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {"},{"Add":" write!(f, \"does something\")"},{"Add":" }"},{"Add":" }"},{"Add":" impl Drop for HasDrop {"},{"Add":" fn drop(&mut self) {"},{"Add":" let mut has_dropped = self.0.lock().unwrap();"},{"Add":" assert!(!*has_dropped);"},{"Add":" *has_dropped = true;"},{"Add":" }"},{"Add":" }"},{"Add":""},{"Add":" let has_dropped = Arc::new(Mutex::new(false));"},{"Add":""},{"Add":" drop(Exception::from(HasDrop(Box::new(has_dropped.clone()))));"},{"Add":""},{"Add":" assert!(*has_dropped.lock().unwrap());"},{"Add":""},{"Add":" }"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"lib.rs","metadata":0},"context":[{"change":0,"pos":6}],"contents":[{"Add":"#![feature(backtrace)]"},{"Add":""},{"Add":"mod as_error;"},{"Add":"mod exception;"},{"Add":"mod context;"},{"Add":""},{"Add":"#[doc(inline)]"},{"Add":"/// Annotations a function that \"throws\" a Result."},{"Add":"///"},{"Add":"/// Inside functions tagged with `throws`, you can use `?` and the `throw!` macro to return errors,"},{"Add":"/// but you don't need to wrap the successful return values in `Ok`."},{"Add":"///"},{"Add":"/// `throws` can optionally take a type as an argument, which will be the error type returned by"},{"Add":"/// this function. By default, the function will throw `Exception`."},{"Add":"pub use fehler_macros::throws;"},{"Add":""},{"Add":"#[doc(inline)]"},{"Add":"/// Derive for the Error trait."},{"Add":"///"},{"Add":"/// If the type contains a `Backtrace`, it will generate the `backtrace` method to find it."},{"Add":"///"},{"Add":"/// If this wraps a different, underlying error, you can tag that field with `#[error::source]`,"},{"Add":"/// which will generate the `cause` and `source` methods correctly."},{"Add":"pub use fehler_macros::Error;"},{"Add":""},{"Add":"pub use crate::as_error::AsError;"},{"Add":"pub use crate::exception::{Exception, Errors};"},{"Add":"pub use crate::context::Context;"},{"Add":""},{"Add":"/// Throw an error."},{"Add":"///"},{"Add":"/// This macro is equivalent to `Err($err)?`."},{"Add":"#[macro_export]"},{"Add":"macro_rules! throw {"},{"Add":" ($err:expr) => (return std::result::Result::Err(std::convert::From::from($err)))"},{"Add":"}"},{"Add":""},{"Add":"/// Construct an ad-hoc exception from a string."},{"Add":"///"},{"Add":"/// This evaluates to an `Exception`. It can take either just a string, or a format string with"},{"Add":"/// arguments. It also can take any custom type which implements `Debug` and `Display`."},{"Add":"#[macro_export]"},{"Add":"macro_rules! error {"},{"Add":" ($e:expr) => { $crate::Exception::new_adhoc($e) };"},{"Add":" ($($arg:tt)*) => { $crate::Exception::new_adhoc(format!($($arg)*)) };"},{"Add":"}"}]}}],"owner":"yaahc","repo":"eyre","token":"DemgaIQn6UDqzLjCVNpSJB85FjENAPPteC0Epqu1md4=","login":null}

…

Dependencies

Change contents