kisa-utils 0.37.20__py3-none-any.whl → 0.39.0__py3-none-any.whl

kisa_utils/dates.py

@@ -170,6 +170,20 @@ def dateFrom(date:str, days:int, hours:int=0) -> str:
     _date = datetime.datetime.strptime(date, '%Y-%m-%d')
     return str(_date + datetime.timedelta(days=days, hours=hours))[:10]
 
+def TimeFrom(timestamp:str, days:int=0, hours:int=0, minutes:int=0, seconds:int=0) -> str:
+    '''
+    get the time thats `days` + `hours` + `minutes` + `seconds` from `timestamp`
+    Args:
+        timestamp(str): the reference timestamp to use, format is `YYYY-MM-DD HH:MM:SS`
+        days(int): days from the reference timestamp
+        hours(int): hours to include to the days to ge tthe new date
+        minutes(int): minutes to include to the days to ge the new date
+        seconds(int): seconds to include to the days to ge the new date
+        ```
+    '''
+    _tstamp = datetime.datetime.strptime(timestamp, '%Y-%m-%d %H:%M:%S')
+    return str(_tstamp + datetime.timedelta(days=days, hours=hours, minutes=minutes, seconds=seconds))
+
 def dateFromNow(days=0,hours=0) -> str:
     '''
     get the timestamp(not date) thats `days` + `hours` from the current time
@@ -186,6 +200,20 @@ def dateFromNow(days=0,hours=0) -> str:
     now = datetime.datetime.utcnow() + datetime.timedelta(hours=3.00)
     return str(now+datetime.timedelta(days=days, hours=hours))[:19]
 
+def TimeFromNow(days:int=0, hours:int=0, minutes:int=0, seconds:int=0) -> str:
+    '''
+    get the time thats `days` + `hours` + `minutes` + `seconds` from `timestamp`
+    Args:
+        days(int): days from the reference timestamp
+        hours(int): hours to include to the days to ge tthe new date
+        minutes(int): minutes to include to the days to ge the new date
+        seconds(int): seconds to include to the days to ge the new date
+        ```
+    '''
+    timestamp = currentTimestamp()
+    return TimeFrom(timestamp, days, hours, minutes, seconds)
+
+
 # thanks to airtel & MTN strange date formats, we have this
 def standardizedDate(date:str, fmt:str=''):
     '''

kisa_utils/db.py

@@ -955,11 +955,10 @@ class Api:
             reply['log'] = 'database not open'
             return reply if not self.__returnKISAResponse else Error(reply['log'])
 
-        if self.__withContextCount > 1:
+        if not self.inTopLevelContext:
             reply['log'] = 'can not commit transaction in non top-level context'
             return reply if not self.__returnKISAResponse else Error(reply['log'])
 
-
         for op in self.__transactionData:
             if self.__transactionData[op]['failed']:
                 reply['log'] = f'{self.__transactionData[op]["failed"]} `{op}` operation(s) returned a `False` status'
@@ -1103,6 +1102,14 @@ class Api:
     def __bool__(self)->bool:
         return self.isOpen
 
+    @property
+    def inTopLevelContext(self) -> bool:
+        '''
+        check if the opened db-handle is in the top-most `with` context. 
+        If it is, then its okay to commit a transaction
+        '''
+        return self.__withContextCount <= 1
+
 Handle = Api
 
 def transaction(*dbArgs, **dbKwargs) -> dict|Response:

{kisa_utils-0.37.20.dist-info → kisa_utils-0.39.0.dist-info}/METADATA

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

{kisa_utils-0.37.20.dist-info → kisa_utils-0.39.0.dist-info}/RECORD

@@ -2,8 +2,8 @@ kisa_utils/__init__.py,sha256=iXjGTol3UxJkh_cyISYEAY_yWC5ZlNvIRXFuuiHx76Q,621
 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=QH9nvwc3Lr-NyUA-47Rae-s2xeMIE6m2rNGozcpr2jg,48950
+kisa_utils/dates.py,sha256=zxe4n0PdKReZjK5ZkvnCZtJ55lk5oqu9oS8VX_nLozw,13966
+kisa_utils/db.py,sha256=tVNMV-hc-oPxR4iRSX-d82Gi4fQwI5Cga1eP8SLvHFs,49202
 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
@@ -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=665rXIapGwFqejizeJwy3DryeskCQOdgP25BCdLkGvk,2898
 kisa_utils/structures/validator.py,sha256=Y4UmB4TH7N-GkK22EV1WOsPWjTeqxVWLTentl1keZD4,4053
-kisa_utils-0.37.20.dist-info/METADATA,sha256=01cNCPOuqmY6hTmZ3KYeOqf3XkVDSi8GyvQRdyigNSY,478
-kisa_utils-0.37.20.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-kisa_utils-0.37.20.dist-info/top_level.txt,sha256=URxY4sRuqmirOxWtztpVmPoGQdksEMYO6hmYsEDGz2Y,75
-kisa_utils-0.37.20.dist-info/RECORD,,
+kisa_utils-0.39.0.dist-info/METADATA,sha256=M6VVyZ0NOG7urg1fPt48fHuxc85qD0keInyLNBq4LQY,477
+kisa_utils-0.39.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+kisa_utils-0.39.0.dist-info/top_level.txt,sha256=URxY4sRuqmirOxWtztpVmPoGQdksEMYO6hmYsEDGz2Y,75
+kisa_utils-0.39.0.dist-info/RECORD,,