kevin-toolbox-dev 1.4.5__tar.gz → 1.4.6__tar.gz

kevin-toolbox-dev-1.4.6/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.1
+Name: kevin-toolbox-dev
+Version: 1.4.6
+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
+Provides-Extra: plot
+Provides-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.6 （2025-01-24）【new feature】
+
+  - data_flow.file
+    - modify json_.read()，支持输入路径使用 ~ 表示家目录。
+    - 【new feature】add excel，该模块用于 excel 表格处理。
+      - write_with_matrix()：将矩阵写入到 excel 文件中
+
+  - patches.for_os
+    - modify find_files_in_dir()，支持 suffix_ls 设定 None 以表示不进行任何过滤。
+    - 【new feature】add organize，该模块用于文件整理。
+      - group_files_by_timestamp()：将 input_dir 中的文件按照时间戳信息进行分组，输出到 output_dir 中。
+    - 添加了对应的测试用例。
+  - env_info
+    - 【new feature】add check_validity_and_uninstall()，检查当前机器时间是否超过 expiration_timestamp 指定的有效期，若超过则卸载 package_name 对应的库。
+    - 【new feature】add check_version_and_update()，检查当前库的版本，并尝试更新。
+    - 以上函数均系从同名脚本中抽取出来。
+  - 以上修改，均已添加了对应的测试用例。
+  - developing
+    - 【new feature】add photo_album_organization，该模块包含一系列整理相册相关的脚本。
+      -  0_group_by_timestamp.py ：按照时间戳分组
+      -  1_merge_folders.py ：将文件数量较少的目录合并
+
+

kevin-toolbox-dev-1.4.6/README.md

@@ -0,0 +1,50 @@
+# 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.6 （2025-01-24）【new feature】
+
+  - data_flow.file
+    - modify json_.read()，支持输入路径使用 ~ 表示家目录。
+    - 【new feature】add excel，该模块用于 excel 表格处理。
+      - write_with_matrix()：将矩阵写入到 excel 文件中
+
+  - patches.for_os
+    - modify find_files_in_dir()，支持 suffix_ls 设定 None 以表示不进行任何过滤。
+    - 【new feature】add organize，该模块用于文件整理。
+      - group_files_by_timestamp()：将 input_dir 中的文件按照时间戳信息进行分组，输出到 output_dir 中。
+    - 添加了对应的测试用例。
+  - env_info
+    - 【new feature】add check_validity_and_uninstall()，检查当前机器时间是否超过 expiration_timestamp 指定的有效期，若超过则卸载 package_name 对应的库。
+    - 【new feature】add check_version_and_update()，检查当前库的版本，并尝试更新。
+    - 以上函数均系从同名脚本中抽取出来。
+  - 以上修改，均已添加了对应的测试用例。
+  - developing
+    - 【new feature】add photo_album_organization，该模块包含一系列整理相册相关的脚本。
+      -  0_group_by_timestamp.py ：按照时间戳分组
+      -  1_merge_folders.py ：将文件数量较少的目录合并

{kevin-toolbox-dev-1.4.5 → kevin-toolbox-dev-1.4.6}/kevin_toolbox/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.4.5"
+__version__ = "1.4.6"
 
 
 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 1750434037 --verbose 0'
+    f'--expiration_timestamp 1753280251 --verbose 0'
 )

{kevin-toolbox-dev-1.4.5 → kevin-toolbox-dev-1.4.6}/kevin_toolbox/computer_science/algorithm/cache_manager/cache_manager.py

@@ -44,6 +44,12 @@ class Cache_Manager:
                                             当设置为 float 时表示占 upper_bound 的比例
                                             默认为 0.5
                 strategy:               <str/dict/Strategy_Base> 管理策略
