kisa-utils 0.42.16__py3-none-any.whl → 0.43.1__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/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.16.dist-info → kisa_utils-0.43.1.dist-info}/METADATA

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

{kisa_utils-0.42.16.dist-info → kisa_utils-0.43.1.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
@@ -11,6 +11,7 @@ kisa_utils/functionUtils.py,sha256=PlXjnmU1uJWNdISlJJ3SCgavTsgNBoebaa9dtWSFhRA,6
 kisa_utils/log.py,sha256=0TYdxcIBts026RCSuVIQBcZ-CW1ES7n3M1nEIjmeLTM,2295
 kisa_utils/remote.py,sha256=z5QTKC0Mb_wMWVHWfUHR1XOOek-A2fNjo1GyFPhAB8s,2373
 kisa_utils/response.py,sha256=asETUBkeF5OlSTwa-coa7lZDCKmQlHCmHf6eaZFl8CU,4560
+kisa_utils/score.py,sha256=li4NG6sZlzbcXrnxrZZRamiyvRtlKxt5ZJ46QER6BiQ,2005
 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.16.dist-info/METADATA,sha256=QpmdDDEFdlFivDSSUJHi96YMgxbauPELUz7BD8DO4Zk,478
-kisa_utils-0.42.16.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-kisa_utils-0.42.16.dist-info/top_level.txt,sha256=GFOLXZYqpBG9xtscGa2uGJAEiZ5NwsqHBH9NylnB29M,11
-kisa_utils-0.42.16.dist-info/RECORD,,
+kisa_utils-0.43.1.dist-info/METADATA,sha256=luP5gb2UHCEqyQJwmf_8dVIYx4b5vlyKZMEJUydIi3w,477
+kisa_utils-0.43.1.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+kisa_utils-0.43.1.dist-info/top_level.txt,sha256=GFOLXZYqpBG9xtscGa2uGJAEiZ5NwsqHBH9NylnB29M,11
+kisa_utils-0.43.1.dist-info/RECORD,,