erase the original readable type
This commit is contained in:
1 parent
c8937cb4df
commit
8689509eb5
9 files changed
+99
-175
No files matched your search
@@ -1,47 +1,56 @@
|
||||
use std::{
|
||||
mem::MaybeUninit,
|
||||
ops::{Deref, Index},
|
||||
};
|
||||
use std::{mem::MaybeUninit, ops::Index, rc::Rc};
|
||||
|
||||
use generational_box::AnyStorage;
|
||||
|
||||
use crate::MappedSignal;
|
||||
|
||||
/// A reference to a value that can be read from.
|
||||
#[allow(type_alias_bounds)]
|
||||
pub type ReadableRef<T: Readable, O = <T as Readable>::Target> = <T::Storage as AnyStorage>::Ref<O>;
|
||||
|
||||
/// A trait for states that can be read from like [`crate::Signal`], [`crate::GlobalSignal`], or [`crate::ReadOnlySignal`]. You may choose to accept this trait as a parameter instead of the concrete type to allow for more flexibility in your API. For example, instead of creating two functions, one that accepts a [`crate::Signal`] and one that accepts a [`crate::GlobalSignal`], you can create one function that accepts a [`Readable`] type.
|
||||
pub trait Readable {
|
||||
/// The target type of the reference.
|
||||
type Target: ?Sized + 'static;
|
||||
|
||||
/// The type of the reference.
|
||||
type Ref<R: ?Sized + 'static>: Deref<Target = R> + 'static;
|
||||
|
||||
/// Map the reference to a new type.
|
||||
fn map_ref<I: ?Sized, U: ?Sized, F: FnOnce(&I) -> &U>(ref_: Self::Ref<I>, f: F)
|
||||
-> Self::Ref<U>;
|
||||
|
||||
/// Try to map the reference to a new type.
|
||||
fn try_map_ref<I: ?Sized, U: ?Sized, F: FnOnce(&I) -> Option<&U>>(
|
||||
ref_: Self::Ref<I>,
|
||||
f: F,
|
||||
) -> Option<Self::Ref<U>>;
|
||||
|
||||
/// Try to get the current value of the state. If this is a signal, this will subscribe the current scope to the signal. If the value has been dropped, this will panic.
|
||||
fn try_read(&self) -> Result<Self::Ref<Self::Target>, generational_box::BorrowError>;
|
||||
/// The type of the storage this readable uses.
|
||||
type Storage: AnyStorage;
|
||||
|
||||
/// Map the readable type to a new type.
|
||||
fn map<O>(self, f: impl Fn(&Self::Target) -> &O + 'static) -> MappedSignal<O, Self>
|
||||
fn map<O>(self, f: impl Fn(&Self::Target) -> &O + 'static) -> MappedSignal<O, Self::Storage>
|
||||
where
|
||||
Self: Sized + 'static,
|
||||
Self: Clone + Sized + 'static,
|
||||
{
|
||||
MappedSignal::new(self, f)
|
||||
let mapping = Rc::new(f);
|
||||
let try_read = Rc::new({
|
||||
let self_ = self.clone();
|
||||
let mapping = mapping.clone();
|
||||
move || {
|
||||
self_
|
||||
.try_read()
|
||||
.map(|ref_| <Self::Storage as AnyStorage>::map(ref_, |r| mapping(r)))
|
||||
}
|
||||
})
|
||||
as Rc<
|
||||
dyn Fn() -> Result<ReadableRef<Self, O>, generational_box::BorrowError> + 'static,
|
||||
>;
|
||||
let peek = Rc::new(move || <Self::Storage as AnyStorage>::map(self.peek(), |r| mapping(r)))
|
||||
as Rc<dyn Fn() -> ReadableRef<Self, O> + 'static>;
|
||||
MappedSignal::new(try_read, peek)
|
||||
}
|
||||
|
||||
/// Get the current value of the state. If this is a signal, this will subscribe the current scope to the signal. If the value has been dropped, this will panic.
|
||||
#[track_caller]
|
||||
fn read(&self) -> Self::Ref<Self::Target> {
|
||||
fn read(&self) -> ReadableRef<Self> {
|
||||
self.try_read().unwrap()
|
||||
}
|
||||
|
||||
/// Try to get the current value of the state. If this is a signal, this will subscribe the current scope to the signal. If the value has been dropped, this will panic.
|
||||
#[track_caller]
|
||||
fn try_read(&self) -> Result<ReadableRef<Self>, generational_box::BorrowError>;
|
||||
|
||||
/// Get the current value of the state without subscribing to updates. If the value has been dropped, this will panic.
|
||||
fn peek(&self) -> Self::Ref<Self::Target>;
|
||||
fn peek(&self) -> ReadableRef<Self>;
|
||||
|
||||
/// Clone the inner value and return it. If the value has been dropped, this will panic.
|
||||
#[track_caller]
|
||||
@@ -66,11 +75,11 @@ pub trait Readable {
|
||||
|
||||
/// Index into the inner value and return a reference to the result. If the value has been dropped or the index is invalid, this will panic.
|
||||
#[track_caller]
|
||||
fn index<I>(&self, index: I) -> Self::Ref<<Self::Target as std::ops::Index<I>>::Output>
|
||||
fn index<I>(&self, index: I) -> ReadableRef<Self, <Self::Target as std::ops::Index<I>>::Output>
|
||||
where
|
||||
Self::Target: std::ops::Index<I>,
|
||||
{
|
||||
Self::map_ref(self.read(), |v| v.index(index))
|
||||
<Self::Storage as AnyStorage>::map(self.read(), |v| v.index(index))
|
||||
}
|
||||
|
||||
#[doc(hidden)]
|
||||
@@ -124,20 +133,20 @@ pub trait ReadableVecExt<T: 'static>: Readable<Target = Vec<T>> {
|
||||
|
||||
/// Get the first element of the inner vector.
|
||||
#[track_caller]
|
||||
fn first(&self) -> Option<Self::Ref<T>> {
|
||||
Self::try_map_ref(self.read(), |v| v.first())
|
||||
fn first(&self) -> Option<ReadableRef<Self, T>> {
|
||||
<Self::Storage as AnyStorage>::try_map(self.read(), |v| v.first())
|
||||
}
|
||||
|
||||
/// Get the last element of the inner vector.
|
||||
#[track_caller]
|
||||
fn last(&self) -> Option<Self::Ref<T>> {
|
||||
Self::try_map_ref(self.read(), |v| v.last())
|
||||
fn last(&self) -> Option<ReadableRef<Self, T>> {
|
||||
<Self::Storage as AnyStorage>::try_map(self.read(), |v| v.last())
|
||||
}
|
||||
|
||||
/// Get the element at the given index of the inner vector.
|
||||
#[track_caller]
|
||||
fn get(&self, index: usize) -> Option<Self::Ref<T>> {
|
||||
Self::try_map_ref(self.read(), |v| v.get(index))
|
||||
fn get(&self, index: usize) -> Option<ReadableRef<Self, T>> {
|
||||
<Self::Storage as AnyStorage>::try_map(self.read(), |v| v.get(index))
|
||||
}
|
||||
|
||||
/// Get an iterator over the values of the inner vector.
|
||||
@@ -160,7 +169,7 @@ pub struct ReadableValueIterator<'a, R> {
|
||||
}
|
||||
|
||||
impl<'a, T: 'static, R: Readable<Target = Vec<T>>> Iterator for ReadableValueIterator<'a, R> {
|
||||
type Item = R::Ref<T>;
|
||||
type Item = ReadableRef<R, T>;
|
||||
|
||||
fn next(&mut self) -> Option<Self::Item> {
|
||||
let index = self.index;
|
||||
@@ -189,8 +198,8 @@ pub trait ReadableOptionExt<T: 'static>: Readable<Target = Option<T>> {
|
||||
|
||||
/// Attempts to read the inner value of the Option.
|
||||
#[track_caller]
|
||||
fn as_ref(&self) -> Option<Self::Ref<T>> {
|
||||
Self::try_map_ref(self.read(), |v| v.as_ref())
|
||||
fn as_ref(&self) -> Option<ReadableRef<Self, T>> {
|
||||
<Self::Storage as AnyStorage>::try_map(self.read(), |v| v.as_ref())
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
Reference in new issue
Block a user