Support reverse triple slice WOQL

Author: hoijnet

terminusdb_client/woqlquery/woql_query.py

@@ -1066,6 +1066,69 @@ def quad_slice(self, sub, pred, obj, low, high, graph):
         self._cursor["graph"] = self._clean_graph(graph)
         return self
 
+    def triple_slice_rev(self, sub, pred, obj, low, high):
+        """Creates a triple pattern matching rule for [S, P, O] with a half-open
+        value range [low, high) on the object, returning results in reverse
+        (descending) object order. Same semantics as triple_slice but iterates
+        from highest to lowest value.
+
+        Parameters
+        ----------
+        sub : str
+            Subject, has to be a node (URI) or variable
+        pred : str
+            Predicate, can be variable (prefix with "v:") or node
+        obj : str
+            Object, can be variable or node or value
+        low : object
+            The inclusive lower bound as a typed value
+        high : object
+            The exclusive upper bound as a typed value
+
+        Returns
+        -------
+        WOQLQuery object
+            query object that can be chained and/or execute
+        """
+        if self._cursor.get("@type"):
+            self._wrap_cursor_with_and()
+        self._cursor["@type"] = "TripleSliceRev"
+        self._cursor["subject"] = self._clean_subject(sub)
+        self._cursor["predicate"] = self._clean_predicate(pred)
+        self._cursor["object"] = self._clean_object(obj)
+        self._cursor["low"] = self._clean_object(low)
+        self._cursor["high"] = self._clean_object(high)
+        return self
+
+    def quad_slice_rev(self, sub, pred, obj, low, high, graph):
+        """Creates a triple pattern matching rule for [S, P, O, G] with a half-open
+        value range [low, high) on the object in reverse order, with an explicit
+        graph selector.
+
+        Parameters
+        ----------
+        sub : str
+            Subject, has to be a node (URI) or variable
+        pred : str
+            Predicate, can be variable (prefix with "v:") or node
+        obj : str
+            Object, can be variable or node or value
+        low : object
+            The inclusive lower bound as a typed value
+        high : object
+            The exclusive upper bound as a typed value
+        graph : str
+            Graph resource identifier (e.g. 'instance' or 'schema')
+
+        Returns
+        -------
+        WOQLQuery object
+            query object that can be chained and/or execute
+        """
+        self.triple_slice_rev(sub, pred, obj, low, high)
+        self._cursor["graph"] = self._clean_graph(graph)
+        return self
+
     def triple_next(self, sub, pred, obj, next_val):
         """Finds the next object value after a reference for a given subject-predicate pair.
         When object is bound and next is free, finds the smallest next > object.