refactor: improve type param names, docs & more of casting

4 files changed, 21 insertions, 33 deletions

diff --git a/src/libs/intertrait/cast/arc.rs b/src/libs/intertrait/cast/arc.rs
index 6d3867c..a1b2c30 100644
--- a/src/libs/intertrait/cast/arc.rs
+++ b/src/libs/intertrait/cast/arc.rs
@@ -17,31 +17,27 @@ use crate::libs::intertrait::{get_caster, CastFromSync};
 
 pub trait CastArc
 {
-    /// Casts an `Arc` for this trait into that for type `OtherTrait`.
-    fn cast<OtherTrait: ?Sized + 'static>(
-        self: Arc<Self>,
-    ) -> Result<Arc<OtherTrait>, CastError>;
+    /// Casts an `Arc` with `Self` into an `Arc` with `Dest`.
+    fn cast<Dest: ?Sized + 'static>(self: Arc<Self>) -> Result<Arc<Dest>, CastError>;
 }
 
 /// A blanket implementation of `CastArc` for traits extending `CastFrom`, `Sync`, and
 /// `Send`.
 impl<CastFromSelf: ?Sized + CastFromSync> CastArc for CastFromSelf
 {
-    fn cast<OtherTrait: ?Sized + 'static>(
-        self: Arc<Self>,
-    ) -> Result<Arc<OtherTrait>, CastError>
+    fn cast<Dest: ?Sized + 'static>(self: Arc<Self>) -> Result<Arc<Dest>, CastError>
     {
-        let caster = get_caster::<OtherTrait>((*self).type_id())
-            .map_err(CastError::GetCasterFailed)?;
+        let caster =
+            get_caster::<Dest>((*self).type_id()).map_err(CastError::GetCasterFailed)?;
 
         let cast_arc = caster
             .opt_cast_arc
-            .ok_or(CastError::NotArcCastable(type_name::<OtherTrait>()))?;
+            .ok_or(CastError::NotArcCastable(type_name::<Dest>()))?;
 
         cast_arc(self.arc_any()).map_err(|err| CastError::CastFailed {
             source: err,
             from: type_name::<Self>(),
-            to: type_name::<OtherTrait>(),
+            to: type_name::<Dest>(),
         })
     }
 }
diff --git a/src/libs/intertrait/cast/box.rs b/src/libs/intertrait/cast/box.rs
index 0e160f4..fcd5f70 100644
--- a/src/libs/intertrait/cast/box.rs
+++ b/src/libs/intertrait/cast/box.rs
@@ -17,26 +17,22 @@ use crate::libs::intertrait::{get_caster, CastFrom};
 
 pub trait CastBox
 {
-    /// Casts a box to this trait into that of type `OtherTrait`.
-    fn cast<OtherTrait: ?Sized + 'static>(
-        self: Box<Self>,
-    ) -> Result<Box<OtherTrait>, CastError>;
+    /// Casts a `Box` with `Self` into a `Box` with `Dest`.
+    fn cast<Dest: ?Sized + 'static>(self: Box<Self>) -> Result<Box<Dest>, CastError>;
 }
 
 /// A blanket implementation of `CastBox` for traits extending `CastFrom`.
 impl<CastFromSelf: ?Sized + CastFrom> CastBox for CastFromSelf
 {
-    fn cast<OtherTrait: ?Sized + 'static>(
-        self: Box<Self>,
-    ) -> Result<Box<OtherTrait>, CastError>
+    fn cast<Dest: ?Sized + 'static>(self: Box<Self>) -> Result<Box<Dest>, CastError>
     {
-        let caster = get_caster::<OtherTrait>((*self).type_id())
-            .map_err(CastError::GetCasterFailed)?;
+        let caster =
+            get_caster::<Dest>((*self).type_id()).map_err(CastError::GetCasterFailed)?;
 
         (caster.cast_box)(self.box_any()).map_err(|err| CastError::CastFailed {
             source: err,
             from: type_name::<Self>(),
-            to: type_name::<OtherTrait>(),
+            to: type_name::<Dest>(),
         })
     }
 }
diff --git a/src/libs/intertrait/cast/error.rs b/src/libs/intertrait/cast/error.rs
index e6d86a5..d253fc5 100644
--- a/src/libs/intertrait/cast/error.rs
+++ b/src/libs/intertrait/cast/error.rs
@@ -6,7 +6,7 @@ pub enum CastError
     #[error("Failed to get caster")]
     GetCasterFailed(#[from] GetCasterError),
 
-    #[error("Failed to cast from trait {from} to trait {to}")]
+    #[error("Failed to cast from {from} to {to}")]
     CastFailed
     {
         #[source]
@@ -15,6 +15,6 @@ pub enum CastError
         to: &'static str,
     },
 
-    #[error("Trait '{0}' can't be cast to Arc")]
+    #[error("'{0}' can't be cast to an Arc")]
     NotArcCastable(&'static str),
 }
diff --git a/src/libs/intertrait/cast/rc.rs b/src/libs/intertrait/cast/rc.rs
index 906490d..8567d1e 100644
--- a/src/libs/intertrait/cast/rc.rs
+++ b/src/libs/intertrait/cast/rc.rs
@@ -17,26 +17,22 @@ use crate::libs::intertrait::{get_caster, CastFrom};
 
 pub trait CastRc
 {
-    /// Casts an `Rc` for this trait into that for type `OtherTrait`.
-    fn cast<OtherTrait: ?Sized + 'static>(
-        self: Rc<Self>,
-    ) -> Result<Rc<OtherTrait>, CastError>;
+    /// Casts an `Rc` with `Self `into a `Rc` with `Dest`.
+    fn cast<Dest: ?Sized + 'static>(self: Rc<Self>) -> Result<Rc<Dest>, CastError>;
 }
 
 /// A blanket implementation of `CastRc` for traits extending `CastFrom`.
 impl<CastFromSelf: ?Sized + CastFrom> CastRc for CastFromSelf
 {
-    fn cast<OtherTrait: ?Sized + 'static>(
-        self: Rc<Self>,
-    ) -> Result<Rc<OtherTrait>, CastError>
+    fn cast<Dest: ?Sized + 'static>(self: Rc<Self>) -> Result<Rc<Dest>, CastError>
     {
-        let caster = get_caster::<OtherTrait>((*self).type_id())
-            .map_err(CastError::GetCasterFailed)?;
+        let caster =
+            get_caster::<Dest>((*self).type_id()).map_err(CastError::GetCasterFailed)?;
 
         (caster.cast_rc)(self.rc_any()).map_err(|err| CastError::CastFailed {
             source: err,
             from: type_name::<Self>(),
-            to: type_name::<OtherTrait>(),
+            to: type_name::<Dest>(),
         })
     }
 }