Crate rs_query 

rs-query: TanStack Query-inspired data fetching for GPUI

Features

• Declarative queries - Define once, auto-cache
• spawn_query/spawn_mutation - One-liner async execution
• Stale-while-revalidate - Show cached data while fetching
• Automatic retries - Exponential backoff for transient failures
• Cache invalidation - Hierarchical key patterns

Example

use rs_query::{QueryClient, QueryKey, QueryState, Query, spawn_query};

// Define a query
let query = Query::new(QueryKey::new("users"), || async {
    fetch_users().await
});

// Execute with automatic state management
spawn_query(cx, &client, &query, |this, state, cx| {
    match state {
        QueryState::Success(users) => this.users = users,
        QueryState::Error { error, .. } => this.error = Some(error),
        _ => {}
    }
    cx.notify();
});

Structs

Mutation

A mutation definition.

Query

A query definition.

QueryClient

Central query client managing cache and query execution.

QueryKey

A hierarchical query key for cache lookup and invalidation.

QueryOptions

Configuration options for a query

RetryConfig

Retry configuration with exponential backoff

Enums

MutationState

Mutation state

QueryError

Errors that can occur during query/mutation operations

QueryState

Represents the state of a query.

RefetchOnMount

When to refetch on mount

Functions

spawn_mutation

Execute a mutation with automatic cache invalidation.

spawn_query

Execute a query using GPUI’s executor.