Added NestedTupleFrom and NestedTupleInto

Author: LucaCappelletti94

CHANGELOG.md

@@ -40,6 +40,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `NestTupleMatrix` trait for converting flat tuples of flat tuples (like `((A, B), (C, D))`) into nested tuples of nested tuples (like `((A, (B,)), ((C, (D,)),))`)
 - `FlattenNestedTupleMatrix` trait for converting nested tuples of nested tuples back into flat tuples of flat tuples
 - `NestedTupleTryFrom<T, E>` and `NestedTupleTryInto<T, E>` traits for fallible, element-wise conversions between nested tuple types using `TryFrom` conversions and proper error propagation
+- `NestedTupleTryFrom<T, E>` and `NestedTupleTryInto<T, E>` traits for fallible, element-wise conversions between nested tuple types using `TryFrom` conversions and proper error propagation
+- `NestedTupleFrom<T>` and `NestedTupleInto<T>` traits for infallible, element-wise conversions using `From` implementations
 - `NestTupleMatrix` trait for converting flat tuples of flat tuples (like `((A, B), (C, D))`) into nested tuples of nested tuples (like `((A, (B,)), ((C, (D,)),))`)
 - `FlattenNestedTupleMatrix` trait for converting nested tuples of nested tuples back into flat tuples of flat tuples
 - `NestMatrixElements` and `FlattenMatrixElements` helper traits for recursive element processing in matrix operations

README.md

