Skip to content

Document supported attribute filter operators #32

@dfalbel

Description

@dfalbel

Summary

The attribute filters guide (user_guide/03-attribute-filters.qmd) demonstrates filter usage through examples but doesn't include a reference section listing all supported operators.

A user reading the guide can infer =, >=, AND, and IS NULL from the examples, but there's no way to discover the full set of available operators without reading the source code.

Suggested addition

A "Filter Operators" reference section listing:

Comparison operators (SQL-like string / dict AST):

  • = / eq, != / ne
  • > / gt, >= / gte, < / lt, <= / lte
  • IN / in, NOT IN / nin
  • IS NULL, IS NOT NULL

Logical operators:

  • AND, OR

Dict AST structure:

  • {"type": "<operator>", "key": "<column>", "value": <value>}
  • {"type": "and"|"or", "filters": [...]}

This could go between the current "Recap: Declaring Attributes" and "Built-In Backend Columns" sections, or as a new standalone section.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions