kevin-toolbox-dev 1.4.10__py3-none-any.whl → 1.4.11__py3-none-any.whl

kevin_toolbox/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.4.10"
+__version__ = "1.4.11"
 
 
 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 1759927714 --verbose 0'
+    f'--expiration_timestamp 1760340881 --verbose 0'
 )

kevin_toolbox/computer_science/algorithm/for_seq/sample_subset_most_evenly.py

@@ -26,7 +26,9 @@ def sample_subset_most_evenly(inputs, ratio=None, nums=None, seed=None, rng=None
                         仅在b_shuffle_the_tail=True时，以上两个参数起效，且仅需指定一个即可。
 
     """
-    nums = nums or math.ceil(len(inputs) * ratio)
+    if nums is None:
+        assert ratio is not None
+        nums = math.ceil(len(inputs) * ratio)
     assert nums >= 0
     if len(inputs) == 0 or nums == 0:
         return []

kevin_toolbox/computer_science/algorithm/redirector/redirectable_sequence_fetcher.py

@@ -10,8 +10,8 @@ def _randomly_idx_redirector(idx, seq_len, attempts, rng, *args):
     elif idx == seq_len - 1:
         return rng.randint(0, seq_len - 2)
     else:
-        return rng.choices([rng.randint(0, idx - 1), rng.randint(idx + 1, seq_len - 1)],
-                           weights=[idx, seq_len - idx - 1])[0]
+        return rng.choice([rng.randint(0, idx - 1), rng.randint(idx + 1, seq_len - 1)], size=1,
+                          p=[idx / (seq_len - 1), (seq_len - idx - 1) / (seq_len - 1)])[0]
 
 
 idx_redirector_s = {

kevin_toolbox/nested_dict_list/get_nodes.py

@@ -21,6 +21,15 @@ def get_nodes(var, level=-1, b_strict=True, **kwargs):
                                             对于 level=-10 返回的是 [('', {'d': {'c': 4}, 'c': 4}), ]
                                             对于 level=10 返回的是 [(':c', 4), (':d:c', 4)]
                                     默认为 True，不添加。
+
+        注意：
+            当 level 为负数（表示从叶节点往上计起）时，某些节点可能同时属于多个 level，比如对于：
+                {'d': {'c': [1, ], 'e': 4}},
+            其中：
+                level=-1:       :d:e, :d:c@0
+                level=-2:       :d, :d:c
+                level=-3:       "", :d
+            可以看到由于 :d 下面有两个不等长的到不同叶节点的路径，因此该节点属于 level -2 和 -3
     """
     assert isinstance(level, (int,))
     kwargs.setdefault("b_skip_repeated_non_leaf_node", False)

kevin_toolbox/nested_dict_list/value_parser/replace_identical_with_reference.py

@@ -44,7 +44,7 @@ def _forward(var, flag, match_cond):
             if not match_cond(name, value):
                 continue
             id_to_name_s[id(value)].add(name)
-            id_to_height_s[id(value)].add(height)
+            id_to_height_s[id(value)] = height
         height += 1
 
     #
@@ -54,10 +54,8 @@ def _forward(var, flag, match_cond):
             id_to_height_s.pop(k)
             id_to_name_s.pop(k)
             continue
-        # 具有相同 id 的节点所处的高度应该相同
-        assert len(v) == 1, f'nodes {id_to_name_s[k]} have different heights: {v}'
     # 按高度排序
-    id_vs_height = sorted([(k, v.pop()) for k, v in id_to_height_s.items()], key=lambda x: x[1], reverse=True)
+    id_vs_height = sorted([(k, v) for k, v in id_to_height_s.items()], key=lambda x: x[1], reverse=True)
 
     # 从高到低，依次将具有相同 id 的节点替换为 单个节点和多个引用 的形式
     temp = []

kevin_toolbox_dev-1.4.11.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.1
+Name: kevin-toolbox-dev
+Version: 1.4.11
+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.11 （2025-04-16）【bug fix】
+
+  - nested_dict_list
+    - 【bug fix】fix bug in value_parser.replace_identical_with_reference()
+      - bug 描述：该函数的 _forward 中是通过 get_nodes 来获取各层节点，并记录节点的 id 和 level，这就导致某些节点由于其下具有不同长度的到叶节点的路径，因此节点会同时属于多个 level，最终导致其在 id_to_height_s 中被记录为有多个高度，这进一步导致其无法通过后面“具有相同 id 的节点所处的高度应该相同”的检验条件。
+      - 解决：
+        - 修复了 replace_identical_with_reference() 中的 _forward 部分，仅记录每个节点的最大高度。
+        - 去除了“具有相同 id 的节点所处的高度应该相同”的检验条件。
+  - computer_science.algorithm.redirector
+    - 【bug fix】fix bug in Redirectable_Sequence_Fetcher，将 _randomly_idx_redirector 中的 rng.choices 改为 rng.choice
+  - 添加了对应的测试用例。
+
+
+

{kevin_toolbox_dev-1.4.10.dist-info → kevin_toolbox_dev-1.4.11.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kevin_toolbox/__init__.py,sha256=F2sq6sGyi7Ica2QHv67hQcuUXw3f0gLDHErp5V2Ht1k,411
+kevin_toolbox/__init__.py,sha256=QgB7rTrMyf-WE-6vB_Nt1ig3DQxhws4AkxxslqumqB4,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/cache_manager/__init__.py,sha256=xKWoGhpgrgWbU1newrK7PKIoVsSSOyvcAHUP3cbAd3I,108
@@ -37,7 +37,7 @@ kevin_toolbox/computer_science/algorithm/for_seq/__init__.py,sha256=FAEKFljPU72c
 kevin_toolbox/computer_science/algorithm/for_seq/chunk_generator.py,sha256=xlg-ykyheKmZ-Xo6ETGhm5cj5N8s0VRuUaE1XqrI3Nk,2544
 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/for_seq/sample_subset_most_evenly.py,sha256=KcCg5mLTBthvWV_Hglp0J_mNSqzwVQBqNPz_c44cCMY,2473
+kevin_toolbox/computer_science/algorithm/for_seq/sample_subset_most_evenly.py,sha256=nM5vC5mH2G0fRytarPPle5Ypk_PKU0MXnQiAIjeoRZE,2523
 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=bIyMaB3v6JFjkrY7-sg_-yAnFH8I53E2qxIhGprcLzo,112
@@ -51,7 +51,7 @@ kevin_toolbox/computer_science/algorithm/pareto_front/__init__.py,sha256=F1uD0ZT
 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
 kevin_toolbox/computer_science/algorithm/redirector/__init__.py,sha256=eeHQnV6qY5_2O3Xhn7Dl4YHaSI5HnAi9Nuyq65qgoow,73
-kevin_toolbox/computer_science/algorithm/redirector/redirectable_sequence_fetcher.py,sha256=-edUnGw4GNqKOCQUnOSi-p8ZxoQgahmel1LwFV8QEgk,12435
+kevin_toolbox/computer_science/algorithm/redirector/redirectable_sequence_fetcher.py,sha256=UgWhEvKrEaMbopsQ3vE1c151ReqJmkVvstIoAMC0Wds,12469
 kevin_toolbox/computer_science/algorithm/registration/__init__.py,sha256=w9CHaFB1rIfIAiKrSXePwdhjN8kaRrxxdBwjJ7S2aWk,152
 kevin_toolbox/computer_science/algorithm/registration/registry.py,sha256=X1I04ZO2lTE36TjvJ1tcepl7xXD0OJWCA82RDsoENvA,17734
 kevin_toolbox/computer_science/algorithm/registration/serializer_for_registry_execution.py,sha256=a-bsb1JCc0rfHhz1mCua-5NWYu-lx4kPY9Ubp5MKUVU,3156
@@ -252,7 +252,7 @@ kevin_toolbox/nested_dict_list/__init__.py,sha256=ALcn1tYdBdDWUHyIQj588UfHgrAwbU
 kevin_toolbox/nested_dict_list/copy_.py,sha256=iS8P4JZ4SyBwZksObt2t1e4p0tXrsUu9NRtmjifjX5Q,6256
 kevin_toolbox/nested_dict_list/count_leaf_node_nums.py,sha256=l67u47EvO1inoGinUqH6RZ7cHXwN0VcBQPUvSheqAvA,614
 kevin_toolbox/nested_dict_list/get_hash.py,sha256=Ygadnn5dnvIeE-9t39p2EwNKNRLzomL37ZsRD5daXxo,1286
-kevin_toolbox/nested_dict_list/get_nodes.py,sha256=3NJ2BPhNLr6hgooo-dOXLHZ6c-XjqOersLgTwTTXqbE,3831
+kevin_toolbox/nested_dict_list/get_nodes.py,sha256=lyvKf_Q1-RQpEPGwwIU5ymq1KEnGpBQ0foHtxkqFYT4,4305
 kevin_toolbox/nested_dict_list/get_value.py,sha256=IiAqQCphyv-pAZWuQRWm0anEwxYQOkC9CttY5ZlUbSs,2389
 kevin_toolbox/nested_dict_list/set_default.py,sha256=laSgGP1CbApNgFB9HZGCtxCG9fe7u1C-YOx9ZCoHJms,3460
 kevin_toolbox/nested_dict_list/set_value.py,sha256=AQ4foDtKo4JxyR---of-VSxjhRWfqkv6TrnQ4EoRo3M,3711
@@ -283,7 +283,7 @@ kevin_toolbox/nested_dict_list/value_parser/cal_relation_between_references.py,s
 kevin_toolbox/nested_dict_list/value_parser/eval_references.py,sha256=YQyOm3awKVRusXxSNObjJ2yPf0oE4gleobOn_RN_nzU,2301
 kevin_toolbox/nested_dict_list/value_parser/parse_and_eval_references.py,sha256=RQEDFFNAhQQcX9H8curwja-pI2gKZlVx4M2qeneBOhA,2370
 kevin_toolbox/nested_dict_list/value_parser/parse_references.py,sha256=G470xNzrRpYlS5To8R5yV0M6nX4iE5LLMp_eV49bh3Y,2116
-kevin_toolbox/nested_dict_list/value_parser/replace_identical_with_reference.py,sha256=yTOZ0-8ZKbO7bS1jCvTZyLtS8OOvaalVG0O3arJa8NY,5349
+kevin_toolbox/nested_dict_list/value_parser/replace_identical_with_reference.py,sha256=BsZlgCNm2n4Gd4PeC2TlKRb4QOApIC0TRSgDtI5SBLI,5194
 kevin_toolbox/network/__init__.py,sha256=wOY_SKvbxzIIH_OFccMw3-LVUwZQwz8BTb82ht88JHA,346
 kevin_toolbox/network/download_file.py,sha256=hW6DbdKPWcVqkG8U7NK2bwwubPtmaPHp3ftfuAjMNgI,6896
 kevin_toolbox/network/fetch_content.py,sha256=WjpwZ_7pyfrAAmxNyHMu3onkbucELnHKYXDBM1fSSEY,2167
@@ -378,7 +378,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.10.dist-info/METADATA,sha256=bjCQmlBluzA-kTrLH7Vxu3njxWMk-9HRyRgTbA_MmCI,4748
-kevin_toolbox_dev-1.4.10.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
-kevin_toolbox_dev-1.4.10.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
-kevin_toolbox_dev-1.4.10.dist-info/RECORD,,
+kevin_toolbox_dev-1.4.11.dist-info/METADATA,sha256=ZoZzPSqonbtCcRi5rRt6On5gcycPa-eS2JDFsp65iEU,2294
+kevin_toolbox_dev-1.4.11.dist-info/WHEEL,sha256=G16H4A3IeoQmnOrYV4ueZGKSjhipXx8zc8nu9FGlvMA,92
+kevin_toolbox_dev-1.4.11.dist-info/top_level.txt,sha256=S5TeRGF-PwlhsaUEPTI-f2vWrpLmh3axpyI6v-Fi75o,14
+kevin_toolbox_dev-1.4.11.dist-info/RECORD,,

kevin_toolbox_dev-1.4.10.dist-info/METADATA

@@ -1,106 +0,0 @@
-Metadata-Version: 2.1
-Name: kevin-toolbox-dev
-Version: 1.4.10
-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.10 （2025-04-11）【new feature】【bug fix】
-
-  - patches.for_logging
-    - modify build_logger() to allow parameter level to accept str input，允许参数 level 接受str输入，比如“DEBUG”或者“INFO”。
-    
-  - computer_science.algorithm
-    - cache_manager
-      - 【new feature】add load_state_dict(), state_dict() to Cache_Base, Memo_Cache, Cache_Manager ，增加加载和保存状态的相关接口。
-      - add Cache_Manager_wto_Strategy，新增一个不绑定任何策略的缓存管理器，可以视为容量无上限的特殊情况
-      - refactor Cache_Manager，基于 Cache_Manager_wto_Strategy 对 Cache_Manager 代码进行简化和重构。
-    - 【new feature】redirector
-      - 该新增模块包含重定向功能的函数和类。所谓重定向，其本质是：**原目标失效或不合适时，自动转向一个新的目标，以保证流程不中断或获得正确结果**。
-      - add Redirectable_Sequence_Fetcher，用于从给定 seq 中获取元素，可以通过自动跳转来处理获取失败的情况。
-        - 功能描述：
-          1. 对于给定的索引 idx，若能通过 seq(idx) 成功获取，则直接返回获取的结果。
-          2. 若不能成功获取，则会根据给定的规则修改索引（如idx-1）重新尝试获取，递归调用直至获取成功或者递归调用次数达到上限。
-             1. 若不能成功获取，则会根据给定的规则修改索引（如idx-1）重新尝试获取，递归调用直至获取成功或者递归调用次数达到上限。
-             2. 当失败次数达到上限后，则不再进行尝试并直接返回重新向后的新的 idx 的结果。
-             3. 若在此过程中原来失败的 idx 又能再次获取成功，则将失败次数减1，直至归零并删除该记录。
-          3. 若递归次数达到上限，则进行报错或者返回给定的默认值。
-             1. 若开启了跳转记忆功能，在重试过程中，一旦某次调用成功，记录原始索引与最终有效索引之间的映射关系。
-      - 添加了对应的测试用例。
-    - for_seq
-      - 【new feature】add sample_subset_most_evenly()，对列表按给定比例or数量进行采样，并返回一个新的列表，同时保证列表中每个元素在新列表中的占比尽量相近。
-    - redirector
-      - 【new feature】modify Redirectable_Sequence_Fetcher，增加了 seed 参数并在 state_dict 中增加 rng_state 项，以便控制（保存和重现）随机行为。
-    - 【new feature】sampler
-      - 该新增模块包含采样相关的函数和类。
-      - add Reservoir_Sampler，水库采样器。
-    
-  - data_flow.file.kevin_notation
-  
-    - 【bug fix】fix bug in Kevin_Notation_Reader and Kevin_Notation_Writer
-  
-      - bug 原因：由于之前的版本默认启用"//"作为注释符号，因此导致无法正确读取带有"//"的值
-  
-      - 解决：在 Kevin_Notation_Reader 和 Kevin_Notation_Writer 取消默认使用注释，并限定只有在 metadata 中显式指定注释标志符才会启用
-  
-      - 注意：该修改可能导致原本带有注释的旧版本 .kvt 文件无法被正确读取，遇到该情况时，可以尝试将`# --metadata--`部分修改为：
-  
-        ```text
-        # --metadata--
-        # sep
-        	
-        # comment_flag
-        //
-        ...
-        ```
-  
-    - 添加了对应的测试用例。
-
-
-