Struct ApiQuerySet 

pub struct ApiQuerySet<T> { /* private fields */ }

A QuerySet-like builder for API requests.

This provides a fluent interface similar to Django’s QuerySet for building and executing API queries.

Implementations

impl<T> ApiQuerySet<T>

where T: Serialize + DeserializeOwned,

pub fn new(endpoint: impl Into<String>) -> Self

Creates a new QuerySet for the given endpoint.

pub fn filter(self, field: impl Into<String>, value: impl Serialize) -> Self

Adds a filter condition (exact match).

Example

User::objects().filter("is_active", true)

pub fn filter_op( self, field: impl Into<String>, op: FilterOp, value: impl Serialize, ) -> Self

Adds a filter with a specific operation.

Example

User::objects().filter_op("age", FilterOp::Gte, 18)

pub fn exclude(self, field: impl Into<String>, value: impl Serialize) -> Self

Adds an exclude filter (NOT condition).

Example

User::objects().exclude("status", "banned")

pub fn order_by(self, fields: &[&str]) -> Self

Sets the ordering for results.

Prefix field names with ‘-’ for descending order.

Example

User::objects().order_by(&["-created_at", "username"])

pub fn limit(self, n: usize) -> Self

Limits the number of results.

Example

User::objects().limit(10)

pub fn offset(self, n: usize) -> Self

Skips the first N results.

Example

User::objects().offset(20).limit(10)  // Page 3

pub fn only(self, fields: &[&str]) -> Self

Selects specific fields for partial responses.

Example

User::objects().only(&["id", "username"])

pub fn all_clone(&self) -> Self

Returns a clone of this QuerySet with no filters or ordering.

pub fn build_url(&self) -> String

Builds the query URL with all parameters.

pub async fn all(&self) -> Result<Vec<T>, ServerFnError>

Fetches all matching results (non-WASM stub).

pub async fn first(&self) -> Result<Option<T>, ServerFnError>

Fetches the first matching result (non-WASM stub).

pub async fn get(&self, _pk: impl Display) -> Result<T, ServerFnError>

Fetches a single result by primary key (non-WASM stub).

pub async fn count(&self) -> Result<usize, ServerFnError>

Returns the count of matching results (non-WASM stub).

pub async fn exists(&self) -> Result<bool, ServerFnError>

where Self: Clone,

Checks if any matching results exist.

pub async fn create(&self, _data: &T) -> Result<T, ServerFnError>

Creates a new record (non-WASM stub).

pub async fn update( &self, _pk: impl Display, _data: &T, ) -> Result<T, ServerFnError>

Updates an existing record (non-WASM stub).

pub async fn partial_update( &self, _pk: impl Display, _data: &Value, ) -> Result<T, ServerFnError>

Partially updates an existing record (non-WASM stub).

pub async fn delete(&self, _pk: impl Display) -> Result<(), ServerFnError>

Deletes a record by primary key (non-WASM stub).

Trait Implementations

impl<T: Clone> Clone for ApiQuerySet<T>

fn clone(&self) -> ApiQuerySet<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for ApiQuerySet<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.