errortools 0.2.0

Quality of life utilities for error handling in Rust.
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

//! Display-adapter wrapper for [`Path`]-like values.
//! This is an experimental helper module. Prefer composing a path-aware
//! [`Format`](crate::Format) strategy for [`WithContext`](crate::WithContext)
//! via [`ContextPath`](crate::with_context::ContextPath) — see
//! [`PathColon`](crate::with_context::PathColon) and
//! [`WithPath`](crate::with_context::WithPath) for the canonical use.

use core::fmt;
use std::path::Path;

/// Wrapper that gives a [`Path`]-like value a [`fmt::Display`] impl (via
/// [`Path::display`]) so it can be used in contexts that require `Display`,
/// e.g. as the context slot of [`WithContext`](crate::WithContext) under the
/// default [`Colon`](crate::with_context::Colon) strategy. Prefer
/// [`PathColon`](crate::with_context::PathColon) when you only need a path-aware strategy.
#[derive(Clone, Copy, PartialEq, Eq, Hash)]
pub struct DisplayPath<T>(T);

impl<P: AsRef<Path>> fmt::Display for DisplayPath<P> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        self.0.as_ref().display().fmt(f)
    }
}

impl<P: AsRef<Path>> fmt::Debug for DisplayPath<P> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        self.0.as_ref().fmt(f)
    }
}

impl<T> From<T> for DisplayPath<T> {
    fn from(value: T) -> Self {
        Self(value)
    }
}