kevin-toolbox-dev 1.4.5__py3-none-any.whl → 1.4.7__py3-none-any.whl

kevin_toolbox/env_info/check_validity_and_uninstall.py

@@ -1,6 +1,4 @@
-import os
 import subprocess
-import argparse
 import time
 
 """
@@ -8,22 +6,44 @@ import time
 - 若超过指定的有效期，则卸载。
 """
 
-out_parser = argparse.ArgumentParser(description='check_validity_and_uninstall')
-out_parser.add_argument('--package_name', type=str, required=True)
-out_parser.add_argument('--expiration_timestamp', type=int, required=False, default=1e10)
-out_parser.add_argument('--verbose', type=int, required=False, default=1)
-args = out_parser.parse_args().__dict__
-
-cur_timestamp = time.time()
-
-if cur_timestamp > args["expiration_timestamp"]:
-    ex = subprocess.Popen(f'pip uninstall {args["package_name"]} --yes', shell=True, stdout=subprocess.PIPE,
-                          stderr=subprocess.STDOUT)
-    out, _ = ex.communicate()
-    res = out.decode().strip()
-else:
-    res = "still within the validity period"
-
-if args["verbose"]:
-    # print(args)
-    print(res)
+DEFAULT_EXPIRATION_TIMESTAMP = 1e10
+
+
+def check_validity_and_uninstall(package_name, expiration_timestamp=DEFAULT_EXPIRATION_TIMESTAMP):
+    """
+        检查当前机器时间是否超过 expiration_timestamp 指定的有效期，若超过则卸载 package_name 对应的库
+    """
+    cur_timestamp = time.time()
+
+    b_success_uninstalled = False
+    if cur_timestamp > expiration_timestamp:
+        ex = subprocess.Popen(f'pip uninstall {package_name} --yes', shell=True, stdout=subprocess.PIPE,
+                              stderr=subprocess.STDOUT)
+        out, _ = ex.communicate()
+        msg = out.decode().strip()
+        if ex.returncode == 0:
+            b_success_uninstalled = True
+    else:
+        msg = "still within the validity period"
+
+    res_s = dict(cur_timestamp=cur_timestamp, expiration_timestamp=expiration_timestamp,
+                 b_success_uninstalled=b_success_uninstalled, msg=msg)
+    return res_s
+
+
+if __name__ == '__main__':
+    import argparse
+
+    out_parser = argparse.ArgumentParser(description='check_validity_and_uninstall')
+    out_parser.add_argument('--package_name', type=str, required=True)
+    out_parser.add_argument('--expiration_timestamp', type=float, required=False, default=DEFAULT_EXPIRATION_TIMESTAMP)
+    out_parser.add_argument('--verbose', type=lambda x: bool(eval(x)), required=False, default=True)
+    args = out_parser.parse_args().__dict__
+
+    b_version = args.pop("verbose")
+
+    res_s_ = check_validity_and_uninstall(**args)
+
+    if b_version:
+        for k, v in res_s_.items():
+            print(f"{k}: {v}")

kevin_toolbox/env_info/check_version_and_update.py

@@ -1,51 +1,72 @@
-import os
 import subprocess
-import argparse
-import version
-
-"""
-检查当前版本
-- 若在可用版本中，有比当前版本更高的版本，则更新到可以获取到的最新版本。
-"""
-
-out_parser = argparse.ArgumentParser(description='check_version_and_update')
-out_parser.add_argument('--package_name', type=str, required=True)
-out_parser.add_argument('--cur_version', type=str, required=False)
-out_parser.add_argument('--available_versions', nargs='+', type=str, required=False)
-out_parser.add_argument('--verbose', type=int, required=False, default=1)
-args = out_parser.parse_args().__dict__
-
-# try to read cur_version
-if args["cur_version"] is None:
-    ex = subprocess.Popen(f'pip list | grep "{args["package_name"]} "', shell=True, stdout=subprocess.PIPE)
-    out, _ = ex.communicate()
-    out = out.decode().strip()
-    # breakpoint()
-    args["cur_version"] = out.split(args["package_name"])[-1].strip()
-
-# try to read available versions
-if args["available_versions"] is None:
-    ex = subprocess.Popen(f'pip install {args["package_name"]}==?', shell=True, stdout=subprocess.PIPE,
-                          stderr=subprocess.STDOUT)
-    out, _ = ex.communicate()
-    out = out.decode().strip()
-    if "(from versions:" in out:
-        v_ls = out.split("(from versions:")[-1].rsplit(")", 1)[0].split(",", -1)
-        v_ls = [i.strip() for i in v_ls]
+
+try:
+    from kevin_toolbox.env_info import version
+except:
+    import version
+
+
+def check_version_and_update(package_name, cur_version=None, available_versions=None):
+    """
+        检查当前版本，并尝试更新
+            - 若在 pip 的可用版本中，有比当前版本更高的版本，则更新到可以获取到的最新版本。
+    """
+    # try to read cur_version
+    if cur_version is None:
+        ex = subprocess.Popen(f'pip list | grep "{package_name} "', shell=True, stdout=subprocess.PIPE)
+        out, _ = ex.communicate()
+        out = out.decode().strip()
+        # breakpoint()
+        cur_version = out.split(package_name)[-1].strip()
+
+    # try to read available versions
+    if available_versions is None:
+        ex = subprocess.Popen(f'pip install {package_name}==?', shell=True, stdout=subprocess.PIPE,
+                              stderr=subprocess.STDOUT)
+        out, _ = ex.communicate()
+        out = out.decode().strip()
+        if "(from versions:" in out:
+            v_ls = out.split("(from versions:")[-1].rsplit(")", 1)[0].split(",", -1)
+            v_ls = [i.strip() for i in v_ls]
+        else:
+            v_ls = ["none"]
+        available_versions = version.sort_ls(version_ls=v_ls, reverse=True)
+
+    b_success_updated = False
+    new_version = None
+    if len(available_versions) > 0 and version.compare(available_versions[0], ">", cur_version):
+        ex = subprocess.Popen(
+            f'pip install {package_name}=={available_versions[0]} --no-dependencies',
+            shell=True, stdout=subprocess.PIPE
+        )
+        out, _ = ex.communicate()
+        msg = out.decode().strip()
+        if ex.returncode == 0:
+            b_success_updated = True
+            new_version = available_versions[0]
     else:
-        v_ls = ["none"]
-    args["available_versions"] = version.sort_ls(version_ls=v_ls, reverse=True)
-
-if len(args["available_versions"]) > 0 and version.compare(args["available_versions"][0], ">", args["cur_version"]):
-    ex = subprocess.Popen(
-        f'pip install {args["package_name"]}=={args["available_versions"][0]} --no-dependencies',
-        shell=True, stdout=subprocess.PIPE
-    )
-    out, _ = ex.communicate()
-    res = out.decode().strip()
-else:
-    res = "Already the latest version, no need to update"
-
-if args["verbose"]:
-    # print(args)
-    print(res)
+        msg = "Already the latest version, no need to update"
+
+    res_s = dict(version_before_updated=cur_version, version_after_updated=new_version,
+                 available_versions=available_versions, b_success_updated=b_success_updated, msg=msg)
+
+    return res_s
+
+
+if __name__ == '__main__':
+    import argparse
+
+    out_parser = argparse.ArgumentParser(description='check_version_and_update')
+    out_parser.add_argument('--package_name', type=str, required=True)
+    out_parser.add_argument('--cur_version', type=str, required=False)
+    out_parser.add_argument('--available_versions', nargs='+', type=str, required=False)
+    out_parser.add_argument('--verbose', type=lambda x: bool(eval(x)), required=False, default=True)
+    args = out_parser.parse_args().__dict__
+
+    b_version = args.pop("verbose")
+
+    res_s_ = check_version_and_update(**args)
+
+    if b_version:
+        for k, v in res_s_.items():
+            print(f"{k}: {v}")

kevin_toolbox/env_info/test/test_check_.py

@@ -0,0 +1,52 @@
+import os
+import pytest
+from kevin_toolbox.env_info import check_validity_and_uninstall, check_version_and_update
+from kevin_toolbox.patches.for_test import check_consistency
+
+
+@pytest.mark.parametrize(
+    "package_name, expiration_timestamp, expected_s",
+    [
+        ("tqdm", 1, {"b_success_uninstalled": True}),
+        ("tqdm", 1e10, {"b_success_uninstalled": False}),
+    ]
+)
+def test_check_validity_and_uninstall(package_name, expiration_timestamp, expected_s):
+    # call by func
+    res_s = check_validity_and_uninstall(package_name=package_name, expiration_timestamp=expiration_timestamp)
+    print(res_s)
+    for k, v in expected_s.items():
+        check_consistency(res_s[k], v)
+
+    # call by script
+    os.system(
+        f'python {os.path.dirname(os.path.split(__file__)[0])}/check_validity_and_uninstall.py ' +
+        (f'--package_name {package_name} ' if package_name is not None else '') +
+        (f'--expiration_timestamp {expiration_timestamp} ' if expiration_timestamp is not None else '') +
+        f'--verbose 1'
+    )
+
+
+@pytest.mark.parametrize(
+    "package_name, cur_version, available_versions, expected_s",
+    [
+        ("tqdm", None, None, {}),
+        ("tqdm", "1.3.1", ["1.1.2", "1.1.3"], {"b_success_updated": False}),
+    ]
+)
+def test_check_version_and_update(package_name, cur_version, available_versions, expected_s):
+    # call by func
+    res_s = check_version_and_update(package_name=package_name, cur_version=cur_version,
+                                     available_versions=available_versions)
+    print(res_s)
+    for k, v in expected_s.items():
+        check_consistency(res_s[k], v)
+
+    # call by script
+    os.system(
+        f'python {os.path.dirname(os.path.split(__file__)[0])}/check_version_and_update.py ' +
+        (f'--package_name {package_name} ' if package_name is not None else '') +
+        (f'--cur_version {cur_version} ' if cur_version is not None else '') +
+        (f'--available_versions {available_versions} ' if available_versions is not None else '') +
+        f'--verbose 1'
+    )

