#[cfg(feature = "alloc")]
use alloc::{borrow::Cow, vec::Vec};
#[cfg(feature = "alloc")]
use core::ops::{Deref, DerefMut};
use core::{
any::{type_name, TypeId},
cell::Cell,
fmt::{Debug, Formatter},
marker::PhantomData,
mem::transmute,
ops::{Index, IndexMut},
ptr::{addr_of, addr_of_mut},
};
#[cfg(feature = "alloc")]
use serde::{Deserialize, Serialize};
pub use tuple_list::{tuple_list, tuple_list_type, TupleList};
#[cfg(any(feature = "xxh3", feature = "alloc"))]
use crate::hash_std;
use crate::HasLen;
#[cfg(feature = "alloc")]
use crate::Named;
#[inline] #[must_use]
pub fn type_eq<T: ?Sized, U: ?Sized>() -> bool {
struct W<'a, T: ?Sized, U: ?Sized>(&'a Cell<bool>, PhantomData<fn() -> (&'a T, &'a U)>);
impl<'a, T: ?Sized, U: ?Sized> Clone for W<'a, T, U> {
#[inline]
fn clone(&self) -> Self {
self.0.set(false);
W(self.0, self.1)
}
}
#[allow(clippy::mismatching_type_param_order)]
impl<'a, T: ?Sized> Copy for W<'a, T, T> {}
let detected = Cell::new(true);
let res = [W::<T, U>(&detected, PhantomData)].clone();
res[0].0.get()
}
pub trait SplitBorrow<'a> {
type SplitBorrowResult;
type SplitBorrowMutResult;
fn borrow(&'a self) -> Self::SplitBorrowResult;
fn borrow_mut(&'a mut self) -> Self::SplitBorrowMutResult;
}
impl<'a> SplitBorrow<'a> for () {
type SplitBorrowResult = ();
type SplitBorrowMutResult = ();
fn borrow(&'a self) -> Self::SplitBorrowResult {}
fn borrow_mut(&'a mut self) -> Self::SplitBorrowMutResult {}
}
impl<'a, Head, Tail> SplitBorrow<'a> for (Head, Tail)
where
Head: 'a,
Tail: SplitBorrow<'a>,
{
type SplitBorrowResult = (Option<&'a Head>, Tail::SplitBorrowResult);
type SplitBorrowMutResult = (Option<&'a mut Head>, Tail::SplitBorrowMutResult);
fn borrow(&'a self) -> Self::SplitBorrowResult {
(Some(&self.0), self.1.borrow())
}
fn borrow_mut(&'a mut self) -> Self::SplitBorrowMutResult {
(Some(&mut self.0), self.1.borrow_mut())
}
}
#[cfg(feature = "alloc")]
pub trait IntoVec<T> {
fn into_vec_reversed(self) -> Vec<T>
where
Self: Sized,
{
let mut ret = self.into_vec();
ret.reverse();
ret
}
fn into_vec(self) -> Vec<T>;
}
#[cfg(feature = "alloc")]
impl<T> IntoVec<T> for () {
#[inline]
fn into_vec(self) -> Vec<T> {
Vec::new()
}
}
pub trait HasConstLen {
const LEN: usize;
}
impl HasConstLen for () {
const LEN: usize = 0;
}
impl<Head, Tail> HasConstLen for (Head, Tail)
where
Tail: HasConstLen,
{
const LEN: usize = 1 + Tail::LEN;
}
impl<Head, Tail> HasLen for (Head, Tail)
where
Tail: HasLen,
{
#[inline]
fn len(&self) -> usize {
self.1.len() + 1
}
}
impl<Tail> HasLen for (Tail,)
where
Tail: HasLen,
{
#[inline]
fn len(&self) -> usize {
self.0.len()
}
}
impl HasLen for () {
#[inline]
fn len(&self) -> usize {
0
}
}
pub trait HasNameId {
fn const_name(&self) -> &'static str;
fn name_id(&self) -> u64 {
hash_std(self.const_name().as_bytes())
}
}
pub trait HasNameIdTuple: HasConstLen {
fn const_name_for(&self, index: usize) -> Option<&'static str>;
fn name_id_for(&self, index: usize) -> Option<u64>;
}
impl HasNameIdTuple for () {
fn const_name_for(&self, _index: usize) -> Option<&'static str> {
None
}
fn name_id_for(&self, _index: usize) -> Option<u64> {
None
}
}
impl<Head, Tail> HasNameIdTuple for (Head, Tail)
where
Head: HasNameId,
Tail: HasNameIdTuple,
{
fn const_name_for(&self, index: usize) -> Option<&'static str> {
if index == 0 {
Some(self.0.const_name())
} else {
self.1.const_name_for(index - 1)
}
}
fn name_id_for(&self, index: usize) -> Option<u64> {
if index == 0 {
Some(self.0.name_id())
} else {
self.1.name_id_for(index - 1)
}
}
}
pub trait MatchFirstType {
fn match_first_type<T: 'static>(&self) -> Option<&T>;
fn match_first_type_mut<T: 'static>(&mut self) -> Option<&mut T>;
}
impl MatchFirstType for () {
fn match_first_type<T: 'static>(&self) -> Option<&T> {
None
}
fn match_first_type_mut<T: 'static>(&mut self) -> Option<&mut T> {
None
}
}
impl<Head, Tail> MatchFirstType for (Head, Tail)
where
Head: 'static,
Tail: MatchFirstType,
{
fn match_first_type<T: 'static>(&self) -> Option<&T> {
if TypeId::of::<T>() == TypeId::of::<Head>() {
unsafe { (addr_of!(self.0) as *const T).as_ref() }
} else {
self.1.match_first_type::<T>()
}
}
fn match_first_type_mut<T: 'static>(&mut self) -> Option<&mut T> {
if TypeId::of::<T>() == TypeId::of::<Head>() {
unsafe { (addr_of_mut!(self.0) as *mut T).as_mut() }
} else {
self.1.match_first_type_mut::<T>()
}
}
}
pub trait ExtractFirstRefType {
fn take<'a, T: 'static>(self) -> (Option<&'a T>, Self);
}
impl ExtractFirstRefType for () {
fn take<'a, T: 'static>(self) -> (Option<&'a T>, Self) {
(None, ())
}
}
impl<Head, Tail> ExtractFirstRefType for (Option<&Head>, Tail)
where
Head: 'static,
Tail: ExtractFirstRefType,
{
fn take<'a, T: 'static>(mut self) -> (Option<&'a T>, Self) {
if TypeId::of::<T>() == TypeId::of::<Head>() {
let r = self.0.take();
(unsafe { transmute::<Option<&Head>, Option<&T>>(r) }, self)
} else {
let (r, tail) = self.1.take::<T>();
(r, (self.0, tail))
}
}
}
impl<Head, Tail> ExtractFirstRefType for (Option<&mut Head>, Tail)
where
Head: 'static,
Tail: ExtractFirstRefType,
{
fn take<'a, T: 'static>(mut self) -> (Option<&'a T>, Self) {
if TypeId::of::<T>() == TypeId::of::<Head>() {
let r = self.0.take();
(
unsafe { transmute::<Option<&mut Head>, Option<&T>>(r) },
self,
)
} else {
let (r, tail) = self.1.take::<T>();
(r, (self.0, tail))
}
}
}
pub trait ExtractFirstRefMutType {
fn take<'a, T: 'static>(self) -> (Option<&'a mut T>, Self);
}
impl ExtractFirstRefMutType for () {
fn take<'a, T: 'static>(self) -> (Option<&'a mut T>, Self) {
(None, ())
}
}
impl<Head, Tail> ExtractFirstRefMutType for (Option<&mut Head>, Tail)
where
Head: 'static,
Tail: ExtractFirstRefMutType,
{
fn take<'a, T: 'static>(mut self) -> (Option<&'a mut T>, Self) {
if TypeId::of::<T>() == TypeId::of::<Head>() {
let r = self.0.take();
(
unsafe { transmute::<Option<&mut Head>, Option<&mut T>>(r) },
self,
)
} else {
let (r, tail) = self.1.take::<T>();
(r, (self.0, tail))
}
}
}
pub trait SplitBorrowExtractFirstType<'a> {
type SplitBorrowResult: ExtractFirstRefType;
type SplitBorrowMutResult: ExtractFirstRefType + ExtractFirstRefMutType;
fn borrow(&'a self) -> Self::SplitBorrowResult;
fn borrow_mut(&'a mut self) -> Self::SplitBorrowMutResult;
}
impl<'a> SplitBorrowExtractFirstType<'a> for () {
type SplitBorrowResult = ();
type SplitBorrowMutResult = ();
fn borrow(&'a self) -> Self::SplitBorrowResult {}
fn borrow_mut(&'a mut self) -> Self::SplitBorrowMutResult {}
}
impl<'a, Head, Tail> SplitBorrowExtractFirstType<'a> for (Head, Tail)
where
Head: 'static,
Tail: SplitBorrowExtractFirstType<'a>,
{
type SplitBorrowResult = (Option<&'a Head>, Tail::SplitBorrowResult);
type SplitBorrowMutResult = (Option<&'a mut Head>, Tail::SplitBorrowMutResult);
fn borrow(&'a self) -> Self::SplitBorrowResult {
(Some(&self.0), self.1.borrow())
}
fn borrow_mut(&'a mut self) -> Self::SplitBorrowMutResult {
(Some(&mut self.0), self.1.borrow_mut())
}
}
pub trait MatchType {
fn match_type<T: 'static, FN: FnMut(&T)>(&self, f: &mut FN);
fn match_type_mut<T: 'static, FN: FnMut(&mut T)>(&mut self, f: &mut FN);
}
impl MatchType for () {
fn match_type<T: 'static, FN: FnMut(&T)>(&self, _: &mut FN) {}
fn match_type_mut<T: 'static, FN: FnMut(&mut T)>(&mut self, _: &mut FN) {}
}
impl<Head, Tail> MatchType for (Head, Tail)
where
Head: 'static,
Tail: MatchType,
{
fn match_type<T: 'static, FN: FnMut(&T)>(&self, f: &mut FN) {
if TypeId::of::<T>() == TypeId::of::<Head>() {
f(unsafe { (addr_of!(self.0) as *const T).as_ref() }.unwrap());
}
self.1.match_type::<T, FN>(f);
}
fn match_type_mut<T: 'static, FN: FnMut(&mut T)>(&mut self, f: &mut FN) {
if TypeId::of::<T>() == TypeId::of::<Head>() {
f(unsafe { (addr_of_mut!(self.0) as *mut T).as_mut() }.unwrap());
}
self.1.match_type_mut::<T, FN>(f);
}
}
#[cfg(feature = "alloc")]
pub trait NamedTuple: HasConstLen {
fn name(&self, index: usize) -> Option<&Cow<'static, str>>;
}
#[cfg(feature = "alloc")]
impl NamedTuple for () {
fn name(&self, _index: usize) -> Option<&Cow<'static, str>> {
None
}
}
#[cfg(feature = "alloc")]
impl Named for () {
#[inline]
fn name(&self) -> &Cow<'static, str> {
static NAME: Cow<'static, str> = Cow::Borrowed("Empty");
&NAME
}
}
#[cfg(feature = "alloc")]
impl<Head, Tail> NamedTuple for (Head, Tail)
where
Head: Named,
Tail: NamedTuple,
{
fn name(&self, index: usize) -> Option<&Cow<'static, str>> {
if index == 0 {
Some(self.0.name())
} else {
self.1.name(index - 1)
}
}
}
#[cfg(feature = "alloc")]
pub trait MatchName {
#[deprecated = "Use `.reference` and either `.get` (fallible access) or `[]` (infallible access) instead"]
fn match_name<T>(&self, name: &str) -> Option<&T>;
#[deprecated = "Use `.reference` and either `.get` (fallible access) or `[]` (infallible access) instead"]
fn match_name_mut<T>(&mut self, name: &str) -> Option<&mut T>;
}
#[cfg(feature = "alloc")]
impl MatchName for () {
fn match_name<T>(&self, _name: &str) -> Option<&T> {
None
}
fn match_name_mut<T>(&mut self, _name: &str) -> Option<&mut T> {
None
}
}
#[cfg(feature = "alloc")]
#[allow(deprecated)]
impl<Head, Tail> MatchName for (Head, Tail)
where
Head: Named,
Tail: MatchName,
{
fn match_name<T>(&self, name: &str) -> Option<&T> {
if type_eq::<Head, T>() && name == self.0.name() {
unsafe { (addr_of!(self.0) as *const T).as_ref() }
} else {
self.1.match_name::<T>(name)
}
}
fn match_name_mut<T>(&mut self, name: &str) -> Option<&mut T> {
if type_eq::<Head, T>() && name == self.0.name() {
unsafe { (addr_of_mut!(self.0) as *mut T).as_mut() }
} else {
self.1.match_name_mut::<T>(name)
}
}
}
#[cfg(feature = "alloc")]
pub trait Handled: Named {
fn handle(&self) -> Handle<Self> {
Handle {
name: Named::name(self).clone(),
phantom: PhantomData,
}
}
}
#[cfg(feature = "alloc")]
impl<N> Handled for N where N: Named {}
#[derive(Serialize, Deserialize)]
#[cfg(feature = "alloc")]
pub struct Handle<T: ?Sized> {
name: Cow<'static, str>,
#[serde(skip)]
phantom: PhantomData<T>,
}
#[cfg(feature = "alloc")]
impl<T: ?Sized> Handle<T> {
#[must_use]
pub fn new(name: Cow<'static, str>) -> Self {
Self {
name,
phantom: PhantomData,
}
}
#[must_use]
pub fn name(&self) -> &Cow<'static, str> {
&self.name
}
}
#[cfg(feature = "alloc")]
impl<T> Clone for Handle<T> {
fn clone(&self) -> Self {
Self {
name: self.name.clone(),
phantom: PhantomData,
}
}
}
#[cfg(feature = "alloc")]
impl<T> Debug for Handle<T> {
fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result {
f.debug_struct("Handle")
.field("name", self.name())
.field("type", &type_name::<T>())
.finish()
}
}
#[cfg(feature = "alloc")]
pub trait MatchNameRef {
fn get<T>(&self, rf: &Handle<T>) -> Option<&T>;
fn get_mut<T>(&mut self, rf: &Handle<T>) -> Option<&mut T>;
}
#[cfg(feature = "alloc")]
#[allow(deprecated)]
impl<M> MatchNameRef for M
where
M: MatchName,
{
fn get<T>(&self, rf: &Handle<T>) -> Option<&T> {
self.match_name::<T>(&rf.name)
}
fn get_mut<T>(&mut self, rf: &Handle<T>) -> Option<&mut T> {
self.match_name_mut::<T>(&rf.name)
}
}
#[cfg(feature = "alloc")]
#[derive(Copy, Clone, Debug)]
#[repr(transparent)]
pub struct RefIndexable<RM, M>(RM, PhantomData<M>);
#[cfg(feature = "alloc")]
impl<RM, M> From<RM> for RefIndexable<RM, M>
where
RM: Deref<Target = M>,
M: MatchName,
{
fn from(value: RM) -> Self {
RefIndexable(value, PhantomData)
}
}
#[cfg(feature = "alloc")]
impl<RM, M> Deref for RefIndexable<RM, M>
where
RM: Deref<Target = M>,
{
type Target = RM::Target;
fn deref(&self) -> &Self::Target {
&self.0
}
}
#[cfg(feature = "alloc")]
impl<RM, M> DerefMut for RefIndexable<RM, M>
where
RM: DerefMut<Target = M>,
{
fn deref_mut(&mut self) -> &mut Self::Target {
&mut self.0
}
}
#[cfg(feature = "alloc")]
impl<T, RM, M> Index<&Handle<T>> for RefIndexable<RM, M>
where
RM: Deref<Target = M>,
M: MatchName,
{
type Output = T;
fn index(&self, index: &Handle<T>) -> &Self::Output {
let Some(e) = self.get(index) else {
panic!("Could not find entry matching {index:?}")
};
e
}
}
#[cfg(feature = "alloc")]
impl<T, RM, M> IndexMut<&Handle<T>> for RefIndexable<RM, M>
where
RM: DerefMut<Target = M>,
M: MatchName,
{
fn index_mut(&mut self, index: &Handle<T>) -> &mut Self::Output {
let Some(e) = self.get_mut(index) else {
panic!("Could not find entry matching {index:?}")
};
e
}
}
pub trait Prepend<T> {
type PreprendResult;
#[must_use]
fn prepend(self, value: T) -> (T, Self::PreprendResult);
}
impl<Tail, T> Prepend<T> for Tail {
type PreprendResult = Self;
fn prepend(self, value: T) -> (T, Self::PreprendResult) {
(value, self)
}
}
pub trait Append<T> {
type AppendResult;
#[must_use]
fn append(self, value: T) -> Self::AppendResult;
}
impl<T> Append<T> for () {
type AppendResult = (T, ());
fn append(self, value: T) -> Self::AppendResult {
(value, ())
}
}
impl<Head, Tail, T> Append<T> for (Head, Tail)
where
Tail: Append<T>,
{
type AppendResult = (Head, Tail::AppendResult);
fn append(self, value: T) -> Self::AppendResult {
let (head, tail) = self;
(head, tail.append(value))
}
}
pub trait Merge<T> {
type MergeResult;
#[must_use]
fn merge(self, value: T) -> Self::MergeResult;
}
impl<T> Merge<T> for () {
type MergeResult = T;
fn merge(self, value: T) -> Self::MergeResult {
value
}
}
impl<Head, Tail, T> Merge<T> for (Head, Tail)
where
Tail: Merge<T>,
{
type MergeResult = (Head, Tail::MergeResult);
fn merge(self, value: T) -> Self::MergeResult {
let (head, tail) = self;
(head, tail.merge(value))
}
}
pub trait MappingFunctor<T> {
type Output;
fn apply(&mut self, from: T) -> Self::Output;
}
pub trait Map<M> {
type MapResult;
fn map(self, mapper: M) -> Self::MapResult;
}
impl<Head, Tail, M> Map<M> for (Head, Tail)
where
M: MappingFunctor<Head>,
Tail: Map<M>,
{
type MapResult = (M::Output, Tail::MapResult);
fn map(self, mut mapper: M) -> Self::MapResult {
let head = mapper.apply(self.0);
(head, self.1.map(mapper))
}
}
impl<M> Map<M> for () {
type MapResult = ();
fn map(self, _mapper: M) -> Self::MapResult {}
}
#[macro_export]
#[allow(clippy::items_after_statements)]
macro_rules! tuple_for_each {
($fn_name:ident, $trait_name:path, $tuple_name:ident, $body:expr) => {
#[allow(clippy::items_after_statements)]
mod $fn_name {
pub trait ForEach {
fn for_each(&self);
}
impl ForEach for () {
fn for_each(&self) {}
}
impl<Head, Tail> ForEach for (Head, Tail)
where
Head: $trait_name,
Tail: tuple_list::TupleList + ForEach,
{
#[allow(clippy::redundant_closure_call)]
fn for_each(&self) {
($body)(&self.0);
self.1.for_each();
}
}
}
{
use $fn_name::*;
$tuple_name.for_each();
};
};
}
#[macro_export]
macro_rules! tuple_for_each_mut {
($fn_name:ident, $trait_name:path, $tuple_name:ident, $body:expr) => {
#[allow(clippy::items_after_statements)]
mod $fn_name {
pub trait ForEachMut {
fn for_each_mut(&mut self);
}
impl ForEachMut for () {
fn for_each_mut(&mut self) {}
}
impl<Head, Tail> ForEachMut for (Head, Tail)
where
Head: $trait_name,
Tail: tuple_list::TupleList + ForEachMut,
{
#[allow(clippy::redundant_closure_call)]
fn for_each_mut(&mut self) {
($body)(&mut self.0);
self.1.for_each_mut();
}
}
}
{
use $fn_name::*;
$tuple_name.for_each_mut();
};
};
}
#[cfg(test)]
#[cfg(feature = "std")]
#[test]
#[allow(clippy::items_after_statements)]
pub fn test_macros() {
let mut t = tuple_list!(1, "a");
tuple_for_each!(f1, std::fmt::Display, t, |x| {
log::info!("{x}");
});
tuple_for_each_mut!(f2, std::fmt::Display, t, |x| {
log::info!("{x}");
});
}
#[cfg(test)]
mod test {
use tuple_list::{tuple_list, tuple_list_type};
#[cfg(feature = "alloc")]
use crate::ownedref::OwnedMutSlice;
use crate::tuples::{type_eq, Map, MappingFunctor};
#[test]
#[allow(unused_qualifications)] fn test_type_eq_simple() {
assert!(type_eq::<u64, u64>());
assert!(!type_eq::<u64, usize>());
}
#[test]
#[cfg(feature = "alloc")]
#[allow(unused_qualifications)] fn test_type_eq() {
type OwnedMutSliceAlias<'a> = OwnedMutSlice<'a, u8>;
#[allow(clippy::extra_unused_lifetimes)]
fn test_lifetimes<'a, 'b>() {
assert!(type_eq::<OwnedMutSlice<'a, u8>, OwnedMutSlice<'b, u8>>());
assert!(type_eq::<OwnedMutSlice<'static, u8>, OwnedMutSlice<'a, u8>>());
assert!(type_eq::<OwnedMutSlice<'a, u8>, OwnedMutSlice<'b, u8>>());
assert!(type_eq::<OwnedMutSlice<'a, u8>, OwnedMutSlice<'static, u8>>());
assert!(!type_eq::<OwnedMutSlice<'a, u8>, OwnedMutSlice<'b, i8>>());
}
assert!(type_eq::<OwnedMutSlice<u8>, OwnedMutSliceAlias>());
test_lifetimes();
assert!(type_eq::<OwnedMutSlice<u8>, OwnedMutSlice<u8>>());
assert!(!type_eq::<OwnedMutSlice<u8>, OwnedMutSlice<u32>>());
assert!(type_eq::<
OwnedMutSlice<u8>,
crate::ownedref::OwnedMutSlice<u8>,
>());
assert!(!type_eq::<
OwnedMutSlice<u8>,
crate::ownedref::OwnedMutSlice<u32>,
>());
}
#[test]
fn test_mapper() {
struct W<T>(T);
struct MyMapper;
impl<T> MappingFunctor<T> for MyMapper {
type Output = W<T>;
fn apply(&mut self, from: T) -> Self::Output {
W(from)
}
}
struct A;
struct B;
struct C;
let orig = tuple_list!(A, B, C);
let mapped = orig.map(MyMapper);
#[allow(clippy::no_effect_underscore_binding)]
let _type_assert: tuple_list_type!(W<A>, W<B>, W<C>) = mapped;
}
}