dioxus-query
🦀
⚡
Fully-typed, async, reusable state management and synchronization for Dioxus 🧬. Inspired by TanStack Query.
Installation
Compatible with Dioxus v0.4.
cargo add dioxus-query
Example
cargo run --example basic
Usage
#[derive(Clone, PartialEq, Debug)]
enum QueryKeys {
User(usize),
}
#[derive(Clone, PartialEq, Debug)]
enum QueryError {
UserNotFound(usize)
}
async fn fetch_user(id: usize) -> QueryResult<String, QueryError> {
sleep(Duration::from_millis(1000)).await;
match id {
0 => Ok("Marc".to_string()),
_ => Err(QueryError::UserNotFound(id)),
}
.into()
}
#[allow(non_snake_case)]
#[inline_props]
fn User(cx: Scope, id: usize) -> Element {
to_owned![id];
let value = use_query(cx, move || vec![QueryKeys::User(id)], {
move |_keys| fetch_user(id)
});
render!( p { "{value.result():?}" } )
}
fn app(cx: Scope) -> Element {
let client = use_provide_client(cx);
let refresh = |_| client.invalidate_query(QueryKeys::User(0));
render!(
User { id: 0 }
button { onclick: refresh, label { "Refresh" } }
)
}
Features
- Renderer-agnostic
- Typed Query keys
- Manual query invalidation
- Automatic/smart query invalidation
- Query aborting
- Global Query caching
MIT License
13 Dec 19, 2022
3 Mar 30, 2024
8 Dec 28, 2022
9 Oct 9, 2022
8 Dec 22, 2022
5 Nov 9, 2022
6 Jan 31, 2023
57 Jul 12, 2023
15 Feb 12, 2022
8 Sep 16, 2024
15 Dec 27, 2022
23 Jul 9, 2024
4 Nov 27, 2023
5 Jul 24, 2023
24 Dec 13, 2023
5 May 2, 2024
13 Jan 25, 2023