MPT-18065 WIP - Fix backward incompatible issues related to RQL: Support of property comparison

Author: albertsola

mpt_api_client/rql/__init__.py

@@ -1,3 +1,3 @@
-from mpt_api_client.rql.query_builder import RQLQuery
+from mpt_api_client.rql.query_builder import Literal, RQLQuery
 
-__all__ = ["RQLQuery"]  # noqa: WPS410
+__all__ = ["Literal", "RQLQuery"]  # noqa: WPS410

mpt_api_client/rql/query_builder.py

@@ -6,7 +6,19 @@
 
 Numeric = int | float | Decimal
 
-QueryValue = str | bool | dt.date | dt.datetime | Numeric
+
+class Literal:
+    """Wrapper for literal values in RQL queries."""
+
+    def __init__(self, value: str):
+        self.value = value
+
+    @override
+    def __str__(self) -> str:
+        return f"'{self.value}'"
+
+
+QueryValue = str | bool | dt.date | dt.datetime | Numeric | Literal  # noqa: WPS221
 
 
 def parse_kwargs(query_dict: dict[str, QueryValue]) -> list[str]:  # noqa: WPS231
@@ -71,6 +83,7 @@ def query_value_str(value: QueryValue) -> str:
 
     if isinstance(value, dt.date | dt.datetime):
         return value.isoformat()
+
     # Matching: if isinstance(value, int | float | Decimal):
     return str(value)
 

tests/unit/rql/query_builder/test_properties_values.py

@@ -0,0 +1,33 @@
+from mpt_api_client.rql import Literal, RQLQuery
+
+
+def test_compare_property():
+    query = RQLQuery(agreement__product__id="order.product.id")
+
+    result = str(query)
+
+    assert result == "eq(agreement.product.id,order.product.id)"
+
+
+def test_compare_quoted():
+    query = RQLQuery(agreement__product__id=Literal("order.product.id"))
+
+    result = str(query)
+
+    assert result == "eq(agreement.product.id,'order.product.id')"
+
+
+def test_ne_quoted():
+    query = RQLQuery("agreement.product.id")
+
+    result = str(query.ne(Literal("order.product.id")))
+
+    assert result == "ne(agreement.product.id,'order.product.id')"
+
+
+def test_ne_property():
+    query = RQLQuery("agreement.product.id")
+
+    result = str(query.ne("order.product.id"))
+
+    assert result == "ne(agreement.product.id,order.product.id)"