add between and support (#289)

CHANGELOG.rst

@@ -5,6 +5,7 @@ Changelog
 0.15.11
 -------
 - Added ``ordering`` option for model ``Meta`` class to apply default ordering
+- Added ``range`` filter to support ``between and`` syntax
 
 0.15.10
 -------

CONTRIBUTORS.rst

@@ -23,6 +23,7 @@ Contributors
 * Rebecca Klauser ``@svms1``
 * Sina Sohangir ``@sinaso``
 * Weiming Dong ``@dongweiming``
+* Jinlong Peng ``@long2ice``
 
 Special Thanks
 ==============

docs/query.rst

@@ -255,6 +255,7 @@ When using ``.filter()`` method you can use number of modifiers to field names t
 - ``gt`` - greater than passed value
 - ``lte`` - lower or equals than passed value
 - ``lt`` - lower than passed value
+- ``range`` - between and given two values
 - ``isnull`` - field is null
 - ``not_isnull`` - field is not null
 - ``contains`` - field contains specified substring

tests/test_filters.py

@@ -220,3 +220,11 @@ async def test_gt(self):
             .values_list("decimal", flat=True),
             [Decimal("2.3"), Decimal("2.3457"), Decimal("23")],
         )
+
+    async def test_between_and(self):
+        self.assertEqual(
+            await DecimalFields.filter(
+                decimal__range=(Decimal("1.2344"), Decimal("1.2346"))
+            ).values_list("decimal", flat=True),
+            [Decimal("1.2345")],
+        )

tortoise/filters.py

@@ -1,6 +1,6 @@
 import operator
 from functools import partial
-from typing import TYPE_CHECKING, Any, Dict, Iterable, Optional
+from typing import TYPE_CHECKING, Any, Dict, Iterable, Optional, Tuple
 
 from pypika import Table
 from pypika.enums import SqlTypes
@@ -53,6 +53,10 @@ def not_in(field: Term, value: Any) -> Criterion:
     return field.notin(value) | field.isnull()
 
 
+def between_and(field: Term, value: Tuple[Any, Any]) -> Criterion:
+    return field.between(value[0], value[1])
+
+
 def not_equal(field: Term, value: Any) -> Criterion:
     return field.ne(value) | field.isnull()
 
@@ -235,6 +239,12 @@ def get_filters_for_field(
             "source_field": source_field,
             "operator": operator.lt,
         },
+        f"{field_name}__range": {
+            "field": actual_field_name,
+            "source_field": source_field,
+            "operator": between_and,
+            "value_encoder": list_encoder,
+        },
         f"{field_name}__contains": {
             "field": actual_field_name,
             "source_field": source_field,