deprication warning

src/caosdb/apiutils.py

@@ -31,6 +31,7 @@ Some simplified functions for generation of records etc.
 import sys
 import tempfile
 from collections.abc import Iterable
+import warnings
 from subprocess import call
 
 from caosdb.common.datatype import (BOOLEAN, DATETIME, DOUBLE, FILE, INTEGER,
@@ -85,6 +86,34 @@ def new_record(record_type, name=None, description=None,
     return r
 
 
+def id_query(ids):
+    warnings.warn("Please use 'create_id_query', which only creates"
+                  "the string.", DeprecationWarning)
+
+    return execute_query(create_id_query(ids))
+
+
+def create_id_query(ids):
+    return "FIND ENTITY WITH " + " OR ".join(
+        ["ID={}".format(id) for id in ids])
+
+
+def retrieve_entity_with_id(eid):
+    return execute_query("FIND ENTITY WITH ID={}".format(eid), unique=True)
+
+
+def retrieve_entities_with_ids(entities):
+    collection = Container()
+    step = 20
+
+    for i in range(len(entities)//step+1):
+        collection.extend(
+            execute_query(
+               create_id_query(entities[i*step:(i+1)*step])))
+
+    return collection
+
+
 def get_type_of_entity_with(id_):
     objs = retrieve_entities_with_ids([id_])
 
@@ -693,27 +722,6 @@ def _apply_to_ids_of_entity(entity, func):
                     prop.value = func(prop.value)
 
 
-def create_id_query(ids):
-    return "FIND ENTITY WITH " + " OR ".join(
-        ["ID={}".format(id) for id in ids])
-
-
-def retrieve_entity_with_id(eid):
-    return execute_query("FIND ENTITY WITH ID={}".format(eid), unique=True)
-
-
-def retrieve_entities_with_ids(entities):
-    collection = Container()
-    step = 20
-
-    for i in range(len(entities)//step+1):
-        collection.extend(
-            execute_query(
-               create_id_query(entities[i*step:(i+1)*step])))
-
-    return collection
-
-
 def resolve_reference(prop):
     """resolves the value of a reference property