Module filter 

Query filter system inspired by Laravel Filter Query String

Provides a flexible, type-safe filtering system for database queries. Supports complex query expressions through URL-friendly parameters.

Example Query String

?username[contain]=john&age[gt]=18&status[eq]=active&orderby=name&limit=10

Supported Operators

Operator	Description	SQL Equivalent
eq	Equal	field = value
notEq	Not equal	field != value
gt	Greater than	field > value
gte / gtEq	Greater or equal	field >= value
lt	Less than	field < value
lte / ltEq	Less or equal	field <= value
like	Case-sensitive LIKE	field LIKE value
ilike	Case-insensitive LIKE	field ILIKE value
notlike	NOT LIKE	field NOT LIKE value
contain	Contains	field LIKE %value%
notcontain	Does not contain	field NOT LIKE %value%
startwith	Starts with	field LIKE value%
endwith	Ends with	field LIKE %value
in	In array	field IN (...)
notin	Not in array	field NOT IN (...)
between	Between two values	field BETWEEN a AND b
notbetween	Not between	field NOT BETWEEN a AND b
isnull	Is null	field IS NULL
isnotnull	Is not null	field IS NOT NULL
or	OR condition	OR field = value

Re-exports

pub use cursor::CursorPayload;

pub use cursor::CursorError;

pub use cursor::encode_cursor;

pub use cursor::decode_cursor;

Modules

cursor

Keyset (cursor) paging for the generic list endpoint.

Structs

FilterCondition

A single filter condition

QueryFilter

Complete query filter specification

QueryParamError

One query parameter that could not be applied.

SortSpec

Sort specification

Enums

FilterLogical

Logical operator for combining conditions

FilterOperator

Filter operator types

FilterValue

Filter condition value

QueryParamReason

Why a query parameter was refused. The code (as_str) is the stable, snake_case reason clients branch on.

SortDirection

Sort direction

Traits

FilterableEntity

Trait for entities to declare which fields are allowed in filter queries.

Functions

attribute_operator_error

attribute_query_error for an undefined-operator refusal that more than one filter could have raised: column_types (column name to Postgres data_type, read from the catalog) narrows the candidates to the filters on columns the operator cannot apply to — a pattern operator on anything but text. Left unchanged when that is still not exactly one.

attribute_query_error

Name the query parameter behind a failed list-shaped statement.

is_internal_key

True for a key in the framework’s internal __ namespace (__base_condition, __base_condition[eq], …), which no client-supplied filter may use.

is_valid_field

Validate a field name against an allow-list

parse_filters

Parse filter from query parameters HashMap

sanitize_field_name

Sanitize a field name for SQL identifier use

undefined_operator

Whether err is the database’s refusal of an operator its operand types lack, and whether it was a pattern operator (~~).