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 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76
//! A small crate to deal with data in context.
//!
//! ```
//! use contextual::{WithContext, AsRefWithContext, DisplayWithContext};
//! use std::fmt;
//!
//! /// Index of an element in some array.
//! pub struct Index(usize);
//!
//! impl<T, C: AsRef<[T]>> AsRefWithContext<T, C> for Index {
//! fn as_ref_with<'a>(&'a self, context: &'a C) -> &'a T {
//! &context.as_ref()[self.0]
//! }
//! }
//!
//! impl<'a, C: AsRef<[&'a str]>> DisplayWithContext<C> for Index {
//! fn fmt_with(&self, context: &C, f: &mut fmt::Formatter) -> fmt::Result {
//! use fmt::Display;
//! context.as_ref()[self.0].fmt(f)
//! }
//! }
//!
//! let i = Index(1);
//! let context = ["a", "b", "c"];
//!
//! print!("index: {}", i.with(&context));
//! assert_eq!(*i.with(&context).as_ref(), "b")
//! ```
mod as_ref;
mod display;
mod from;
mod into_ref;
mod try_from;
pub use as_ref::*;
pub use display::*;
pub use from::*;
pub use into_ref::*;
pub use try_from::*;
pub struct Contextual<T, C>(pub T, pub C);
pub trait WithContext {
fn with<C>(&self, context: C) -> Contextual<&Self, C>;
fn into_with<C>(self, context: C) -> Contextual<Self, C>
where
Self: Sized;
}
impl<T: ?Sized> WithContext for T {
fn with<C>(&self, context: C) -> Contextual<&Self, C> {
Contextual(self, context)
}
fn into_with<C>(self, context: C) -> Contextual<Self, C>
where
Self: Sized,
{
Contextual(self, context)
}
}
impl<T, C> std::ops::Deref for Contextual<T, C> {
type Target = T;
fn deref(&self) -> &T {
&self.0
}
}
impl<T, C> std::ops::DerefMut for Contextual<T, C> {
fn deref_mut(&mut self) -> &mut T {
&mut self.0
}
}