kevin_toolbox/nested_dict_list/serializer/backends/_json_.py

@@ -35,8 +35,8 @@ class Json_(Backend_Base):
         """
         if id(var) != self.w_cache_s["id_"]:
             try:
-                self.w_cache_s["content"] = json_.write(content=var, file_path=None, sort_keys=False,
-                                                        b_use_suggested_converter=True)
+                self.w_cache_s["content"] = json_.write(content=var, file_path=None, b_use_suggested_converter=True,
+                                                        output_format=kwargs.get("output_format", "pretty_printed"))
             except:
                 self.w_cache_s["content"], self.w_cache_s["id_"] = None, None
                 self.w_cache_s["able"] = False

kevin_toolbox/patches/for_matplotlib/common_charts/plot_lines.py

@@ -5,7 +5,7 @@ from kevin_toolbox.patches.for_os.path import replace_illegal_chars
 from kevin_toolbox.patches.for_matplotlib.color import generate_color_list
 
 
-def plot_lines(data_s, title, x_name, output_dir=None, **kwargs):
+def plot_lines(data_s, title, x_name, x_ticklabels_name=None, output_dir=None, **kwargs):
     data_s = copy.copy(data_s)
     line_nums = len(data_s) - 1
     paras = {
@@ -23,6 +23,10 @@ def plot_lines(data_s, title, x_name, output_dir=None, **kwargs):
     plt.clf()
     #
     x_all_ls = data_s.pop(x_name)
+    if x_ticklabels_name is not None:
+        x_ticklabels = data_s.pop(x_ticklabels_name)
+        assert len(x_all_ls) == len(x_ticklabels)
+        plt.xticks(x_all_ls, x_ticklabels)
     data_s, temp = dict(), data_s
     for k, v_ls in temp.items():
         y_ls, x_ls = [], []

kevin_toolbox/patches/for_os/find_files_in_dir.py

@@ -2,7 +2,7 @@ import os
 from kevin_toolbox.patches.for_os import walk
 
 
-def find_files_in_dir(input_dir, suffix_ls, b_relative_path=True, b_ignore_case=True):
+def find_files_in_dir(input_dir, suffix_ls=None, b_relative_path=True, b_ignore_case=True):
     """
         找出目录下带有给定后缀的所有文件的生成器
             主要利用了 for_os.walk 中的过滤规则进行实现