@@ -34,6 +34,8 @@ The library provides several traits for working with tuples:
 - [`NestedTupleOptionWith<H>`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleOptionWith.html): Provides `first_none_with`, `first_some_with`, and `transpose_or` helpers which operate with a parallel homogeneous nested tuple of `H` used for result/error mapping.
 - [`NestedTupleTryFrom<T, E>`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleTryFrom.html): Provides a [`nested_tuple_try_from()`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleTryFrom.html#tymethod.nested_tuple_try_from) method to fallibly convert nested tuple types element-wise using `TryFrom` conversions.
 - [`NestedTupleTryInto<T, E>`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleTryInto.html): Provides a [`nested_tuple_try_into()`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleTryInto.html#tymethod.nested_tuple_try_into) convenience method to perform fallible conversions using `NestedTupleTryFrom`.
+- [`NestedTupleFrom<T>`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleFrom.html): Provides an infallible [`nested_tuple_from()`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleFrom.html#tymethod.nested_tuple_from) method to convert nested tuples using `From` element-wise.
+- [`NestedTupleInto<T>`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleInto.html): Provides an infallible [`nested_tuple_into()`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleInto.html#tymethod.nested_tuple_into) convenience method to perform conversions using `NestedTupleFrom`.
 - [`NestedTupleReplicate<T>`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleReplicate.html): Provides a [`nested_tuple_replicate(value)`](https://docs.rs/tuplities-flatten-nest/latest/tuplities_flatten_nest/trait.NestedTupleReplicate.html#tymethod.nested_tuple_replicate) method to create nested tuples by replicating a single value across all positions.
 - [`TupleRef`](https://docs.rs/tuplities-ref/latest/tuplities_ref/trait.TupleRef.html): Provides a [`tuple_ref()`](https://docs.rs/tuplities-ref/latest/tuplities_ref/trait.TupleRef.html#tymethod.tuple_ref) method to get references to each element in the tuple.
 - [`TupleMut`](https://docs.rs/tuplities-mut/latest/tuplities_mut/trait.TupleMut.html): Provides a [`tuple_mut()`](https://docs.rs/tuplities-mut/latest/tuplities_mut/trait.TupleMut.html#tymethod.tuple_mut) method to get mutable references to each element in the tuple.

tuplities-flatten-nest/src/lib.rs

@@ -27,4 +27,5 @@ pub use nested_push_pop::{
 pub use nested_ref::{NestedTupleMut, NestedTupleRef};
 pub use nested_replicate::NestedTupleReplicate;
 pub use nested_row::{NestedTupleRow, NestedTupleRowMut};
+pub use nested_try_from::{NestedTupleFrom, NestedTupleInto};
 pub use nested_try_from::{NestedTupleTryFrom, NestedTupleTryInto};

tuplities-flatten-nest/src/nested_try_from.rs

@@ -42,6 +42,64 @@ where
     }
 }
 
+/// A trait for infallibly converting from one nested tuple type to another.
+///
+/// This mirrors `From` but works element-wise across nested tuple structures.
+///
+/// Part of the [`tuplities`](https://docs.rs/tuplities/latest/tuplities/) crate.
+pub trait NestedTupleFrom<T>: Sized {
+    /// Converts `other` into `Self` by applying `From` element-wise.
+    fn nested_tuple_from(other: T) -> Self;
+}
+
+/// A trait for infallibly converting into another nested tuple type.
+///
+/// Automatically implemented for any type that implements `NestedTupleFrom`.
+pub trait NestedTupleInto<T>: Sized {
+    /// Converts `self` into `T` by applying `From` element-wise.
+    fn nested_tuple_into(self) -> T;
+}
+
+impl<T, U> NestedTupleInto<U> for T
+where
+    U: NestedTupleFrom<T>,
+{
+    #[inline]
+    fn nested_tuple_into(self) -> U {
+        U::nested_tuple_from(self)
+    }
+}
+
+impl NestedTupleFrom<()> for () {
+    #[inline]
+    fn nested_tuple_from(_other: ()) -> Self {}
+}
+
+impl<Head, OtherHead> NestedTupleFrom<(OtherHead,)> for (Head,)
+where
+    Head: From<OtherHead>,
+{
+    #[inline]
+    fn nested_tuple_from(other: (OtherHead,)) -> Self {
+        let (other_head,) = other;
+        (Head::from(other_head),)
+    }
+}
+
+impl<Head, Tail, OtherHead, OtherTail> NestedTupleFrom<(OtherHead, OtherTail)> for (Head, Tail)
+where
+    Head: From<OtherHead>,
+    Tail: NestedTupleFrom<OtherTail>,
+{
+    #[inline]
+    fn nested_tuple_from(other: (OtherHead, OtherTail)) -> Self {
+        let (other_head, other_tail) = other;
+        let head = Head::from(other_head);
+        let tail = Tail::nested_tuple_from(other_tail);
+        (head, tail)
+    }
+}
+
 impl<E> NestedTupleTryFrom<(), E> for () {
     #[inline]
     fn nested_tuple_try_from(_other: ()) -> Result<Self, E> {
@@ -116,6 +174,41 @@ mod tests {
         assert_eq!(target, Ok((1u16, (2u16,))));
     }
 
+    #[test]
+    fn test_nested_tuple_from_single() {
+        let source = (1u8,);
+        let target: (u16,) = NestedTupleFrom::nested_tuple_from(source);
+        assert_eq!(target, (1u16,));
+    }
+
+    #[test]
+    fn test_nested_tuple_from_nested() {
+        let source = (1u8, (2u8, (3u8,)));
+        let target: (u16, (u16, (u16,))) = NestedTupleFrom::nested_tuple_from(source);
+        assert_eq!(target, (1u16, (2u16, (3u16,))));
+    }
+
+    #[test]
+    fn test_nested_tuple_into() {
+        let source = (1u8, (2u8,));
+        let target: (u16, (u16,)) = source.nested_tuple_into();
+        assert_eq!(target, (1u16, (2u16,)));
+    }
+
+    #[test]
+    fn test_nested_tuple_from_empty() {
+        let source = ();
+        let target: () = NestedTupleFrom::nested_tuple_from(source);
+        assert_eq!(target, ());
+    }
+
+    #[test]
+    fn test_nested_tuple_into_empty() {
+        let source = ();
+        let target: () = source.nested_tuple_into();
+        assert_eq!(target, ());
+    }
+
     // Note: We avoid using `TryFromIntError` in these tests to improve portability
     // and to focus on custom error types that do not implement `From<Infallible>`.
 

tuplities/src/lib.rs

@@ -16,11 +16,11 @@ pub mod prelude {
     #[cfg(feature = "flatten-nest")]
     pub use tuplities_flatten_nest::{
         FlattenMatrixElements, FlattenNestedTuple, FlattenNestedTupleMatrix, IntoNestedTupleOption,
-        NestMatrixElements, NestTuple, NestTupleMatrix, NestedTupleIndex, NestedTupleIndexMut,
-        NestedTupleMut, NestedTupleOption, NestedTupleOptionWith, NestedTuplePopBack,
-        NestedTuplePopFront, NestedTuplePushBack, NestedTuplePushFront, NestedTupleRef,
-        NestedTupleReplicate, NestedTupleRow, NestedTupleRowMut, NestedTupleTryFrom,
-        NestedTupleTryInto,
+        NestMatrixElements, NestTuple, NestTupleMatrix, NestedTupleFrom, NestedTupleIndex,
+        NestedTupleIndexMut, NestedTupleInto, NestedTupleMut, NestedTupleOption,
+        NestedTupleOptionWith, NestedTuplePopBack, NestedTuplePopFront, NestedTuplePushBack,
+        NestedTuplePushFront, NestedTupleRef, NestedTupleReplicate, NestedTupleRow,
+        NestedTupleRowMut, NestedTupleTryFrom, NestedTupleTryInto,
     };
     #[cfg(feature = "from")]
     pub use tuplities_from::{TupleFrom, TupleInto};