enable multiple AND filters on the same column

- specify as { 'column__<op>`: value }

Author: miraculixx

dataset/table.py

@@ -424,7 +424,11 @@ def _args_to_clause(self, args, clauses=()):
         clauses = list(clauses)
         for column, value in args.items():
             column = self._get_column_name(column)
-            if not self.has_column(column):
+            if '__' in column:
+                # enable Django-style column__<op>=value syntax
+                column, op = column.split('__', 1)
+                clauses.append(self._generate_clause(column, op, value))
+            elif not self.has_column(column):
                 clauses.append(false())
             elif isinstance(value, (list, tuple, set)):
                 clauses.append(self._generate_clause(column, "in", value))

docs/queries.rst

@@ -5,7 +5,7 @@ Advanced filters
 ================
 
 ``dataset`` provides two methods for running queries: :py:meth:`table.find() <dataset.Table.find>`
-and :py:meth:`db.query() <dataset.Database.query>`. The table find helper method provides 
+and :py:meth:`db.query() <dataset.Database.query>`. The table find helper method provides
 limited, but simple filtering options::
 
     results = table.find(column={operator: value})
@@ -23,6 +23,12 @@ A special form is using keyword searches on specific columns::
     # equal to:
     results = table.find(value={'in': ('foo', 'bar')})
 
+To AND-combine multiple operators on the same column, you may specify
+the operator using the `column__operator=value` format::
+
+    # height >= 20 AND height <= 50
+    table.find({'height__gte': 20, 'height__lte: 50'}
+
 The following comparison operators are supported:
 
 ============== ============================================================
@@ -69,4 +75,4 @@ Finally, you should consider falling back to SQLAlchemy_ core to construct
 queries if you are looking for a programmatic, composable method of generating
 SQL in Python.
 
-.. _SQLALchemy: https://docs.sqlalchemy.org/
+.. _SQLALchemy: https://docs.sqlalchemy.org/

test/test_dataset.py

@@ -353,6 +353,26 @@ def test_find_dsl(self):
         ds = list(self.tbl.find(place={"ilike": "%LwAy"}))
         assert len(ds) == 3, ds
 
+    def test_find_dsl_dunder_op(self):
+        ds = list(self.tbl.find(place__like="%lw%"))
+        assert len(ds) == 3, ds
+        ds = list(self.tbl.find(temperature__gt=5))
+        assert len(ds) == 2, ds
+        ds = list(self.tbl.find(temperature__gte=5))
+        assert len(ds) == 3, ds
+        ds = list(self.tbl.find(temperature__lt=0))
+        assert len(ds) == 1, ds
+        ds = list(self.tbl.find(temperature__lte=0))
+        assert len(ds) == 2, ds
+        ds = list(self.tbl.find(temperature__not=-1))
+        assert len(ds) == 5, ds
+        ds = list(self.tbl.find(temperature__between=[5, 8]))
+        assert len(ds) == 3, ds
+        ds = list(self.tbl.find(place="G€lway"))
+        assert len(ds) == 3, ds
+        ds = list(self.tbl.find(place__ilike="%LwAy"))
+        assert len(ds) == 3, ds
+
     def test_offset(self):
         ds = list(self.tbl.find(place=TEST_CITY_1, _offset=1))
         assert len(ds) == 2, ds