@@ -12,19 +12,24 @@ def find_files_in_dir(input_dir, suffix_ls, b_relative_path=True, b_ignore_case=
             b_relative_path:    <bool> 是否返回相对路径
             b_ignore_case:      <bool> 是否忽略大小写
     """
-    suffix_ls = tuple(set(suffix_ls))
-    suffix_ls = tuple(map(lambda x: x.lower(), suffix_ls)) if b_ignore_case else suffix_ls
-    for root, dirs, files in walk(top=input_dir, topdown=True,
-                                  ignore_s=[{
-                                      "func": lambda _, b_is_symlink, path: b_is_symlink or not (
-                                              path.lower() if b_ignore_case else path).endswith(suffix_ls),
-                                      "scope": ["files", ]
-                                  }]):
-        for file in files:
-            file_path = os.path.join(root, file)
-            if b_relative_path:
-                file_path = os.path.relpath(file_path, start=input_dir)
-            yield file_path
-
-
-
+    if suffix_ls is not None:
+        suffix_ls = tuple(set(suffix_ls))
+        suffix_ls = tuple(map(lambda x: x.lower(), suffix_ls)) if b_ignore_case else suffix_ls
+        for root, dirs, files in walk(top=input_dir, topdown=True,
+                                      ignore_s=[{
+                                          "func": lambda _, b_is_symlink, path: b_is_symlink or not (
+                                                  path.lower() if b_ignore_case else path).endswith(suffix_ls),
+                                          "scope": ["files", ]
+                                      }]):
+            for file in files:
+                file_path = os.path.join(root, file)
+                if b_relative_path:
+                    file_path = os.path.relpath(file_path, start=input_dir)
+                yield file_path
+    else:
+        for root, dirs, files in walk(top=input_dir, topdown=True):
+            for file in files:
+                file_path = os.path.join(root, file)
+                if b_relative_path:
+                    file_path = os.path.relpath(file_path, start=input_dir)
+                yield file_path

kevin_toolbox/patches/for_os/organize/__init__.py

@@ -0,0 +1 @@
+from .group_files_by_timestamp import group_files_by_timestamp

kevin_toolbox/patches/for_os/organize/group_files_by_timestamp.py

@@ -0,0 +1,90 @@
+import os
+from collections import defaultdict
+import warnings
+import time
+from kevin_toolbox.patches.for_os import find_files_in_dir, copy, remove
+
+# 获取文件的时间,返回time.struct_time格式
+get_timestamp_method_s = dict(
+    c=lambda file_path: time.localtime(max(os.path.getctime(file_path), 0)),
+    a=lambda file_path: time.localtime(max(os.path.getatime(file_path), 0)),
+    m=lambda file_path: time.localtime(max(os.path.getmtime(file_path), 0))
+)
+
+
+def group_files_by_timestamp(input_dir, output_dir=None, suffix_ls=None, b_ignore_case=True,
+                             grouping_rule=("%Y", "%m_%d"), timestamp_type="m", b_keep_source=True, b_verbose=False):
+    """
+        将 input_dir 中的文件按照时间戳信息进行分组，输出到 output_dir 中
+
+        参数：
+            input_dir:              输入目录
+            output_dir:             输出目录
+                                        当设置为 None 时，将进行空跑，不实际复制文件到 output_dir 中
+            suffix_ls:              <list of path/None> 指定要对带有哪些后缀的文件进行处理
+                                        默认为 None 表示对所有文件都进行处理
+            b_ignore_case:          <boolean> 忽略大小写
+                                        默认为 True
+            grouping_rule:          <str/list of str>分组规则
+                                        默认为 ("%Y", "%m_%d")，此时将按照年月日进行分组。
+                                        比如时间戳为 2016-03-20 11:45:39 的文件将被保存到 <output_dir>/2016/03_20 目录下
+                                        其他可选样式：
+                                            - "%Y_%m"   精确到月
+                                            - ("%Y", "%m_%d", "%H-%M-%S")   精确到秒
+                                            依次类推
+            timestamp_type:         使用哪个维度的时间戳
+                                        有以下可选值：
+                                            - "m"       文件的修改时间
+                                            - "a"       文件的最近访问时间
+                                            - "c"       文件的创建时间
+                                        默认为 "m"。
+            b_keep_source:          <boolean> 是否保留 input_dir 中的原始文件
+    """
+    if isinstance(grouping_rule, str):
+        grouping_rule = [grouping_rule]
+    assert timestamp_type in ['m', 'a', 'c']
+    global get_timestamp_method_s
+    os.makedirs(output_dir, exist_ok=True)
+
+    get_timestamp = get_timestamp_method_s[timestamp_type]
+    res_s = defaultdict(lambda: dict(src_ls=[], dst_ls=[], b_success_ls=[]))
+    for file in find_files_in_dir(input_dir=input_dir, suffix_ls=suffix_ls, b_ignore_case=b_ignore_case,
+                                  b_relative_path=True):
+        src = os.path.join(input_dir, file)
+        timestamp = get_timestamp(src)
+        group_name = tuple(f'{time.strftime(i, timestamp)}' for i in grouping_rule)
+        out_folder = os.path.join(output_dir, *group_name)
+        dst = os.path.join(out_folder, os.path.basename(file))
+        os.makedirs(out_folder, exist_ok=True)
+        b_success = False
+        try:
+            copy(src=src, dst=dst)
+            if b_verbose:
+                print(f'{file} -> {out_folder}')
+            b_success = True
+        except:
+            warnings.warn(f'failed to copy file {file} to {out_folder}')
+        if not b_keep_source:
+            remove(path=dst, ignore_errors=True)
+        res_s[group_name]['b_success_ls'].append(b_success)
+        res_s[group_name]['src_ls'].append(file)
+        res_s[group_name]['dst_ls'].append(os.path.relpath(path=dst, start=output_dir))
+    return res_s
+
+
+if __name__ == "__main__":
+    res = group_files_by_timestamp(suffix_ls=['.jpg', '.mp4', '.png', '.jpeg', '.mov', '.cr2', ".bmp"],
+                                   grouping_rule=("%Y-%m", "%Y_%m_%d"),
+                                   # "%Y-%m-%d %H:%M:%S" 2016-03-20 11:45:39 #"%a %b"  Sat Mar
+                                   input_dir="/home/SENSETIME/xukaiming/Desktop/my_repos/python_projects/kevin_toolbox/kevin_toolbox/developing/photo_organization/test/test_data",
+                                   output_dir="/home/SENSETIME/xukaiming/Desktop/my_repos/python_projects/kevin_toolbox/kevin_toolbox/developing/photo_organization/test/test_data1",
+                                   timestamp_type="m")
+    print(res)
+
+    # timestamp_type = input("分类标准：m for modifytime \n c for createtime\n a for accesstime\n")
+    # copy_path_root = os.path.join(output_dir, \
+    #                               'deal' + str(time.strftime('%Y-%m-%d-%H-%M-%S', time.localtime())))
+    # group_by_timestamp(suffix_ls=['.MP4', '.jpg', '.mp4', '.png', '.JPG', '.MOV', '.CR2'],
+    #                    grouping_rule="%Y_%m_%d",  # "%Y-%m-%d %H:%M:%S" 2016-03-20 11:45:39 #"%a %b"  Sat Mar
+    #                    input_dir=input("please input the root path\n"),
+    #                    output_dir=input("please input the target_path\n"), timestamp_type=timestamp_type)

kevin_toolbox_dev-1.4.7.dist-info/METADATA

@@ -0,0 +1,69 @@
+Metadata-Version: 2.1
+Name: kevin-toolbox-dev
+Version: 1.4.7
+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
+Author: kevin hsu
+Author-email: xukaiming1996@163.com
+License: MIT
+Keywords: mathematics,pytorch,numpy,machine-learning,algorithm
+Platform: UNKNOWN
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: torch (>=1.2.0)
+Requires-Dist: numpy (>=1.19.0)
+Provides-Extra: plot
+Requires-Dist: matplotlib (>=3.0) ; extra == 'plot'
+Provides-Extra: rest
+Requires-Dist: pytest (>=6.2.5) ; extra == 'rest'
+Requires-Dist: line-profiler (>=3.5) ; extra == 'rest'
+
+# kevin_toolbox
+
+一个通用的工具代码包集合
+
+
+
+环境要求
+
+```shell
+numpy>=1.19
+pytorch>=1.2
+```
+
+安装方法：
+
+```shell
+pip install kevin-toolbox  --no-dependencies
+```
+
+
+
+[项目地址 Repo](https://github.com/cantbeblank96/kevin_toolbox)
+
+[使用指南 User_Guide](./notes/User_Guide.md)
+
+[免责声明 Disclaimer](./notes/Disclaimer.md)
+
+[版本更新记录](./notes/Release_Record.md)：
+
+- v 1.4.7 （2025-02-19）【new feature】【bug fix】【incompatible change】
+
+  - data_flow.file
+    - 【new feature】【incompatible change】modify json_.write()，支持使用参数 output_format 设置更复杂的输出格式。同时废弃原来的sort_keys参数。
+      - output_format 支持以下输入：
+        - "pretty_printed":     通过添加大量的空格和换行符来格式化输出，使输出更易读
+        - "minified":           删除所有空格和换行符，使输出更紧凑
+        - `<dict/tuple>`：     更加细致的格式设定，比如 `{"indent": 2, ensure_ascii=True}`，如果需要基于已有格式进行微调可以使用以下方式:`("pretty_printed", {"indent": 2, ensure_ascii=True})`
+  - computer_science.algorithm.parallel_and_concurrent
+    - 【bug fix】【incompatible change】fix bug in multi_thread_execute()，修正了参数timeout无法对每个任务起效的bug，将参数thread_nums更名为worker_nums。
+    - 【new feature】add multi_process_execute()，用于多进程执行任务。同样支持timeout设定和进度条显示。
+  - patches.for_matplotlib.common_charts
+    - modify plot_lines()，添加了 x_ticklabels_name 参数用于自定义x轴的坐标值
+  - 以上修改，均已添加了对应的测试用例。
+
+

{kevin_toolbox_dev-1.4.5.dist-info → kevin_toolbox_dev-1.4.7.dist-info}/RECORD

@@ -1,8 +1,8 @@
-kevin_toolbox/__init__.py,sha256=FXO6FMIEpptwoM95rn6R9rr5B72w0_y5nCnNKpjKTeI,410
+kevin_toolbox/__init__.py,sha256=-Tz-COP35PmSQrmLdDYK9Eq_i7wCXKv3hJp2_MzZHRw,410
 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/cache_manager/__init__.py,sha256=p2hddkZ1HfYF9-m2Hx-o9IotwQHd4QwDCePy2ADpTDA,41
-kevin_toolbox/computer_science/algorithm/cache_manager/cache_manager.py,sha256=e_mesTHjYlSV2VjXfmrA_osJRZhGe3nyS5SX1R5rfOQ,9151
+kevin_toolbox/computer_science/algorithm/cache_manager/cache_manager.py,sha256=yQ6bqOSPcTrq4FLyuxDERz7Yv9ZWsenjb48q6KRStj4,9771
 kevin_toolbox/computer_science/algorithm/cache_manager/variable.py,sha256=j6yLezcZxf7gNdxwUxP0PPy2zauVpTr6KFMCg66m9lo,835
 kevin_toolbox/computer_science/algorithm/cache_manager/cache/__init__.py,sha256=Tt8XgrZsHP3J3f6UucGNhGAN8L7HiVjLLO1JzICR2Mc,70
 kevin_toolbox/computer_science/algorithm/cache_manager/cache/cache_base.py,sha256=Jln4Ey0sUGrzUqpkHaMP0S_z6NUw43iLnwMbmm-8msg,2229
@@ -35,9 +35,13 @@ kevin_toolbox/computer_science/algorithm/for_seq/flatten_list.py,sha256=XnDq-_nQ
 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/parallel_and_concurrent/__init__.py,sha256=EUy1RptOJCLzu6L0ZWGdyto0btI_vEvjEJHvKKBN4pk,55
+kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/__init__.py,sha256=bIyMaB3v6JFjkrY7-sg_-yAnFH8I53E2qxIhGprcLzo,112
 kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/async_executor.py,sha256=yWHpD_1XrC8hG3PWXUZEDj5rnfM0-d-NptRE856tcmY,896
-kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/multi_thread_execute.py,sha256=WSQZ9BE-21oc59leHxd-2IRMMxpmEezX7SX7e1UyV-4,3126
+kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/multi_process_execute.py,sha256=00QSeECaglANNyfeAeqWrP83WAhoixpg_zyy6k1ioyY,4176
+kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/multi_thread_execute.py,sha256=psvezDjaPAwK05GYCJno7GhiW-Zt_Swy5nuyS_xOgUU,3901
+kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/utils/__init__.py,sha256=zdYxhuhJk3m7b1MMaXh2frCpOh6vbK3N6u3t0UEC3_w,475
+kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/utils/wrapper_with_timeout_1.py,sha256=8vO26zBOq12BXJc0wudyGeWObIAfDkxWU-pg5VOOZMA,2165
+kevin_toolbox/computer_science/algorithm/parallel_and_concurrent/utils/wrapper_with_timeout_2.py,sha256=LcDBFjPY77tyZGjk2g3iCEj7bNeQS4usaqgoUQAZxSY,2412
 kevin_toolbox/computer_science/algorithm/pareto_front/__init__.py,sha256=F1uD0ZT2Ukb708_Eay96SEhaDfCq9YEheJRust33P6w,111
 kevin_toolbox/computer_science/algorithm/pareto_front/get_pareto_points_idx.py,sha256=WR-_9BruqAWH0QECa40b1Iz1_k6uesBrUYrn2s9ALBM,3008
 kevin_toolbox/computer_science/algorithm/pareto_front/optimum_picker.py,sha256=wnYN2s9r2g1z5wF0FvFLawRYITUJbMXbBs4TPsdvhlE,9923
@@ -58,7 +62,7 @@ kevin_toolbox/computer_science/algorithm/statistician/init_var/init_by_data_form
 kevin_toolbox/computer_science/algorithm/statistician/init_var/init_by_like.py,sha256=8QfvltiNDqZUYiNW6Ebt0UIuYvyqhSpsCYn99T2q70c,572
 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/computer_science/data_structure/executor.py,sha256=ogcozUbd2QW6AruS50CkMdXWc9rE_UJd-KcHO_RMXQg,6211
 kevin_toolbox/dangerous/__init__.py,sha256=7TqcyVO0IUUZnFw6vFybvdY7UCg-Bv1Moh95IIVMT2c,93
 kevin_toolbox/dangerous/dump_into_pickle_with_executor_attached.py,sha256=oaPlXyMsG57XbahVqrZENvGSZy2EefoRCmfpm_6tNEQ,2898
 kevin_toolbox/data_flow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -72,9 +76,11 @@ kevin_toolbox/data_flow/core/reader/file_iterative_reader.py,sha256=l6UMYnvWwqQm
 kevin_toolbox/data_flow/core/reader/unified_reader.py,sha256=l6JxPoDUOdx2ZIPX2WLXbGU3VZtTd1AeHn5q6L8GWAI,2453
 kevin_toolbox/data_flow/core/reader/unified_reader_base.py,sha256=4gIADdV8UKpt2yD8dZjQsXFcF75nJ83ooIae3D7bw2s,11783
 kevin_toolbox/data_flow/file/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+kevin_toolbox/data_flow/file/excel/__init__.py,sha256=5m_rmklI6n6yk4rSAEW39pxzYTiAPjC4q69v-oz7Zvs,82
+kevin_toolbox/data_flow/file/excel/write_excel_with_matrix.py,sha256=zrY_l0xCBpjqxm_9MoGpEXaZ4V_UwRMRgShessJ1sxA,5121
 kevin_toolbox/data_flow/file/json_/__init__.py,sha256=VAt8COS2tO3PJRuhSc43i35fEOlArFM_YahdTmEBaHE,85
-kevin_toolbox/data_flow/file/json_/read_json.py,sha256=BhAUCcagwPsSMaMeCJyyxDW3h9SGf1Dfvb0nXi6B_T8,2084
-kevin_toolbox/data_flow/file/json_/write_json.py,sha256=uG6UnQ9KVhL_UWndGjvLLHF_UoGtOwVn4ADi1Gb1nRU,2417
+kevin_toolbox/data_flow/file/json_/read_json.py,sha256=RyCeNONMmvVOeX_F3kSSmED_nx4opipLe8OHJzXKZvQ,2151
+kevin_toolbox/data_flow/file/json_/write_json.py,sha256=ZiNrVUK3ofFmtA-5mU_W1N7bDdReC_yi6CtG2I47B4A,4198
 kevin_toolbox/data_flow/file/json_/converter/__init__.py,sha256=oQMgAgzELLq_f4LIIfz5E6l_E7g4lFsXqfmnJ3tPZTY,401
 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
@@ -136,10 +142,11 @@ kevin_toolbox/developing/temperate/iterator_base.py,sha256=FYMJ49ltbBcV92tUThx8Z
 kevin_toolbox/developing/temperate/my_iterator.py,sha256=dpFq_3wa4W2Y4SZfVl93T8oAEoy3gDOkQUdXB4p-cBQ,1663
 kevin_toolbox/developing/temperate/my_iterator_base.py,sha256=gLv9zdM987BHRghTfADUTwwQcMOV4WZWx-8-QvlV2uY,1214
 kevin_toolbox/developing/temperate/sequence_map_base.py,sha256=ha1EIMhn9lBF05s9niHLTuxhRslOx5faOk8UIjhhxUk,217
-kevin_toolbox/env_info/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-kevin_toolbox/env_info/check_validity_and_uninstall.py,sha256=GskNfWwj2ak2AszV_0MMs2hBZb2tmRD0POO11UiouLM,879
-kevin_toolbox/env_info/check_version_and_update.py,sha256=og9ngoO6VhnlmUIkL0IZCyGXrI8rpZWRoN4t9FYGIkw,1953
+kevin_toolbox/env_info/__init__.py,sha256=8Io5RN5RcbEoMLHY4wfMa4pJxa1w0SMaXBN4v6k5CrM,134
+kevin_toolbox/env_info/check_validity_and_uninstall.py,sha256=FOLeVKRqqiFnAQpx_AmIc8D3UcJigzIx58XDTJgv_qw,1676
+kevin_toolbox/env_info/check_version_and_update.py,sha256=GsL5tqodh7bbcXmWRT1vWy9GFRhqHJmTgEgvJg4GT5E,2739
 kevin_toolbox/env_info/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kevin_toolbox/env_info/test/test_check_.py,sha256=wiIM_UVy_ksdq3la-pbF605Lhl5iW3a-0S_B74QzPT8,2054
 kevin_toolbox/env_info/test/test_variable_.py,sha256=n9To8UNfBSNey8Xy7relXcbrf0yX8ZoZzfJctd2fHBs,1657
 kevin_toolbox/env_info/test/test_version.py,sha256=xnF7RAcLSN3gpjIbVxFUV2-lmv0w7gOhdRa4XN0z0Q0,1728
 kevin_toolbox/env_info/variable_/__init__.py,sha256=qFs8ZZVBjAfj6IuUujYxaEnmXk6HEbtN6GXaIkuQhoM,81
@@ -253,7 +260,7 @@ kevin_toolbox/nested_dict_list/serializer/saved_node_name_builder.py,sha256=qsD-
 kevin_toolbox/nested_dict_list/serializer/variable.py,sha256=ZywG6obipRBCGY1cY42gdvsuWk8GLZXr6eCYcW7ZJ9c,392
 kevin_toolbox/nested_dict_list/serializer/write.py,sha256=ZUYJlBXQbCkMW2UN3d29obskGGbTA-gm3dmuLLltxLI,24101
 kevin_toolbox/nested_dict_list/serializer/backends/__init__.py,sha256=8g7y-L3cmctxao616dVkGiot00FJzKNmNl_69V2bSmE,39
-kevin_toolbox/nested_dict_list/serializer/backends/_json_.py,sha256=oJXIc28yjxsD9ZJuw120pVHTVsTzCdaXEhVUSQeydq4,2145
+kevin_toolbox/nested_dict_list/serializer/backends/_json_.py,sha256=yu3604KvzU8dKyECBQ3v127dsEr-VaRz0Mm4dBJgNfc,2189
 kevin_toolbox/nested_dict_list/serializer/backends/_ndl.py,sha256=3YkAq_Bqzehnw0kGxqxwtF6uUz0EV37tLI-1ROHjixY,1794
 kevin_toolbox/nested_dict_list/serializer/backends/_numpy_bin.py,sha256=xiPFmPUTjy0X0R1E0N8mrByENhNb69QalHnbYQXFvTo,1470
 kevin_toolbox/nested_dict_list/serializer/backends/_numpy_npy.py,sha256=CF6R7ie68zA0TqAXBdxUgHKVDYtEPHfVXR9rMFBbsdw,1384
@@ -286,7 +293,7 @@ kevin_toolbox/patches/for_matplotlib/common_charts/__init__.py,sha256=etey2r0LO4
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_bars.py,sha256=crS1h79Dz6gGOnqhjuuN2o5pl8CekhCenx9lRz5KPiI,1887
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_confusion_matrix.py,sha256=KtmUAlKs3_ALFRKAEi0OAXj6SyG5L7LMmoSgOxKvvVs,3213
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_distribution.py,sha256=stuyaULWM_vVW3r9WrpzGqA8rohQrdNKT3Agsbobqck,2396
-kevin_toolbox/patches/for_matplotlib/common_charts/plot_lines.py,sha256=j2GBT_E9tvQhLN2ynCknuBl1MjD6q2TZeNYGvm2IVRA,2034
+kevin_toolbox/patches/for_matplotlib/common_charts/plot_lines.py,sha256=R7mbfmXIOj52BrGuQjf9uDXJ2etwCRCN7ZWX_5cQtBs,2242
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters.py,sha256=whO36bmixjwtsjCS6Ah6zEGJAlJyGcD-wmV3dA6u7mk,1658
 kevin_toolbox/patches/for_matplotlib/common_charts/plot_scatters_matrix.py,sha256=bf2EfGlPW9dtDfRse1gk8RVxvC8CJ0NeMdrpSw43wFg,1989
 kevin_toolbox/patches/for_numpy/__init__.py,sha256=SNjZGxTRBn-uzkyZi6Jcz-9juhhZKT8TI70qH-fhGGc,21
@@ -317,11 +324,13 @@ kevin_toolbox/patches/for_optuna/serialize/for_trial/dump.py,sha256=FT-Z1rzCNUYz
 kevin_toolbox/patches/for_optuna/serialize/for_trial/load.py,sha256=2fpeeHPKA9bT7CjQ6DVRXOarF6IAA6_f2pXbB1rXcvE,796
 kevin_toolbox/patches/for_os/__init__.py,sha256=OhGxHkzI-oBek6M07kkrRgTQfY42l1Y2nOIR95JYD-g,219
 kevin_toolbox/patches/for_os/copy.py,sha256=PWFLu15DpIA4JZxatvphHANNn2H3nC93qTbLLxDl5NU,1509
-kevin_toolbox/patches/for_os/find_files_in_dir.py,sha256=KtjUJTMTNivAoWXGYgVkuaXukU1ktEAA-u8peusznmU,1266
+kevin_toolbox/patches/for_os/find_files_in_dir.py,sha256=89bV4g-1-GBHwRr1K1KjJk7UvYM4LCvQmPVCVTZkX-g,1656
 kevin_toolbox/patches/for_os/pack.py,sha256=A6u4g3dfwXPtlU4gBcThNrktz6dO4DVi2wmQXytqfDI,656
 kevin_toolbox/patches/for_os/remove.py,sha256=PmwqzVJbyfdqwXn_T1F9d4Oar8CwQ2YFaqcZQkfnrnI,750
 kevin_toolbox/patches/for_os/unpack.py,sha256=d_fO7nPmExy1VIg7ADIMayCzjBBeFxvJLhIsulIRlzI,1047
 kevin_toolbox/patches/for_os/walk.py,sha256=LrtEeRUDwzZgu_zGZ-kPsFJd4D-8R8ECHW6WNdEsDSw,8376
+kevin_toolbox/patches/for_os/organize/__init__.py,sha256=GGSUvdHzYK9prCwz4XCm1lp4g4A_o9tuU_l3bNi5MMs,63
+kevin_toolbox/patches/for_os/organize/group_files_by_timestamp.py,sha256=CpGKMJ7GIywTgumo3TyM_SXgaeh0Gtl9xIkm6-YKJE4,5222
 kevin_toolbox/patches/for_os/path/__init__.py,sha256=M4XaYawTDj-SjwZ_bWS5D38lqzPujxvAtVEvzRLDhtU,108
 kevin_toolbox/patches/for_os/path/find_illegal_chars.py,sha256=QmqzeaeBY50of28qtvfEmnDW9xeVIfCXi6QVzLzngks,1416
 kevin_toolbox/patches/for_os/path/replace_illegal_chars.py,sha256=OhxndHEJ8xK-ip-sWYQehTNSho8eNFeKj2iwPHR02os,1672
@@ -349,7 +358,7 @@ kevin_toolbox/patches/for_torch/nn/__init__.py,sha256=aJs3RMqRzQmd8KKDmQW9FxwCqS
 kevin_toolbox/patches/for_torch/nn/lambda_layer.py,sha256=KUuLiX_Dr4bvRmpAaCW5QTDWDcnMPRnw0jg4NNXTFhM,223
 kevin_toolbox/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 kevin_toolbox/utils/variable.py,sha256=PxUmp9w4CKKcKHjgdVNF_Iaw5gwPPOd4aY_Oe5F9U1M,133
-kevin_toolbox_dev-1.4.5.dist-info/METADATA,sha256=-CIxxD1zrM4_RrzEyB7KVLxUsjQfRGqSdUiBI1z_tzM,2818
-kevin_toolbox_dev-1.4.5.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-kevin_toolbox_dev-1.4.5.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
-kevin_toolbox_dev-1.4.5.dist-info/RECORD,,
+kevin_toolbox_dev-1.4.7.dist-info/METADATA,sha256=WBubN5isDdTd6IK1yTNeqFgU7ZfnrE4LbjU57x3Q0x4,2586
+kevin_toolbox_dev-1.4.7.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+kevin_toolbox_dev-1.4.7.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
+kevin_toolbox_dev-1.4.7.dist-info/RECORD,,