kevin-toolbox-dev 1.0.10b0__py3-none-any.whl → 1.0.12__py3-none-any.whl

kevin_toolbox/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.0.10b"
+__version__ = "1.0.12"
 
 
 import os
@@ -12,5 +12,5 @@ os.system(
 os.system(
     f'python {os.path.split(__file__)[0]}/env_info/check_validity_and_uninstall.py '
     f'--package_name kevin-toolbox-dev '
-    f'--expiration_timestamp 1701361536 --verbose 0'
+    f'--expiration_timestamp 1702197528 --verbose 0'
 )

kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/test_get_subset_with_largest_product.py

@@ -2,7 +2,7 @@ import pytest
 import numpy as np
 from kevin_toolbox.patches.for_test import check_consistency
 from kevin_toolbox.computer_science.algorithm.combinatorial_optimization import get_subset_with_largest_product
-from kevin_toolbox.computer_science.algorithm.utils.for_seq import get_subsets
+from kevin_toolbox.computer_science.algorithm.for_seq import get_subsets
 
 
 def test_get_subset_with_largest_product():

kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/test_zero_one_knapsack_problem.py

@@ -2,7 +2,7 @@ import pytest
 import numpy as np
 from kevin_toolbox.patches.for_test import check_consistency
 from kevin_toolbox.computer_science.algorithm.combinatorial_optimization import zero_one_knapsack_problem
-from kevin_toolbox.computer_science.algorithm.utils.for_seq import get_subsets
+from kevin_toolbox.computer_science.algorithm.for_seq import get_subsets
 
 
 def test_zero_one_knapsack_problem():

kevin_toolbox/computer_science/algorithm/for_nested_dict_list/__init__.py

@@ -0,0 +1,6 @@
+from .get_hash import get_hash
+from .traverse import traverse
+from .get_value_by_name import get_value_by_name
+from .set_value_by_name import set_value_by_name
+from .count_leaf_node_nums import count_leaf_node_nums
+from .get_leaf_nodes import get_leaf_nodes

kevin_toolbox/computer_science/algorithm/for_nested_dict_list/count_leaf_node_nums.py

@@ -0,0 +1,21 @@
+from kevin_toolbox.computer_science.algorithm.for_nested_dict_list import traverse
+
+
+def count_leaf_node_nums(var):
+    """
+        获取嵌套字典列表 var 中所有叶节点的数量
+
+        参数：
+            var:                待处理数据
+                                    当 var 不是 dict 或者 list 时，直接将 var 视为根节点，叶节点数量视为 0
+    """
+    nums = 0
+
+    def count(_, __, v):
+        nonlocal nums
+        if not isinstance(v, (list, dict,)):
+            nums += 1
+        return False
+
+    traverse(var=var, match_cond=count, action_mode="skip", b_use_name_as_idx=False)
+    return nums

kevin_toolbox/computer_science/algorithm/for_nested_dict_list/get_leaf_nodes.py

@@ -0,0 +1,22 @@
+from kevin_toolbox.computer_science.algorithm.for_nested_dict_list import traverse
+
+
+def get_leaf_nodes(var):
+    """
+        获取嵌套字典列表 var 中所有叶节点
+            以列表 [(name,value), ...] 形式返回，其中名字 name 的解释方式参考 get_value_by_name() 介绍
+
+        参数：
+            var:                待处理数据
+                                    当 var 不是 dict 或者 list 时，返回空列表
+    """
+    res = []
+
+    def func(_, idx, v):
+        nonlocal res
+        if not isinstance(v, (list, dict,)):
+            res.append((idx, v))
+        return False
+
+    traverse(var=var, match_cond=func, action_mode="skip", b_use_name_as_idx=True)
+    return res

kevin_toolbox/computer_science/algorithm/{utils → for_nested_dict_list}/get_value_by_name.py

@@ -42,8 +42,3 @@ def get_value_by_name(var, name):
             var = var[key]
 
     return var
-
-
-if __name__ == '__main__':
-    print(get_value_by_name(var=dict(acc=[0.66, 0.78, 0.99]), name="|acc|0"))
-    print(get_value_by_name(var=dict(acc=[0.66, 0.78, 0.99]), name="www|acc|0"))

kevin_toolbox/computer_science/algorithm/{utils → for_nested_dict_list}/set_value_by_name.py

@@ -1,12 +1,12 @@
-from kevin_toolbox.computer_science.algorithm.utils import get_value_by_name
+from kevin_toolbox.computer_science.algorithm.for_nested_dict_list import get_value_by_name
 
 
-def set_value_by_name(var, name, value):
+def set_value_by_name(var, name, value, b_force=False):
     """
         通过解释名字得到取值方式，然后到 var 中将对应部分的值修改为 value。
 
         参数：
-            var:            任意支持索引取值的变量
+            var:            任意支持索引赋值的变量
             name:           <string> 取值方式
                                 由多组 "<解释方式><键>" 组成。
                                 解释方式支持以下几种:
@@ -22,6 +22,9 @@ def set_value_by_name(var, name, value):
                                 注意，在 name 的开头也可以添加任意非解释方式的字符，本函数将直接忽略它们，比如下面的:
                                     "var:acc@1" 和 "xxxx|acc|1" 也能正常写入。
             value:          待赋给的值
+            b_force:        <boolean> 当无法设置时，是否尝试创建或者修改节点
+                                默认为 False，
+                                当设置为 True，可能会对 var 的结构产生不可逆的改变，请谨慎使用。新创建或者修改的节点的类型是 dict。
     """
     assert isinstance(name, (str,))
     key = name
@@ -29,21 +32,24 @@ def set_value_by_name(var, name, value):
         key = key.rsplit(char, 1)[-1]
     assert len(key) < len(name), f'invalid name: {name}'
 
-    item = get_value_by_name(var=var, name=name[:-1 - len(key)])
+    try:
+        item = get_value_by_name(var=var, name=name[:-1 - len(key)])
+
+        flag = name[-1 - len(key)]
+        key_t = key
+        if flag == "@":
+            key_t = eval(key)
+        elif flag == "|":
+            try:
+                _ = item[key]
+            except:
+                key_t = eval(key)
+
+        item[key_t] = value
+    except:
+        if not b_force:
+            raise ValueError(f'The location pointed to by name {name} does not exist in var')
+        else:
+            var = set_value_by_name(var=var, name=name[:-1 - len(key)], value={key: value}, b_force=b_force)
 
-    flag = name[-1 - len(key)]
-    if flag == "@":
-        key = eval(key)
-    elif flag == "|":
-        try:
-            _ = item[key]
-        except:
-            key = eval(key)
-
-    item[key] = value
     return var
-
-
-if __name__ == '__main__':
-    print(set_value_by_name(var=dict(acc=[0.66, 0.78, 0.99]), name="|acc|0", value=1))
-    print(set_value_by_name(var=dict(acc=[0.66, 0.78, 0.99]), name="www|acc|0", value=1))

kevin_toolbox/computer_science/algorithm/{utils → for_nested_dict_list}/traverse.py

@@ -1,4 +1,4 @@
-def traverse(var, match_cond, action_mode="remove", converter=None):
+def traverse(var, match_cond, action_mode="remove", converter=None, b_use_name_as_idx=False):
     """
         遍历 var 找到符合 match_cond 的元素，将其按照 action_mode 指定的操作进行处理
 
@@ -9,51 +9,48 @@ def traverse(var, match_cond, action_mode="remove", converter=None):
                                     函数类型为 def(parent_type, idx, value): xxxx
                                     其中：
                                         parent_type     该元素源自哪种结构体，有两个可能传入的值： list，dict
-                                        idx             该元素在结构体中的位置，对于列表是 index，对于字典是 key
+                                        idx             该元素在结构体中的位置
+                                                            当 b_use_name_as_idx=False 时，
+                                                                对于列表是 index，对于字典是 key
+                                                            当为 True 时，传入的是元素在整体结构中的 name 位置，name的格式和含义参考
+                                                                get_value_by_name() 中的介绍
                                         value           元素的值
             action_mode:        <str> 如何对匹配上的元素进行处理
                                     目前支持：
                                         "remove"        将该元素移除
                                         "replace"       将该元素替换为 converter() 处理后的结果
+                                        "skip":          不进行任何操作
             converter:          <func> 参见 action_mode 中的 "replace" 模式
                                     函数类型为 def(idx, value): xxxx
                                     其中 idx 和 value 的含义参见参数 match_cond 介绍
+            b_use_name_as_idx     <boolean> 对于 match_cond/converter 中的 idx 参数，是传入整体的 name 还是父节点的 index 或 key。
+                                    默认为 False
     """
     assert callable(match_cond)
-    assert action_mode in {"replace", "remove"}
+    assert action_mode in {"replace", "remove", "skip"}
     if action_mode == "replace":
         assert callable(converter)
 
-    return recursive_(var, match_cond, action_mode, converter)
+    return recursive_(var, match_cond, action_mode, converter, b_use_name_as_idx, "")
 
 
-def recursive_(var, match_cond, action_mode, converter):
+def recursive_(var, match_cond, action_mode, converter, b_use_name_as_idx, pre_name):
     if isinstance(var, (list, dict)):
         items = reversed(list(enumerate(var))) if isinstance(var, list) else list(var.items())
         for k, v in items:
-            if match_cond(type(var), k, v):
+            if b_use_name_as_idx:
+                idx = f'{pre_name}@{k}' if isinstance(var, list) else f'{pre_name}:{k}'
+            else:
+                idx = k
+            if match_cond(type(var), idx, v):
                 if action_mode == "remove":
                     var.pop(k)
+                elif action_mode == "replace":
+                    var[k] = converter(idx, v)
                 else:
-                    var[k] = converter(k, v)
+                    pass
             else:
-                var[k] = recursive_(v, match_cond, action_mode, converter)
+                var[k] = recursive_(v, match_cond, action_mode, converter, b_use_name_as_idx, idx)
     else:
         pass
     return var
-
-
-if __name__ == '__main__':
-    import numpy as np
-
-    x = [
-        dict(d=3, c=4),
-        np.array([[1, 2, 3]])
-    ]
-
-    y1 = traverse(var=x, match_cond=lambda _, k, v: type(v) is np.ndarray, action_mode="replace",
-                  converter=lambda k, v: v.tolist())
-    print(y1)
-
-    y2 = traverse(var=y1, match_cond=lambda _, k, v: v == 3, action_mode="remove")
-    print(y2)

kevin_toolbox/computer_science/algorithm/registration/__init__.py

@@ -0,0 +1 @@
+from .registry import Registry, UNIFIED_REGISTRY

kevin_toolbox/computer_science/algorithm/registration/registry.py

@@ -0,0 +1,232 @@
+import re
+import inspect
+import pkgutil
+import weakref
+from kevin_toolbox.computer_science.algorithm.for_nested_dict_list import get_value_by_name, set_value_by_name, \
+    traverse, count_leaf_node_nums
+
+
+class Registry:
+    """
+        注册器
+            具有以下功能
+            - 管理成员，包括添加 add()、获取 get() pop() 成员等
+            - 支持通过装饰器 register() 来添加成员
+            - 支持通过 collect_from() 搜索指定的路径，当该路径下的模块被 register() 装饰器包裹时，将自动导入（用于解决python中的模块是惰性的问题）
+
+        使用方法：
+            以目录结构：
+                xx/——— modules_dir
+                 |       |——— a.py
+                 |       |___ ...
+                 |——— test.py
+            为例。
+            我们的目标是在 test.py 中，构建一个能够自动加载 modules_dir 中待注册成员的 Registry 实例。
+            具体步骤如下：
+                1. 在文件 test.py 中：
+                    # 创建注册器实例
+                    DB = Registry(uid="DB")
+                    # 设置搜索路径
+                    DB.collect_from(path_ls=["xx/modules_dir"])
+
+                2. 在 modules_dir 下需要加载的成员中，以 a.py 为例：
+                    # 导入注册器实例
+                    from xx.test import DB
+                    # 使用 DB.register() 装饰器注册
+                    @DB.register(name=":my_module")
+                    class A:
+                        ...
+                    # 使用 add() 函数注册
+                    DB.add(obj=233, name=":var:c")
+
+                3. 在文件 test.py 中：
+                    # 获取已注册成员
+                    module = DB.get(name=":my_module")
+
+                4. 如果需要在其他文件中获取已有注册器实例，除了用 import 之外，还可以直接用 uid
+                    # 获取指定 uid 下的实例
+                    temp = Registry(uid="DB")
+    """
+    name = "registry made by kevin"
+    __instances = weakref.WeakValueDictionary()  # {uid: instance_i, ...} 用于保存创建的实例
+    __counter = 0
+
+    def __new__(cls, *args, **kwargs):
+        """
+            __new__函数返回的实例，将作为self参数被传入到__init__函数。
+                如果__new__函数返回一个已经存在的实例（不论是哪个类的），__init__还是会被调用的，所以要特别注意__init__中对变量的赋值。
+        """
+        uid = kwargs.get("uid", cls.__counter)
+
+        # 获取实例
+        if uid in cls.__instances:
+            # 返回已存在的实例
+            self = cls.__instances[uid]
+        else:
+            # 传入 __init__ 中新建一个实例
+            self = super().__new__(cls)
+        return self
+
+    def __init__(self, *args, **kwargs):
+        """
+            参数：
+                uid:                <hashable> 实例的唯一标识符
+                                        默认置空，此时将新建一个实例，并将此时已有实例的数量作为 uid
+                                        当为非空，则根据 uid 到已有实例中寻找相同的实例，并返回（使用该特性可以构造单例模式）
+        """
+        try:
+            getattr(self, "uid")
+        except:
+            pass
+        else:
+            return  # 如果是从 __new__ 中获取的已有的实例则不重复进行参数赋值
+        self.database = dict()
+        #
+        self.uid = kwargs.get("uid", Registry.__counter)
+        self.inactivate_b_force_of_add = False
+        # 记录到 __instances 中
+        Registry.__instances[self.uid] = self
+        Registry.__counter += 1
+
+    def add(self, obj, name=None, b_force=False):
+        """
+            注册
+
+            参数：
+                obj：            待注册成员
+                                    可以是函数、类或者callable的实例
+                                    也可以是各种 int、float、str变量
+                                    总之一切对象皆可
+                name：           <str> 成员名称
+                                    默认为 None，此时将从被注册对象 obj 的属性中尝试推断出其名称。
+                                        若 obj 中有 name 或者 __name__ 属性（优先选择name），则推断出的名称是 f':{obj.name}'；
+                                            进一步若有 version 属性，则为 f':{obj.name}:{obj.version}'
+                                        否则报错。
+                                        比如下面的类：
+                                            class A:
+                                                version="1.0"
+                                        的默认注册名称将是 ":A:1.0"
+                                    对于 int、str 和其他没有 name 或者 __name__ 属性的变量则必须要手动指定 name 参数。
+                        需要注意的是，成员的名称确定了其在注册器内部 database 中的位置，名称的解释方式参考 get_value_by_name() 中的介绍。
+                        因此不同的名称可能指向了同一个位置。
+                b_force：          <boolean> 是否强制注册
+                                    默认为 False，此时当 name 指向的位置上已经有成员时，将不进行覆盖而直接报错
+                                    当设置为 True，将会强制覆盖
+        """
+        # 检验参数
+        if name is None:
+            name = getattr(obj, "name", getattr(obj, "__name__", None))
+            if name is not None:
+                name = f':{name}'
+                version = getattr(obj, "version", None)
+                if version is not None:
+                    name += f':{version}'
+        assert isinstance(name, (str,))
+
+        # 尝试注册
+        temp = self.database.copy()
+        set_value_by_name(var=temp, name=name, value=obj, b_force=True)
+        # check
+        if not self.inactivate_b_force_of_add and not b_force:
+            inc_node_nums = count_leaf_node_nums(var=obj) if isinstance(obj, (list, dict)) else 1  # 增加的节点数量
+            assert count_leaf_node_nums(var=temp) == count_leaf_node_nums(var=self.database) + inc_node_nums, \
+                f'registration failed, it may be a conflict with an existing member'
+        self.database = temp
+
+    def get(self, name, **kwargs):
+        """
+            获取
+
+            参数：
+                name：           <str> 成员名称
+                default:          默认值
+                                    找不到时，若无默认值则报错，否则将返回默认值
+        """
+        try:
+            return get_value_by_name(var=self.database, name=name)
+        except:
+            if "default" in kwargs:
+                return kwargs["default"]
+            else:
+                raise AssertionError(f'element {name} not exists')
+
+    def pop(self, name, **kwargs):
+        """
+            弹出
+
+            参数：
+                name：           <str> 成员名称
+                                    名称一定要准确，不能含有模糊的 | 字符
+                default:          默认值
+                                    找不到时，若无默认值则报错，否则将返回默认值
+        """
+        assert "|" not in name, \
+            f'to pop up a specific member needs to give the exact name, ' \
+            f'does not support the "|" character with automatic deduction, invalid name: {name}, ' \
+            f'what you probably want to pop is {name.replace("|", ":")}'
+        res, b_found = None, False
+
+        def func(_, idx, value):
+            nonlocal res, b_found
+            if res is None and idx == name:
+                res, b_found = value, True
+                return True
+            else:
+                return False
+
+        traverse(var=self.database, match_cond=func, action_mode="remove", b_use_name_as_idx=True)
+        if b_found:
+            return res
+        else:
+            if "default" in kwargs:
+                return kwargs["default"]
+            else:
+                raise AssertionError(f'element {name} not exists')
+
+    def clear(self):
+        self.database.clear()
+
+    # -------------------- 装饰器 --------------------- #
+
+    def register(self, name=None, b_force=False):
+        """
+            用于注册成员的装饰器
+                成员可以是函数、类或者callable的实例
+
+            参数：
+                name：           <str> 成员名称
+                                    默认为 None
+                b_force：        <boolean> 是否强制注册
+                                    默认为 False
+                                （以上参数具体参考 add() 函数介绍）
+        """
+
+        def wrapper(obj):
+            nonlocal self, name, b_force
+            self.add(obj, name=name, b_force=b_force)
+            return obj
+
+        return wrapper
+
+    # -------------------- 其他 --------------------- #
+
+    def collect_from(self, path_ls):
+        """
+            遍历 path_ls 下的所有模块，并自动导入其中被 register() 装饰器包裹的部分
+                注意，自动导入时使用的 add() 方法中的 b_force 将强制设置为 True
+                这意味着不再检查可能冲突的添加项
+        """
+        temp = None
+        for loader, module_name, is_pkg in pkgutil.walk_packages(path_ls):
+            module = loader.find_module(module_name).load_module(module_name)
+            if temp is None:
+                for name, obj in inspect.getmembers(module):
+                    if getattr(obj, "name", None) == Registry.name and getattr(obj, "uid") == self.uid:
+                        temp = obj
+                        temp.inactivate_b_force_of_add = True
+                        break
+        if temp is not None:
+            self.database = temp.database
+
+
+UNIFIED_REGISTRY = Registry(uid="UNIFIED_REGISTRY")

kevin_toolbox/computer_science/algorithm/scheduler/strategy_manager.py

@@ -2,7 +2,7 @@ import random
 import torch
 import numpy as np
 import copy
-from kevin_toolbox.computer_science.algorithm.utils import set_value_by_name, get_value_by_name
+from kevin_toolbox.computer_science.algorithm.for_nested_dict_list import set_value_by_name, get_value_by_name
 
 
 class Strategy_Manager:

kevin_toolbox/computer_science/algorithm/utils/__init__.py

@@ -1,4 +0,0 @@
-from .get_hash import get_hash
-from .traverse import traverse
-from .get_value_by_name import get_value_by_name
-from .set_value_by_name import set_value_by_name

kevin_toolbox/data_flow/file/json_/write_json.py

@@ -2,7 +2,7 @@ import os
 import json
 import copy
 from kevin_toolbox.data_flow.file.json_.converter import integrate
-from kevin_toolbox.computer_science.algorithm.utils import traverse
+from kevin_toolbox.computer_science.algorithm.for_nested_dict_list import traverse
 
 
 def write_json(content, file_path, sort_keys=False, converters=None):

kevin_toolbox/developing/design_pattern/singleton/singleton_for_uid.py

@@ -11,7 +11,7 @@ class Singleton_for_uid:
     def __new__(cls, *args, **kwargs):
         """
             __new__函数返回的实例，将作为self参数被传入到__init__函数。
-                如果__new__函数返回一个已经存在的实例（不论是哪个类的），__init__不会被调用。
+                如果__new__函数返回一个已经存在的实例（不论是哪个类的），__init__还是会被调用的，所以要特别注意__init__中对变量的赋值。
         """
         uid = kwargs.get("uid", None)
         exist_ok = kwargs.get("exist_ok", True)
@@ -29,6 +29,12 @@ class Singleton_for_uid:
             return super().__new__(cls)
 
     def __init__(self, *args, **kwargs):
+        try:
+            getattr(self, "uid")
+        except :
+            pass
+        else:
+            return
         uid = kwargs.get("uid", None)
         assert isinstance(uid, (str, type(None),)), \
             TypeError(f"uid should be string or None, but get a {type(uid)}!")

{kevin_toolbox_dev-1.0.10b0.dist-info → kevin_toolbox_dev-1.0.12.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: kevin-toolbox-dev
-Version: 1.0.10b0
+Version: 1.0.12
 Summary: 一个常用的工具代码包集合
 Home-page: https://github.com/cantbeblank96/kevin_toolbox
 Download-URL: https://github.com/username/your-package/archive/refs/tags/v1.0.0.tar.gz
@@ -50,16 +50,15 @@ pip install kevin-toolbox  --no-dependencies
 
 [版本更新记录](./notes/Release_Record.md)：
 
-- v 1.0.10（2023-06-02）
-  - move get_value_by_name() from patches.utils to computer_science.algorithm.utils
-  - add set_value_by_name() to computer_science.algorithm.utils
-  - 增加了 computer_science.algorithm.scheduler ，其中包含
-    - Trigger 触发器
-    - Strategy_Manager 策略管理器
-    - 利用这两个类，就可以根据状态来调用对应策略，进而去调整变量中对应的部分。
-- v 1.0.10b（2023-06-04）
-  - kevin_toolbox.data_flow.file
-    - 让 kevin_notation 中的 column_dict 方式支持单行写入
+- v 1.0.12（2023-06-13）
+  - computer_science.algorithm.registration
+    - 添加了 Registry 注册器类，它具有以下功能：
+      - 管理成员，包括添加 add()、获取 get() pop() 成员等
+      - 支持通过装饰器 register() 来添加成员
+      - 支持通过 collect_from() 搜索指定的路径，当该路径下的模块被 register() 装饰器包裹时，将自动导入（用于解决python中的模块是惰性的问题）
+
+  - fix bug in kevin_toolbox/developing/design_pattern/singleton/singleton_for_uid.py
+    - 即使`__new__`函数返回一个已经存在的实例，`__init__`还是会被调用的，所以要特别注意`__init__`中对变量的赋值，避免对已经存在的实例中的变量重新进行初始化
 
 
 

{kevin_toolbox_dev-1.0.10b0.dist-info → kevin_toolbox_dev-1.0.12.dist-info}/RECORD

@@ -1,18 +1,32 @@
-kevin_toolbox/__init__.py,sha256=0aIZpky3PEZaFIy-4bugPV_dIRS6SKEeMUEVBjoVMNA,412
+kevin_toolbox/__init__.py,sha256=35QOrp5USStDrcp4L0SIdrSeOKRCZb4IMsfUty8R0rU,411
 kevin_toolbox/computer_science/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/computer_science/algorithm/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 kevin_toolbox/computer_science/algorithm/combinatorial_optimization/__init__.py,sha256=fBMX0_WiV8kfHLWZNfVe2uL67gsN_oHfpbuHaHUOiys,142
 kevin_toolbox/computer_science/algorithm/combinatorial_optimization/get_subset_with_largest_product.py,sha256=d43k85Jafgu97E37GtPW2zgOY7O6jwAcZlljr4JJZJ4,1832
 kevin_toolbox/computer_science/algorithm/combinatorial_optimization/zero_one_knapsack_problem.py,sha256=PR-JBphNdGZZvg016Q5iKzU9c44dTbqRFWrOg31EaIY,2819
 kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/test_get_subset_with_largest_product.py,sha256=5nq_YH_w4i6ThNTw6sErI_FcbIgsk92hxM8bNfS2EXg,1920
-kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/test_zero_one_knapsack_problem.py,sha256=SkconcER67bn76gbTfI_M2orqqNVPgcvOV-EY2uHCOY,2084
+kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/test_get_subset_with_largest_product.py,sha256=MVsQ1KgjwIVrXCejE6T08JOYnyXS2a9YMVBenvi6qXM,1914
+kevin_toolbox/computer_science/algorithm/combinatorial_optimization/test/test_zero_one_knapsack_problem.py,sha256=4j7IBmqkUSRFFIOOMU721eIwaLEiYL2BLx6xN5mJPDQ,2078
+kevin_toolbox/computer_science/algorithm/for_dict/__init__.py,sha256=YFxhbWIsOMGf7ay3fh0sosvXzpuqQQC1bkXK75LAqO4,37
+kevin_toolbox/computer_science/algorithm/for_dict/deep_update.py,sha256=GN5hq5cAorANwSkvgXNyXyAtrQIRzysEtUK_7zjWp9k,767
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/__init__.py,sha256=4SFdm9TmCJN8-AtUKhMd56XDnXo8qxdZdG_YMc7YPP4,258
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/count_leaf_node_nums.py,sha256=CY9fXmdkwWqHwP62LyxCp7uqt5OMNcSm1zD4s4Ol_x0,645
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/get_hash.py,sha256=Ygadnn5dnvIeE-9t39p2EwNKNRLzomL37ZsRD5daXxo,1286
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/get_leaf_nodes.py,sha256=o1ZIWhmw1_2JGE7Z1TweQx7qb5nXvHtRYbcWd2SMZbI,721
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/get_value_by_name.py,sha256=rJoDPyAMz5Fs67EbBMOm97QQeJhyP7S4mzUC6BDgk04,1912
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/set_value_by_name.py,sha256=o3yUS0WmmnS5fC4-e2GCR9BL5mYE_4AuyxCTvYP1wPA,2691
+kevin_toolbox/computer_science/algorithm/for_nested_dict_list/traverse.py,sha256=MJBcyjLhzqsSl3EEKkU2FxrpD7WSLPmGQHLhNqxjbgI,3263
+kevin_toolbox/computer_science/algorithm/for_seq/__init__.py,sha256=qXNVulpOBOWlD2yJ9L4D5bfrNFmnBd29ibtUbvaJHYk,76
+kevin_toolbox/computer_science/algorithm/for_seq/flatten_list.py,sha256=XnDq-_nQln55vwpAnBslyOKI_KYq11C7PmfLChhSe0k,1046
+kevin_toolbox/computer_science/algorithm/for_seq/get_subsets.py,sha256=uVc2pf9cBjX9sWd9VJ3w6nbsRPaeFT1fXRFfGl1zk6Q,309
 kevin_toolbox/computer_science/algorithm/locks/__init__.py,sha256=ZjZjqGsQB-z9MoYfOPYlI0H7nfZI1hNgxtmJaDdrynI,35
 kevin_toolbox/computer_science/algorithm/locks/mutex_lock.py,sha256=81cCw3oTXCZxFNhUzFTB5cPKmvbcLM_Gg-5DlT2nuRQ,2492
 kevin_toolbox/computer_science/algorithm/pareto_front/__init__.py,sha256=LbeaSzG0hkx8NHAlzvEalrGi2WufaXguVfeBRzaw-MA,57
 kevin_toolbox/computer_science/algorithm/pareto_front/get_pareto_points_idx.py,sha256=a-8Js-dpkuVu9MsImW9hwHp9OTC278xo9oJP96oX0Io,2712
+kevin_toolbox/computer_science/algorithm/registration/__init__.py,sha256=teEd9HkrB6baLpwNwae5c4wn0QRwV3KtBv-2V9-Z7cc,49
+kevin_toolbox/computer_science/algorithm/registration/registry.py,sha256=XPZjWNBe2hpPqf4E8FBC9c5poqXzhrJEuIG4Vf1UQWU,10160
 kevin_toolbox/computer_science/algorithm/scheduler/__init__.py,sha256=ENzZsNaMu6ISilTxeE3_EP_L0dNi8SI7IYdTdxic2nw,76
-kevin_toolbox/computer_science/algorithm/scheduler/strategy_manager.py,sha256=IuZRnzGGq5i5zQKRwEUW_SJpuEBT9GTC3KvIlwqoe7o,11480
+kevin_toolbox/computer_science/algorithm/scheduler/strategy_manager.py,sha256=yVOLk_k-V_RN7GMTx2-fL4eXbHa-DQDnIbmbpvGamyc,11495
 kevin_toolbox/computer_science/algorithm/scheduler/trigger.py,sha256=-WN7tZiXzFdxoB3aikwdhUmM49dpq334AGem4EL7Dpc,1227
 kevin_toolbox/computer_science/algorithm/search/__init__.py,sha256=zja7FXLTNd2dSVzzGp1TbBp4i3TDY8S9tcJ9pqc684A,41
 kevin_toolbox/computer_science/algorithm/search/binary_search.py,sha256=FcOdgxfuNews_AhPF_CoQDr2vBPqpUpifF7Fmgml1p4,1013
@@ -20,16 +34,7 @@ kevin_toolbox/computer_science/algorithm/statistician/__init__.py,sha256=zW1zesX
 kevin_toolbox/computer_science/algorithm/statistician/_init_var.py,sha256=-u9RFiiPFlCLwdVfVZslYq9jNyDz4r_A9kRSH05sExw,904
 kevin_toolbox/computer_science/algorithm/statistician/average_accumulator.py,sha256=hdgpnMtvBQri-_ZxEAkSwyK6_qy4sJdqEeYauOBgLMI,3101
 kevin_toolbox/computer_science/algorithm/statistician/exponential_moving_average.py,sha256=P5E1EL1ioRAz_vlI-Ls9gZFhxVA83eTNjUppb2WqdlM,5571
-kevin_toolbox/computer_science/algorithm/utils/__init__.py,sha256=ouMtbSAIEiiLTyvu80GJHkTbE3CPS-fE5-hH_QCdhVs,160
-kevin_toolbox/computer_science/algorithm/utils/get_hash.py,sha256=Ygadnn5dnvIeE-9t39p2EwNKNRLzomL37ZsRD5daXxo,1286
-kevin_toolbox/computer_science/algorithm/utils/get_value_by_name.py,sha256=oOCjEwAtCU64AH9hRjP8C15YOaSt07080JarI262-gM,2100
-kevin_toolbox/computer_science/algorithm/utils/set_value_by_name.py,sha256=KWAnNI_xfj-khJjxDFUVNL_I1HVz_zbY56VLWiaNIDE,2217
-kevin_toolbox/computer_science/algorithm/utils/traverse.py,sha256=Eumb3CfNZ1FRaHk9r-hkJWwW0h2oTEizgOhMNOFnezE,2603
-kevin_toolbox/computer_science/algorithm/utils/for_dict/__init__.py,sha256=YFxhbWIsOMGf7ay3fh0sosvXzpuqQQC1bkXK75LAqO4,37
-kevin_toolbox/computer_science/algorithm/utils/for_dict/deep_update.py,sha256=GN5hq5cAorANwSkvgXNyXyAtrQIRzysEtUK_7zjWp9k,767
-kevin_toolbox/computer_science/algorithm/utils/for_seq/__init__.py,sha256=qXNVulpOBOWlD2yJ9L4D5bfrNFmnBd29ibtUbvaJHYk,76
-kevin_toolbox/computer_science/algorithm/utils/for_seq/flatten_list.py,sha256=XnDq-_nQln55vwpAnBslyOKI_KYq11C7PmfLChhSe0k,1046
-kevin_toolbox/computer_science/algorithm/utils/for_seq/get_subsets.py,sha256=uVc2pf9cBjX9sWd9VJ3w6nbsRPaeFT1fXRFfGl1zk6Q,309
+kevin_toolbox/computer_science/algorithm/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/computer_science/data_structure/__init__.py,sha256=_esL73v9Gi40xb5N7UGxslIk8yHM6idQlXbzELR7XhA,31
 kevin_toolbox/computer_science/data_structure/executor.py,sha256=i-2zQj4lj597BvkarCMT-gYxhoRe8cHyQyO98X7m-9E,6206
 kevin_toolbox/dangerous/__init__.py,sha256=7TqcyVO0IUUZnFw6vFybvdY7UCg-Bv1Moh95IIVMT2c,93
@@ -45,7 +50,7 @@ kevin_toolbox/data_flow/core/reader/unified_reader_base.py,sha256=P7uqkjfHwc_KHU
 kevin_toolbox/data_flow/file/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 kevin_toolbox/data_flow/file/json_/__init__.py,sha256=VAt8COS2tO3PJRuhSc43i35fEOlArFM_YahdTmEBaHE,85
 kevin_toolbox/data_flow/file/json_/read_json.py,sha256=9UcFvC-4ZfoTlQPoEke0NEMS19lbbRPbErHvJt4-04g,237
-kevin_toolbox/data_flow/file/json_/write_json.py,sha256=l2H3pBUIbcAlxSAUc3hJyb5IlgTO1evJlWhrkxclGK4,770
+kevin_toolbox/data_flow/file/json_/write_json.py,sha256=y1H3wuwOpdMbJuy1NOKRXv5HzVeTtsDdOYqIqsQgOJc,785
 kevin_toolbox/data_flow/file/json_/converter/__init__.py,sha256=gF6eH6G4ndr4fi1qBZAKZ8VDZ6lhNz2w06YmE6yxoN4,161
 kevin_toolbox/data_flow/file/json_/converter/convert_dict_key_to_number.py,sha256=SuSZj_HCqKZutHAJ5AttABnGBRZplPGQhMxJBt2Wlgc,559
 kevin_toolbox/data_flow/file/json_/converter/convert_ndarray_to_list.py,sha256=GALpC1MFJ4aMzs0FZIfJScYznfCP-gmhPeM8sWXGSWg,391
@@ -76,7 +81,7 @@ kevin_toolbox/developing/design_pattern/producer_consumer/node.py,sha256=Q2zzboN
 kevin_toolbox/developing/design_pattern/producer_consumer/producer.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/developing/design_pattern/producer_consumer/sender.py,sha256=sn5WkJS3VS-nYbOO9emB8MMfGYHUKM6voj94KM2QIHs,51
 kevin_toolbox/developing/design_pattern/singleton/__init__.py,sha256=2PYWz9DDkR7a6vYb_4i3qzBsoskubozMwVf7IGUOz6M,49
-kevin_toolbox/developing/design_pattern/singleton/singleton_for_uid.py,sha256=Vu5_WdCNemBwZYFacfxZOq42DveQy41aL-8SCuaWid4,3631
+kevin_toolbox/developing/design_pattern/singleton/singleton_for_uid.py,sha256=AlerlDTfa0ZN3XiV5YmTI_OKR_F3RyeNuafYdHwCvfo,3803
 kevin_toolbox/developing/numerical_characteristics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/developing/numerical_characteristics/iou.py,sha256=XfN8LN3IY9C5HqbXi4XPnp1JX6K8_7-_rAjC-nVB-NI,2953
 kevin_toolbox/developing/temperate/__init__.py,sha256=9OdEkRFxCOtAf_QRUeNo6tH3t2cPGH_aLLl7lypK24s,630
@@ -209,7 +214,7 @@ kevin_toolbox/patches/for_torch/math/get_y_at_x.py,sha256=bfoVcasZ_tMdhR_1Me0Jli
 kevin_toolbox/patches/for_torch/math/my_around.py,sha256=ptpU3ids50gwf663EpHbw7raj9tNrDGBFZ5t_uMNH14,1378
 kevin_toolbox/patches/for_torch/nn/__init__.py,sha256=aJs3RMqRzQmd8KKDmQW9FxwCqS5yfPqEdg-m0PwlQro,39
 kevin_toolbox/patches/for_torch/nn/lambda_layer.py,sha256=KUuLiX_Dr4bvRmpAaCW5QTDWDcnMPRnw0jg4NNXTFhM,223
-kevin_toolbox_dev-1.0.10b0.dist-info/METADATA,sha256=JR9QGcUzyd-0Rx4Yx-ZnwFGtAOSv0fFLL5mQJe92osc,1816
-kevin_toolbox_dev-1.0.10b0.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-kevin_toolbox_dev-1.0.10b0.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
-kevin_toolbox_dev-1.0.10b0.dist-info/RECORD,,
+kevin_toolbox_dev-1.0.12.dist-info/METADATA,sha256=rwvX_e0lCFW1j4G7PPSy3NT9wH6HbJQhXm-zGDyP7pE,2023
+kevin_toolbox_dev-1.0.12.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+kevin_toolbox_dev-1.0.12.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
+kevin_toolbox_dev-1.0.12.dist-info/RECORD,,