+                                            目前支持以下策略：
+                                                - ":by_initial_time:FIFO"     删除最后一次访问时间最久远的部分
+                                                - ":by_counts:LFU"            删除访问频率最低的部分
+                                                - ":by_last_time:LRU"          删除最后一次访问时间最久远的部分
+                                                - ":by_survival_time:LST"      删除访问频率最低的部分
+                                            默认使用 LRU 策略
                 cache:                  <str/dict/Cache_Base> 缓存种类
         """
         # 默认参数

kevin-toolbox-dev-1.4.6/kevin_toolbox/data_flow/file/excel/__init__.py

@@ -0,0 +1 @@
+from .write_excel_with_matrix import write_excel_with_matrix as write_with_matrix

kevin-toolbox-dev-1.4.6/kevin_toolbox/data_flow/file/excel/write_excel_with_matrix.py

@@ -0,0 +1,105 @@
+import os
+import openpyxl
+from openpyxl.styles import Alignment, Font, PatternFill
+from kevin_toolbox.patches.for_os import remove
+
+
+# excel
+def write_excel_with_matrix(matrix, file_path=None, file_obj=None, sheet_name="matrix",
+                            column_label_ls=None, row_label_ls=None, column_title="", row_title="", main_title=""):
+    """
+        将矩阵写入到 excel 文件中
+
+        参数:
+            file_path:                      要写入到哪个文件
+            file_obj:                       <openpyxl.Workbook> 文件对象
+                    注意！！以上两个参数指定其一即可，同时指定时候，以后者为准。
+            sheet_name:                     要写入到哪个sheet页面
+            matrix:                         <np.array or np.matrix> 矩阵
+            column_label_ls, row_label_ls:  行列标签
+            column_title, row_title:        行列标题
+            main_title:                     总标题
+    """
+    assert file_path is not None or file_obj is not None
+
+    if file_obj is None:
+        file_path = os.path.abspath(os.path.expanduser(file_path))
+        os.makedirs(os.path.dirname(file_path), exist_ok=True)
+        # 判断文件是否存在，不存在则新建，否则读取文件
+        if not os.path.isfile(file_path):
+            wb = openpyxl.Workbook()  # 创建文件对象
+            # wb对象创建后，默认含有一个默认的名为 Sheet 的 页面,将其删除
+            ws_ = wb.active
+            wb.remove(ws_)
+        else:
+            wb = openpyxl.load_workbook(file_path)
+    else:
+        assert isinstance(file_obj, openpyxl.Workbook)
+        wb = file_obj
+    # 判断sheet是否存在，不存在则建立，否则先删除再建立
+    if sheet_name in wb.sheetnames:
+        ws = wb[sheet_name]
+        wb.remove(ws)
+    ws = wb.create_sheet(sheet_name)
+
+    # 开始写
+    matrix_r_offset, matrix_c_offset = 1, 1  # 矩阵的起始位置
+    r_offset, c_offset = 1, 1  # 目前的写入位置
+    for i in [main_title, column_title, column_label_ls]:
+        if i:
+            matrix_r_offset += 1
+    for j in [row_title, row_label_ls]:
+        if j:
+            matrix_c_offset += 1
+    # print(matrix)
+    matrix_row_num, matrix_column_num = matrix.shape[0], matrix.shape[1]
+    # 标题
+    alignment = Alignment(horizontal="center", vertical="center", wrap_text=True)
+    if main_title:
+        ws.merge_cells(start_row=r_offset, start_column=1, end_row=r_offset,
+                       end_column=matrix_c_offset + matrix_column_num - 1)
+        ws.cell(row=r_offset, column=1).value = main_title
+        ws.cell(row=r_offset, column=1).alignment = alignment
+        ws.cell(row=r_offset, column=1).font = Font(size=10, bold=True, name='微软雅黑', color="000000")
+        r_offset += 1
+    if column_title:
+        ws.merge_cells(start_row=r_offset, start_column=matrix_c_offset, end_row=r_offset,
+                       end_column=matrix_c_offset + matrix_column_num - 1)
+        ws.cell(row=r_offset, column=matrix_c_offset).value = column_title
+        ws.cell(row=r_offset, column=matrix_c_offset).alignment = alignment
+        ws.cell(row=r_offset, column=matrix_c_offset).font = Font(size=10, bold=True, name='微软雅黑', color="000000")
+        r_offset += 1
+    if row_title:
+        ws.merge_cells(start_row=matrix_r_offset, start_column=1, end_row=matrix_r_offset + matrix_row_num - 1,
+                       end_column=1)
+        ws.cell(row=matrix_r_offset, column=1).value = row_title
+        ws.cell(row=matrix_r_offset, column=1).alignment = alignment
+        ws.cell(row=matrix_r_offset, column=1).font = Font(size=10, bold=True, name='微软雅黑', color="000000")
+        c_offset += 1
+    # 标签
+    if column_label_ls:
+        for i in range(matrix_column_num):
+            ws.cell(row=r_offset, column=matrix_c_offset + i).value = column_label_ls[i]
+            ws.cell(row=r_offset, column=matrix_c_offset + i).alignment = alignment
+            ws.cell(row=r_offset, column=matrix_c_offset + i).fill = PatternFill(patternType="solid",
+                                                                                 start_color="33CCFF")
+        r_offset += 1
+    if row_label_ls:
+        for i in range(matrix_row_num):
+            ws.cell(row=matrix_r_offset + i, column=c_offset).value = row_label_ls[i]
+            ws.cell(row=matrix_r_offset + i, column=c_offset).alignment = alignment
+            ws.cell(row=matrix_r_offset + i, column=c_offset).fill = PatternFill(patternType="solid",
+                                                                                 start_color="33CCFF")
+        c_offset += 1
+    # 校验，可省略
+    if not (c_offset == matrix_c_offset and r_offset == matrix_r_offset):
+        print("wrong here")
+    for r_ in range(matrix_row_num):
+        for c_ in range(matrix_column_num):
+            ws.cell(row=matrix_r_offset + r_, column=matrix_c_offset + c_).value = matrix[r_][c_]
+
+    if file_path is not None:
+        remove(file_path, ignore_errors=True)
+        wb.save(file_path)
+
+    return wb

{kevin-toolbox-dev-1.4.5 → kevin-toolbox-dev-1.4.6}/kevin_toolbox/data_flow/file/json_/read_json.py

@@ -23,6 +23,7 @@ def read_json(file_path=None, file_obj=None, converters=None, b_use_suggested_co
     """
     assert file_path is not None or file_obj is not None
     if file_path is not None:
+        file_path = os.path.abspath(os.path.expanduser(file_path))
         assert os.path.isfile(file_path), f'file {file_path} not found'
         file_obj = open(file_path, 'r')
     elif isinstance(file_obj, (BytesIO,)):

kevin-toolbox-dev-1.4.6/kevin_toolbox/env_info/__init__.py

@@ -0,0 +1,2 @@
+from .check_version_and_update import check_version_and_update
+from .check_validity_and_uninstall import check_validity_and_uninstall

kevin-toolbox-dev-1.4.6/kevin_toolbox/env_info/check_validity_and_uninstall.py

@@ -0,0 +1,49 @@
+import subprocess
+import time
+
+"""
+检查包
+- 若超过指定的有效期，则卸载。
+"""
+
+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-dev-1.4.6/kevin_toolbox/env_info/check_version_and_update.py

@@ -0,0 +1,72 @@
+import subprocess
+
+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:
+        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-dev-1.4.6/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-dev-1.4.6/kevin_toolbox/patches/for_os/find_files_in_dir.py

@@ -0,0 +1,35 @@
+import os
+from kevin_toolbox.patches.for_os import walk
+
+
+def find_files_in_dir(input_dir, suffix_ls=None, b_relative_path=True, b_ignore_case=True):
+    """
+        找出目录下带有给定后缀的所有文件的生成器
+            主要利用了 for_os.walk 中的过滤规则进行实现
+
+        参数：
+            suffix_ls:          <list/tuple of str> 可选的后缀
+            b_relative_path:    <bool> 是否返回相对路径
+            b_ignore_case:      <bool> 是否忽略大小写
+    """
+    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-dev-1.4.6/kevin_toolbox/patches/for_os/organize/__init__.py

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

kevin-toolbox-dev-1.4.6/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.6/kevin_toolbox_dev.egg-info/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.1
+Name: kevin-toolbox-dev
+Version: 1.4.6
+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
+Provides-Extra: plot
+Provides-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.6 （2025-01-24）【new feature】
+
+  - data_flow.file
+    - modify json_.read()，支持输入路径使用 ~ 表示家目录。
+    - 【new feature】add excel，该模块用于 excel 表格处理。
+      - write_with_matrix()：将矩阵写入到 excel 文件中
+
+  - patches.for_os
+    - modify find_files_in_dir()，支持 suffix_ls 设定 None 以表示不进行任何过滤。
+    - 【new feature】add organize，该模块用于文件整理。
+      - group_files_by_timestamp()：将 input_dir 中的文件按照时间戳信息进行分组，输出到 output_dir 中。
+    - 添加了对应的测试用例。
+  - env_info
+    - 【new feature】add check_validity_and_uninstall()，检查当前机器时间是否超过 expiration_timestamp 指定的有效期，若超过则卸载 package_name 对应的库。
+    - 【new feature】add check_version_and_update()，检查当前库的版本，并尝试更新。
+    - 以上函数均系从同名脚本中抽取出来。
+  - 以上修改，均已添加了对应的测试用例。
+  - developing
+    - 【new feature】add photo_album_organization，该模块包含一系列整理相册相关的脚本。
+      -  0_group_by_timestamp.py ：按照时间戳分组
+      -  1_merge_folders.py ：将文件数量较少的目录合并
+
+