kisa-utils 0.42.15__py3-none-any.whl → 0.43.0__py3-none-any.whl

kisa_utils/__init__.py

@@ -21,3 +21,5 @@ from kisa_utils import dataStructures
 
 from kisa_utils import queues
 from kisa_utils.queues.callables import enqueueFunctionCalls
+
+from kisa_utils import score

kisa_utils/remote.py

@@ -1,6 +1,7 @@
 import requests
+from kisa_utils.dataStructures import KDict
 
-def sendRequest(url:str|bytes, method:str|bytes='post', jsonPayload:dict={}, timeout:int=180, **requestKwargs:dict) -> dict:
+def sendRequest(url:str|bytes, method:str|bytes='post', jsonPayload:dict={}, timeout:int=180, **requestKwargs:dict) -> KDict:
     '''
     attempt to send request with JSON payload.
     Args:
@@ -23,7 +24,7 @@ def sendRequest(url:str|bytes, method:str|bytes='post', jsonPayload:dict={}, tim
     @return {'status':BOOL, 'log':STR, }
     '''
 
-    reply = {'status':False, 'log':'', 'response':None}
+    reply = KDict({'status':False, 'log':'', 'response':None, 'statusCode': None})
 
     method = method.lower()
     if method not in ['get','post']:
@@ -39,6 +40,8 @@ def sendRequest(url:str|bytes, method:str|bytes='post', jsonPayload:dict={}, tim
             reply['log'] = 'invalid method given'
             return reply
 
+        reply.statusCode = response.status_code
+
         if response.status_code!=200:
             try: reply['response'] = response.json()
             except: pass
@@ -48,11 +51,11 @@ def sendRequest(url:str|bytes, method:str|bytes='post', jsonPayload:dict={}, tim
 
         try:
             responseJSON = response.json()
-            reply['response'] = responseJSON
+            reply['response'] = KDict(responseJSON) if isinstance(responseJSON, dict) else responseJSON
             reply['status'] = True
             return reply
-        except:
-            reply['log'] = 'no JSON reply got'
+        except Exception as e:
+            reply['log'] = f'no JSON reply got: {e}'
             return reply
             
     except requests.exceptions.Timeout:

kisa_utils/score.py

@@ -0,0 +1,55 @@
+import itertools
+import difflib
+from kisa_utils.functionUtils import enforceRequirements
+
+def __removeNonAlpha(name:str)->str:
+    return ''.join([xter for xter in name if xter.isalpha() or ' '==xter])
+
+def __getCommonCase(name:str)->str:
+    return name.upper()
+
+def __getPermutations(names:list[str], itemsPerResult:int=-1) -> list[str]:
+    if -1== itemsPerResult:
+        return [''.join(p) for p in itertools.permutations(names)]
+
+    results = []
+    for nameCombination in itertools.combinations(names, itemsPerResult):
+        results += [''.join(p) for p in itertools.permutations(nameCombination)]
+
+    return results
+
+@enforceRequirements
+def getNamesMatchScore(namesA:str, namesB:str, /) -> float:
+    '''
+    Arguments:
+        namesA(str): first set of names eg 'John Doe'
+        namesB(str): second set of names eg 'Jane Doe'
+    Returns:
+        score is in range 0.0 - 100.0
+    '''
+    score:float = 0.0
+    if not (namesA and namesB): return score
+
+    # print(f'original: `{namesA}` <-> `{namesB}`')
+    namesA, namesB = __getCommonCase(namesA), __getCommonCase(namesB)
+    namesA, namesB = __removeNonAlpha(namesA), __removeNonAlpha(namesB)
+
+    namesListA, namesListB = [n for n in namesA.split(' ') if n], [n for n in namesB.split(' ') if n]
+    namesListA.sort(); namesListB.sort()
+
+    if not (len(namesListA)>1 and len(namesListB)>1): return score
+
+    # print(f'cleaned: `{" ".join(namesListA)}` <-> `{" ".join(namesListB)}`')
+
+    if namesListA == namesListB: return 100.0
+
+    leastNameCount = min(len(namesListA), len(namesListB))
+
+    for permutationA in __getPermutations(namesListA, itemsPerResult=leastNameCount):
+        for permutationB in __getPermutations(namesListB, itemsPerResult=leastNameCount):
+            if (_score := difflib.SequenceMatcher(None, permutationA, permutationB).ratio()*100) > score:
+                print(f'    {permutationA}, {permutationB}')
+                score = _score
+                if 100.0 == score: return score
+
+    return score

{kisa_utils-0.42.15.dist-info → kisa_utils-0.43.0.dist-info}/METADATA

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

{kisa_utils-0.42.15.dist-info → kisa_utils-0.43.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kisa_utils/__init__.py,sha256=-g5gBmI4gV840-Brg1V1aZ_R_r3n_csB-PlRRdUV_UQ,745
+kisa_utils/__init__.py,sha256=7zgEMAjPO7gJ98ob-psV7xGciG94jN5BcissMZMh4lk,774
 kisa_utils/cache.py,sha256=WOL3e0wvoyESXTtlbVnUg9TYUoLzg64sLP9J4b4ti9k,7377
 kisa_utils/codes.py,sha256=PV_S53Skggf4XetOdYoIKtEmM8cpN5wZwUlxje70WZY,904
 kisa_utils/config.py,sha256=vfwka6Wuz80su6_GgjuKhxolnzj1enw8cpgQPYm17l8,2357
@@ -9,8 +9,9 @@ kisa_utils/encryption.py,sha256=nFzNpzWV_D9uSEq4FsgCnlS7FQtqWP9fvM_81rsfcLo,4218
 kisa_utils/figures.py,sha256=pYIpQzu1OXRSsY1d98GhgPifnIRmgl-r7S32ai-Ms0c,3731
 kisa_utils/functionUtils.py,sha256=PlXjnmU1uJWNdISlJJ3SCgavTsgNBoebaa9dtWSFhRA,6553
 kisa_utils/log.py,sha256=0TYdxcIBts026RCSuVIQBcZ-CW1ES7n3M1nEIjmeLTM,2295
-kisa_utils/remote.py,sha256=e6Ho78Lc1hd1PO_NrDydo4ssP1GQCyBGAImJn-s6rPs,2172
+kisa_utils/remote.py,sha256=z5QTKC0Mb_wMWVHWfUHR1XOOek-A2fNjo1GyFPhAB8s,2373
 kisa_utils/response.py,sha256=asETUBkeF5OlSTwa-coa7lZDCKmQlHCmHf6eaZFl8CU,4560
+kisa_utils/score.py,sha256=sulT7dvBoE_6upvbfjfWCMoC5Fn4wBhRU3aG5_uNFvE,2003
 kisa_utils/standardize.py,sha256=nt-uzHQFoKxGscD_MpDYXw65Teg3724whAqa6Kh_zhE,2231
 kisa_utils/storage.py,sha256=6NdEVrHMS7WB_vmCwiGigIinu-EjxalFJhk1kj-_vWs,5990
 kisa_utils/threads.py,sha256=PstMHimkOABXlYmKJi5SHcevzm1JuFGNZSlF0bGzuGk,13137
@@ -27,7 +28,7 @@ kisa_utils/servers/flask.py,sha256=XZYY1pWnP1mSvaS5Uv8G3EFJV5BJBQtU2gDbO8suvLc,4
 kisa_utils/structures/__init__.py,sha256=JBU1j3A42jQ62ALKnsS1Hav9YXcYwjDw1wQJtohXPbU,83
 kisa_utils/structures/utils.py,sha256=665rXIapGwFqejizeJwy3DryeskCQOdgP25BCdLkGvk,2898
 kisa_utils/structures/validator.py,sha256=oCSgY_itst6bZdC5g8yVU4-lSH2xnUsOx3X-oPyV7nA,4626
-kisa_utils-0.42.15.dist-info/METADATA,sha256=YWPQ2Fm5D9WgRSfjb6o98jEQUC67jO7bMYCYh3txk14,478
-kisa_utils-0.42.15.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-kisa_utils-0.42.15.dist-info/top_level.txt,sha256=GFOLXZYqpBG9xtscGa2uGJAEiZ5NwsqHBH9NylnB29M,11
-kisa_utils-0.42.15.dist-info/RECORD,,
+kisa_utils-0.43.0.dist-info/METADATA,sha256=uf_VNnKZPbGRL-tBOhaOf2LN14-akvvmuIppr99dYuQ,477
+kisa_utils-0.43.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+kisa_utils-0.43.0.dist-info/top_level.txt,sha256=GFOLXZYqpBG9xtscGa2uGJAEiZ5NwsqHBH9NylnB29M,11
+kisa_utils-0.43.0.dist-info/RECORD,,