kisa-utils 0.37.16__py3-none-any.whl → 0.37.18__py3-none-any.whl

kisa_utils/db.py

@@ -11,6 +11,9 @@ from threading import get_native_id as getCurrentThreadId, Lock
 from . import storage
 from . import codes
 from .response import Error, Ok, Response
+from .functionUtils import enforceRequirements, Definition
+from .structures.utils import Value
+from . import structures
 
 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}')
@@ -1171,6 +1174,62 @@ def transaction(*dbArgs, **dbKwargs) -> dict|Response:
         return wrapper
     return handler
 
+class Column:
+    @enforceRequirements
+    def __init__(
+        self, 
+        name: Value(str, lambda n: Ok() if n and ' ' not in n and not n[0].isdigit() else Error('invalid column name given')),
+        dataType: type, # int|float|bytes|list|dict|tuple, 
+                        # bytes=blob, list|dict|tuple=JSON
+        /,
+        *,
+        validator: Value|None = None, # must take 1 argument and return a 
+                                      # kisa_utils.response.Response object
+        required:bool = False,
+        maxSize:int = -1, # -1=unlimited. for ;
+                          #     strings,JSON:list|tuple|dict,bytes: maxSize=`len`
+                          #     int,float: maxSize=maxValue
+        unique:bool = False,
+        isPrimaryKey:bool = False,
+        trackChanges: bool = False, # if set to True, all changes/updates 
+                                    # along with their timestamps will be logged
+                                    # all changes will be stored in a special 
+                                    # table in the database. the very first insert
+                                    # will trigger a log as well if trackChanges is
+                                    # set to `True`
+        # z:Callable|None = None
+    ) -> None:
+        '''
+        create a column definition/instance
+        '''
+        ...
+
+class Table:
+    @enforceRequirements
+    def __init__(
+        self,
+        name: Value(str, lambda n: Ok() if (n and ' ' not in n and not n[0].isdigit()) else Error('invalid column name given')),
+        /,
+        *,
+        trackChanges: bool = False, # if set to True, all changes/updates 
+                                    # along with their timestamps will be logged
+                                    # all changes will be stored in a special 
+                                    # table in the database. the very first insert
+                                    # will trigger a log as well if trackChanges is
+                                    # set to `True`
+
+        # onInsert:Callable|None=None,
+        # onDelete:Callable|None=None,
+        # onUpdate:Callable|None=None,
+    ) -> None:
+        '''
+        create a table definition
+        '''
+        pass
+
+# ------------------------------------------------------------------------------
 if __name__=='__main__':
+    # Column('ab', int)
+
     with Api('/tmp/bukman/database.db2') as handle:
         print(handle.fetch('keys',['*'],'',[]))

kisa_utils/functionUtils.py

@@ -6,11 +6,14 @@ from kisa_utils.response import Response, Ok, Error
 from kisa_utils.storage import Path
 from kisa_utils.structures.validator import Value, validateWithResponse
 import copy
-from typing import Any, get_args, Callable
+from typing import Any, get_args, Callable, Generic, ParamSpec, TypeVar
 
-class Definition:
+P = ParamSpec('P')
+T = TypeVar('T')
+
+class Definition(Generic[T]):
     @staticmethod
-    def __class_getitem__(structure:Any) -> Any:
+    def __class_getitem__(structure:type[T]) -> Any:
         return structure
 
 def private(func:Callable) -> Callable:
@@ -60,9 +63,6 @@ def protected(func:Callable) -> Callable:
     return wrapper
 
 # ------------------------------------------------------------------------------
-from typing import ParamSpec, TypeVar
-P = ParamSpec('P')
-T = TypeVar('T')
 
 def enforceRequirements(func:Callable[P, T]) -> Callable[P, T]:
     '''

kisa_utils/structures/utils.py

@@ -1,11 +1,21 @@
 import inspect
 import typing
-from typing import Any, Callable, get_origin
+from typing import Any, Callable, get_origin, Generic, overload
 from types import UnionType
 from kisa_utils.response import Response
 
-class Value:
-    def __init__(self, valueType:Any, validator:Callable,/) -> None:
+from typing import ParamSpec, TypeVar, Type
+P = ParamSpec('P')
+T = TypeVar('T')
+
+class Value(Generic[T]):
+    @overload
+    def __init__(self, valueType:Type[T], validator:Callable[[T], Response],/) -> None: ...
+
+    @overload
+    def __init__(self, valueType:Type[T] | TypeVar, validator:Callable[[T], Response],/) -> None: ...
+
+    def __init__(self, valueType, validator, /) -> None:
         '''
         create a value definition to be used by `kisa_utils.structures.validator.validate`
 
