Skip to content

type_bridge.expressions.comparison

comparison

Comparison expressions for value-based filtering.

See :mod:type_bridge.expressions.utils for documentation on TypeDB 3.x variable scoping and why we generate unique attribute variables.

ComparisonExpr 

ComparisonExpr(attr_type, operator, value)

Bases: Expression

Type-safe comparison expression for filtering by attribute values.

Represents comparisons like age > 30, score <= 100, etc.

Create a comparison expression.

Parameters:

Name Type Description Default
attr_type type[T]

Attribute type to filter on

 required
operator Literal['>', '<', '>=', '<=', '==', '!=']

Comparison operator

 required
value T

Value to compare against

 required
Source code in type_bridge/expressions/comparison.py 
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
def __init__(
    self,
    attr_type: type[T],
    operator: Literal[">", "<", ">=", "<=", "==", "!="],
    value: T,
):
    """Create a comparison expression.

    Args:
        attr_type: Attribute type to filter on
        operator: Comparison operator
        value: Value to compare against
    """
    self.attr_type = attr_type
    self.operator = operator
    self.value = value

to_ast 

to_ast(var)

Generate AST patterns for this comparison.

Example: "$e has age $e_age; $e_age > 30"

Source code in type_bridge/expressions/comparison.py 
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
def to_ast(self, var: str) -> list["Pattern"]:
    """Generate AST patterns for this comparison.

    Example: "$e has age $e_age; $e_age > 30"
    """
    from type_bridge.crud.patterns import _get_literal_type
    from type_bridge.query.ast import (
        HasPattern,
        LiteralValue,
        ValueComparisonPattern,
    )

    attr_type_name = self.attr_type.get_attribute_name()
    attr_var = generate_attr_var(var, self.attr_type)

    # Unwrap value from Attribute wrapper if needed
    raw_value = self.value.value if hasattr(self.value, "value") else self.value
    literal_type = _get_literal_type(raw_value)

    return [
        HasPattern(thing_var=var, attr_type=attr_type_name, attr_var=attr_var),
        ValueComparisonPattern(
            var=attr_var,
            operator=self.operator,
            value=LiteralValue(value=raw_value, value_type=literal_type),
        ),
    ]

AttributeExistsExpr 

AttributeExistsExpr(attr_type, present)

Bases: Expression

Attribute presence/absence check expression.

Source code in type_bridge/expressions/comparison.py 
72
73
74
def __init__(self, attr_type: type[T], present: bool):
    self.attr_type = attr_type
    self.present = present