Numeric filters

NumberComparisonFilter

Filters by comparing a field to a numeric value.

Table

Property	Type	Description
operator	ComparisonOperators	The operator to apply to the filter value
value	numeric	The value to use for the filter operation

Formats

Example

A JSON example of this model.

{
  "operator": "gt",
  "value": 1000
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: NumberComparisonFilter.yaml
type: object
properties:
  operator:
    anyOf:
      - $ref: ComparisonOperators.yaml
      - $ref: EquivalenceOperators.yaml
    description: The comparison operator to apply to the filter value
  value:
    type: number
    examples:
      - 1000
    description: The value to use for the filter operation
required:
  - operator
  - value
unevaluatedProperties:
  not: {}
description: Filters by comparing a field to a numeric value

TypeSpec

The TypeSpec code for this model.

/** Filters by comparing a field to a numeric value */
@Versioning.added(CommonGrants.Versions.v0_1)
model NumberComparisonFilter {
  /** The comparison operator to apply to the filter value */
  @Versioning.typeChangedFrom(CommonGrants.Versions.v0_3, ComparisonOperators)
  operator: ComparisonOperators | EquivalenceOperators;

  /** The value to use for the filter operation */
  @example(1000)
  value: numeric;
}

Python

The Python code for this model.

class NumberComparisonFilter(CommonGrantsBaseModel):
    """Filter that matches numbers against a specific value."""

    operator: ComparisonOperator = Field(
        ...,
        description="The comparison operator to apply to the filter value",
    )
    value: Union[int, float] = Field(
        ..., description="The numeric value to compare against"
    )

TypeScript

The TypeScript code for this model.

export const NumberComparisonFilterSchema = z.object({
  operator: z.union([ComparisonOperatorsEnum, EquivalenceOperatorsEnum]),
  value: z.number(),
});

Changelog

Version	Changes	Schema
0.1.0	Added NumberComparisonFilter model	NumberComparisonFilter.yaml

NumberRangeFilter

Filters by comparing a field to a range of numeric values.

Table

Filter schema

Property	Type	Description
operator	RangeOperators	The operator to apply to the filter value
value	range object	The value to use for the filter operation

Range object

Property	Type	Description
min	numeric	The minimum numeric value for this range
max	numeric	The maximum numeric value for this range

Formats

Example

A JSON example of this model.

{
  "operator": "between",
  "value": {
    "min": 1000,
    "max": 10000
  }
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: NumberRangeFilter.yaml
type: object
properties:
  operator:
    $ref: RangeOperators.yaml
    description: The operator to apply to the filter value
  value:
    type: object
    properties:
      min:
        type: number
      max:
        type: number
    required:
      - min
      - max
    unevaluatedProperties:
      not: {}
    examples:
      - min: 1000
        max: 10000
    description: The value to use for the filter operation
required:
  - operator
  - value
unevaluatedProperties:
  not: {}
description: Filters by comparing a field to a numeric range

TypeSpec

The TypeSpec code for this model.

/** Filters by comparing a field to an integer value */
@Versioning.added(CommonGrants.Versions.v0_4)
model IntegerComparisonFilter {
  /** The comparison operator to apply to the filter value */
  operator: ComparisonOperators | EquivalenceOperators;

  /** The value to use for the filter operation */
  @example(100)
  value: integer;
}

// ############################################################################
// Number range filter

Python

The Python code for this model.

class NumberRangeFilter(CommonGrantsBaseModel):
    """Filter that matches numbers within a specified range."""

    operator: RangeOperator = Field(
        ...,
        description="The operator to apply to the filter value",
    )
    value: NumberRange = Field(..., description="The numeric range value")

    @field_validator("operator", mode="before")
    @classmethod
    def validate_operator(cls, v):
        """Convert string to enum if needed."""
        if isinstance(v, str):
            return RangeOperator(v)
        return v

TypeScript

The TypeScript code for this model.

export const NumberRangeFilterSchema = z.object({
  operator: RangeOperatorsEnum,
  value: z.object({
    min: z.number(),
    max: z.number(),
  }),
});

Changelog

Version	Changes	Schema
0.1.0	Added NumberRangeFilter model	NumberRangeFilter.yaml

NumberArrayFilter

Filters by comparing a field to an array of numeric values.

Table

Property	Type	Description
operator	ArrayOperators	The operator to apply to the filter value
value	Array<numeric>	The value to use for the filter operation

Formats

Example

A JSON example of this model.

{
  "operator": "in",
  "value": [
    1000,
    2000,
    3000
  ]
}

JSON Schema

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: NumberArrayFilter.yaml
type: object
properties:
  operator:
    $ref: ArrayOperators.yaml
    description: The operator to apply to the filter value
  value:
    type: array
    items:
      type: number
    examples:
      - - 1000
        - 2000
        - 3000
    description: The value to use for the filter operation
required:
  - operator
  - value
unevaluatedProperties:
  not: {}
description: Filters by comparing a field to an array of numeric values

TypeSpec

The TypeSpec code for this model.

  /** The operator to apply to the filter value */
  operator: RangeOperators;

  /** The value to use for the filter operation */
  @example(#{ min: 1000, max: 10000 })
  value: {
    min: numeric;
    max: numeric;
  };
}

Python

The Python code for this model.

class NumberArrayFilter(CommonGrantsBaseModel):
    """Filter that matches against an array of numeric values."""

    operator: ArrayOperator = Field(
        ...,
        description="The operator to apply to the filter value",
    )
    value: list[Union[int, float]] = Field(
        ..., description="The array of numeric values"
    )

    @field_validator("operator", mode="before")
    @classmethod
    def validate_operator(cls, v):
        """Convert string to enum if needed."""
        if isinstance(v, str):
            return ArrayOperator(v)
        return v

TypeScript

The TypeScript code for this model.

export const NumberArrayFilterSchema = z.object({
  operator: ArrayOperatorsEnum,
  value: z.array(z.number()),
});

Changelog

Version	Changes	Schema
0.1.0	Added NumberArrayFilter model	NumberArrayFilter.yaml