@@ -70,4 +80,4 @@ class Value:
         return _type 
 
     def __str__(self) -> str:  return self.__name__
-    def __repr__(self) -> str:  return self.__name__
+    def __repr__(self) -> str:  return self.__name__

{kisa_utils-0.37.16.dist-info → kisa_utils-0.37.18.dist-info}/METADATA

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

{kisa_utils-0.37.16.dist-info → kisa_utils-0.37.18.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=tv3cvKhOu0NQ3NeykkJlhqJBFM-wQcLIxWZc8lsocCg,46485
+kisa_utils/db.py,sha256=QH9nvwc3Lr-NyUA-47Rae-s2xeMIE6m2rNGozcpr2jg,48950
 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=PlXjnmU1uJWNdISlJJ3SCgavTsgNBoebaa9dtWSFhRA,6553
+kisa_utils/functionUtils.py,sha256=I33ZeDNcQsumhgWyFWodj0D3RKkwfiUFZfCGwmAkDYo,6561
 kisa_utils/log.py,sha256=0TYdxcIBts026RCSuVIQBcZ-CW1ES7n3M1nEIjmeLTM,2295
 kisa_utils/queues.py,sha256=9QqPtDujw6tbWk7uUiXrsd0rVBTIkzeQw9b45l5Fo3k,6502
 kisa_utils/remote.py,sha256=0RDrfC4RUW4m6JLziC0_EXJYqzWp38Rw8NDroJ0MuqI,2149
@@ -21,9 +21,9 @@ kisa_utils/permissions/__init__.py,sha256=q7LGl26f-MPXkLS6nxBKDotW3xdB8y7pI5S_Oo
 kisa_utils/servers/__init__.py,sha256=lPqDyGTrFo0qwPZ2WA9Xtcpc5D8AIU4huqgFx1iZf68,19
 kisa_utils/servers/flask.py,sha256=o76cJKlQ3L8EOVdHUF092qwoAZMzgttuLt0mMhtCsGI,40085
 kisa_utils/structures/__init__.py,sha256=JBU1j3A42jQ62ALKnsS1Hav9YXcYwjDw1wQJtohXPbU,83
-kisa_utils/structures/utils.py,sha256=l56NQiPVcFijpuLqt2n9ZwnVKT4XzK6oknRVallRzwQ,2573
+kisa_utils/structures/utils.py,sha256=665rXIapGwFqejizeJwy3DryeskCQOdgP25BCdLkGvk,2898
 kisa_utils/structures/validator.py,sha256=Y4UmB4TH7N-GkK22EV1WOsPWjTeqxVWLTentl1keZD4,4053
-kisa_utils-0.37.16.dist-info/METADATA,sha256=LERWYuPWHT0mNh8bCpHawI1uS3ebvczXyMdsfdzMMVI,478
-kisa_utils-0.37.16.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-kisa_utils-0.37.16.dist-info/top_level.txt,sha256=URxY4sRuqmirOxWtztpVmPoGQdksEMYO6hmYsEDGz2Y,75
-kisa_utils-0.37.16.dist-info/RECORD,,
+kisa_utils-0.37.18.dist-info/METADATA,sha256=gTcrLt0Vr8OPx_6bCHDe_Zs0sAh2hqlriAeJg41LFGA,478
+kisa_utils-0.37.18.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+kisa_utils-0.37.18.dist-info/top_level.txt,sha256=URxY4sRuqmirOxWtztpVmPoGQdksEMYO6hmYsEDGz2Y,75
+kisa_utils-0.37.18.dist-info/RECORD,,