kisa-utils 0.37.8__py3-none-any.whl → 0.37.10__py3-none-any.whl

kisa_utils/db.py

@@ -15,6 +15,7 @@ if sqlite3.sqlite_version_info[1]<38:
     sys.exit(f'we need sqlite3 v3.38.0+ to run this program. current version::{sqlite3.sqlite_version}')
 
 MAX_FETCH_ITEMS = 16*1024
+RETURN_KISA_RESPONSES = False # ensure all Handles return KISA-Responses globally
 
 __EXT__ = 'sqlite3'
 
@@ -98,7 +99,7 @@ class Api:
         *,
         accessFromMultipleThreads:bool = False,
         useWALMode:bool = False,
-        returnKISAResponse:bool = False,
+        returnKISAResponse:bool|None = None,
     ):
         '''
         attempt to open an sqlite3 database connection object/instance
@@ -159,7 +160,7 @@ class Api:
 
             accessFromMultipleThreads(bool): if set to `True`, access to the handle from difference threads will be permitted
             useWALMode(bool): if set to `True`, WAL mode will be used for the underlying sqlite3 database
-            returnKISAResponse(bool): if set to `True`, all public methods that dont return `None` will return KISA Response objects            
+            returnKISAResponse(bool|None): if not set, `kisa_utils.db.RETURN_KISA_RESPONSES` will be used. if set to `True`, all public methods that dont return `None` will return KISA Response objects
         '''
 
         self._in_with_statement = False
@@ -169,7 +170,7 @@ class Api:
         
         self.__transactionMode = True if transactionMode else False
         self.__withContextCount = 0
-        self.__returnKISAResponse = returnKISAResponse
+        self.__returnKISAResponse = RETURN_KISA_RESPONSES if None==returnKISAResponse else returnKISAResponse
 
         if  path not in [':memory:', ':ram:',':RAM:']:
             while path.endswith('/'): path = path[:-1]
@@ -1052,7 +1053,7 @@ def transaction(*dbArgs, **dbKwargs) -> dict|Response:
     + `indices:dict` = {False}
     + `accessFromMultipleThreads:bool` = False
     + `useWALMode:bool` = False
-    + `returnKISAResponse:bool` = False
+    + `returnKISAResponse:bool|None` = None | kisa_utils.db.RETURN_KISA_RESPONSES
 
     NB: the exact ordering and naming of `dbArgs` and `dbKwargs` should ALWAYS be got from Api/Handle
     

kisa_utils/functionUtils.py

@@ -59,7 +59,12 @@ def protected(func:Callable) -> Callable:
         return func(*args, **kwargs)
     return wrapper
 
-def enforceRequirements(func:Callable) -> Callable:
+# ------------------------------------------------------------------------------
+from typing import ParamSpec, TypeVar
+P = ParamSpec('P')
+T = TypeVar('T')
+
+def enforceRequirements(func:Callable[P, T]) -> Callable[P, T]:
     '''
     force decorated function to observe the following
     - have type hints for all `args`, and `kwargs` as well as the `return` type-hint
@@ -68,9 +73,9 @@ def enforceRequirements(func:Callable) -> Callable:
     - ensure all arguments are given values of the right type when the function is called
     - return the right data-type as specified by the return type-hint when invoked
     '''
+    signature = inspect.signature(func)
+    typeHints = func.__annotations__
     if 1:
-        signature = inspect.signature(func)
-        typeHints = func.__annotations__
         parameters = signature.parameters
 
         if not (func.__doc__ and func.__doc__.strip()):
@@ -118,7 +123,7 @@ def enforceRequirements(func:Callable) -> Callable:
         # print(registeredArgs, registeredKwargs)
 
     @wraps(func)
-    def w(*args, **kwargs):
+    def w(*args:P.args, **kwargs:P.kwargs):
         for index, arg in enumerate(args):
             if registeredArgs[index][0] in ['self']: continue
             if not (resp := validateWithResponse(arg, registeredArgs[index][1])):

