Discord Server

dioxus-query 🦀⚡

Fully-typed, async, reusable state management and synchronization for Dioxus 🧬. Inspired by TanStack Query.

See the Docs or join the Discord.

⚠️ Work in progress ⚠️

Support

Installation

Install the latest release: bash cargo add dioxus-query

Example

bash cargo run --example simple

Usage

```rust

[derive(Clone, PartialEq, Eq, Hash)]

enum QueryKeys { User(usize), }

[derive(Clone, PartialEq, Eq, Hash, Debug)]

enum QueryError { UserNotFound(usize), Unknown }

[derive(Clone, PartialEq, Eq, Hash, Debug)]

enum QueryValue { UserName(String), }

async fn fetchuser(keys: Vec) -> QueryResult { if let Some(QueryKeys::User(id)) = keys.first() { println!("Fetching user {id}"); sleep(Duration::frommillis(1000)).await; match id { 0 => Ok(QueryValue::UserName("Marc".to_string())), _ => Err(QueryError::UserNotFound(*id)), } .into() } else { QueryResult::Err(QueryError::Unknown) } }

[allow(nonsnakecase)]

[inline_props]

fn User(cx: Scope, id: usize) -> Element { let value = usequery(cx, || vec![QueryKeys::User(*id)], fetchuser);

render!( p { "{value.result().value():?}" } )

}

fn app(cx: Scope) -> Element { let client = usequeryclient::(cx);

let refresh = move |_| {
    to_owned![client];
    cx.spawn(async move {
        client.invalidate_query(QueryKeys::User(0)).await;
    });
};

render!(
    User { id: 0 }
    button { onclick: refresh, label { "Refresh" } }
)

} ```

Features

To Do

MIT License