GG-32601 [IGNITE-11528]: Deprecate SqlQuery API (#15)

(cherry picked from commit d7d6d35)

Author: isapego

pygridgain/api/sql.py

@@ -13,10 +13,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-"""
-Only key-value queries (scan queries) are implemented. SQL part is still
-in progress.
-"""
 
 from typing import Union
 
@@ -28,7 +24,7 @@
 from pygridgain.datatypes.sql import StatementType
 from pygridgain.queries import Query
 from pygridgain.queries.op_codes import *
-from pygridgain.utils import cache_id
+from pygridgain.utils import cache_id, deprecated
 from .result import APIResult
 
 
@@ -142,6 +138,8 @@ def scan_cursor_get_page(
     return result
 
 
+@deprecated(version='1.2.0', reason="This API is deprecated and will be removed in the following major release. "
+                                    "Use sql_fields instead")
 def sql(
     conn: 'Connection', cache: Union[str, int],
     table_name: str, query_str: str, page_size: int, query_args=None,
@@ -227,6 +225,8 @@ def sql(
     return result
 
 
+@deprecated(version='1.2.0', reason="This API is deprecated and will be removed in the following major release. "
+                                    "Use sql_fields instead")
 def sql_cursor_get_page(
     conn: 'Connection', cursor: int, query_id: int = None,
 ) -> APIResult:

pygridgain/utils.py

@@ -15,6 +15,8 @@
 #
 import ctypes
 import decimal
+import warnings
+
 from functools import wraps
 from threading import Event, Thread
 from typing import Any, Callable, Optional, Type, Tuple, Union
@@ -312,3 +314,13 @@ def process_delimiter(name: str, delimiter: str) -> str:
     Splits the name by delimiter, capitalize each part, merge.
     """
     return ''.join([capitalize(x) for x in name.split(delimiter)])
+
+
+def deprecated(version, reason):
+    def decorator_deprecated(fn):
+        @wraps(fn)
+        def wrapper_deprecated(*args, **kwds):
+            warnings.warn(f'Deprecated since {version}. The reason: {reason}', category=DeprecationWarning)
+            return fn(*args, **kwds)
+        return wrapper_deprecated
+    return decorator_deprecated