{kisa_utils-0.37.8.dist-info → kisa_utils-0.37.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kisa-utils
-Version: 0.37.8
+Version: 0.37.10
 Summary: Utility functions and modules for KISA Developers
 Author: Tom Bukenya
 Author-email: glayn2bukman@gmail.com

{kisa_utils-0.37.8.dist-info → kisa_utils-0.37.10.dist-info}/RECORD

@@ -3,11 +3,11 @@ kisa_utils/cache.py,sha256=4Ue5G3QhHSQAmIfQKYgWKWjNL4rA4wLLd_RdBLb2ABY,7345
 kisa_utils/codes.py,sha256=PV_S53Skggf4XetOdYoIKtEmM8cpN5wZwUlxje70WZY,904
 kisa_utils/config.py,sha256=NfluzGKTh66qfNtC-Ae0zNb1XzMTgU2Me9Vi82R9c1E,2285
 kisa_utils/dates.py,sha256=kcNqoY_iguG9hSzABMIBqeL3MGz3n4MRIXuW4OxRHLs,12662
-kisa_utils/db.py,sha256=Mv9BcHydRZZHE_ONbNPhGiezqVYXuILXct6qBZhgrdU,44223
+kisa_utils/db.py,sha256=gU6BSBSglrndUMhmhOmIEVNXKSiRV6vqf2pskJKYmlQ,44463
 kisa_utils/encryption.py,sha256=nFzNpzWV_D9uSEq4FsgCnlS7FQtqWP9fvM_81rsfcLo,4218
 kisa_utils/enqueue.py,sha256=VIliaMvw4MUdOqts0dXdZCYNxs-QrOVjIRAR3scGrRM,11786
 kisa_utils/figures.py,sha256=pYIpQzu1OXRSsY1d98GhgPifnIRmgl-r7S32ai-Ms0c,3731
-kisa_utils/functionUtils.py,sha256=BV1HMkALLbBM-n-7qCFZ1u2qzITRBA8WQZK9B3nOTUE,6246
+kisa_utils/functionUtils.py,sha256=5Xu-ixV5S7sVBrr1ZhIOrLPVVCbvU-EOAX7i46Mzwdc,6422
 kisa_utils/log.py,sha256=0TYdxcIBts026RCSuVIQBcZ-CW1ES7n3M1nEIjmeLTM,2295
 kisa_utils/queues.py,sha256=9QqPtDujw6tbWk7uUiXrsd0rVBTIkzeQw9b45l5Fo3k,6502
 kisa_utils/remote.py,sha256=0RDrfC4RUW4m6JLziC0_EXJYqzWp38Rw8NDroJ0MuqI,2149
@@ -23,7 +23,7 @@ kisa_utils/servers/flask.py,sha256=o76cJKlQ3L8EOVdHUF092qwoAZMzgttuLt0mMhtCsGI,4
 kisa_utils/structures/__init__.py,sha256=JBU1j3A42jQ62ALKnsS1Hav9YXcYwjDw1wQJtohXPbU,83
 kisa_utils/structures/utils.py,sha256=l56NQiPVcFijpuLqt2n9ZwnVKT4XzK6oknRVallRzwQ,2573
 kisa_utils/structures/validator.py,sha256=Y4UmB4TH7N-GkK22EV1WOsPWjTeqxVWLTentl1keZD4,4053
-kisa_utils-0.37.8.dist-info/METADATA,sha256=hYf3YtnDHzuO47WJ4ED_xBZpwiNvKc0xYHdPUmr9ihY,477
-kisa_utils-0.37.8.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-kisa_utils-0.37.8.dist-info/top_level.txt,sha256=URxY4sRuqmirOxWtztpVmPoGQdksEMYO6hmYsEDGz2Y,75
-kisa_utils-0.37.8.dist-info/RECORD,,
+kisa_utils-0.37.10.dist-info/METADATA,sha256=pfh6GQFbwBdENr7T8xWvntPceW2jy1o-G4X1eqsaT-U,478
+kisa_utils-0.37.10.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+kisa_utils-0.37.10.dist-info/top_level.txt,sha256=URxY4sRuqmirOxWtztpVmPoGQdksEMYO6hmYsEDGz2Y,75
+kisa_utils-0.37.10.dist-info/RECORD,,