vools 0.4.0__tar.gz → 0.4.2__tar.gz

{vools-0.4.0/vools.egg-info → vools-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vools
-Version: 0.4.0
+Version: 0.4.2
 Summary: Python 函数式编程工具集
 Author-email: Victor <victortop921129@gmail.com>
 License: Apache License

{vools-0.4.0 → vools-0.4.2}/pyproject.toml

@@ -86,33 +86,24 @@ exclude = ["vools.__pycache__", "vools.*.__pycache__"]
 version = { attr = "vools.__version__" }
 
 [tool.setuptools.package-data]
-"vools" = ["config.template.py", "*.md", "lib/*.dll", "lib/*.so", "lib/windows/*.dll", "lib/linux/*.so", "lib/**/*.so"]
+"vools" = [
+    "config.template.py",
+    "*.md",
+    "lib/*.dll",
+    "lib/*.so",
+    "lib/windows/*.dll",
+    "lib/linux/*.so",
+    "xl/_dlls/*.dll",
+]
 
 # ============ pytest ============
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-# 默认只运行根级测试（失败/未归档的测试）
-# 通过的测试已归档到子目录：core/data/datetime/decorators/functional/reactive/curried/oop/bridge/serialize/task/other
-# 如需运行全部归档测试，使用: pytest tests/core/ 或 pytest tests/reactive/
-ignore = [
-    "tests/core",
-    "tests/data",
-    "tests/datetime",
-    "tests/decorators",
-    "tests/functional",
-    "tests/reactive",
-    "tests/curried",
-    "tests/oop",
-    "tests/bridge",
-    "tests/serialize",
-    "tests/task",
-    "tests/other",
-    "tests/monitoring",
-    "tests/__rust__",
-    "tests/__persist__",
-    "tests/__pycache__",
-]
-addopts = "--tb=short -q"
+# 默认运行纯 Python 核心测试：functional, decorators, data, curried, oop, core, serialize, task, datetime, utils, reactive（不含 monitoring）
+# 默认不运行（需要外部资源/平台特定）：bridge, dll32, xl, monitoring, reactive/monitoring, benchmarks, archive, other
+# 如需运行全部测试，使用: pytest --override-ini="addopts=--tb=short -q"
+# 如需运行特定子目录，使用: pytest tests/bridge/ 或 pytest tests/reactive/
+addopts = "--tb=short -q --ignore=tests/bridge --ignore=tests/dll32 --ignore=tests/xl --ignore=tests/monitoring --ignore=tests/reactive/monitoring --ignore=tests/benchmarks --ignore=tests/archive --ignore=tests/other --ignore=tests/__rust__ --ignore=tests/__persist__ --ignore=tests/__pycache__"
 markers = [
     "integration: 标记集成测试（依赖外部资源，如剪贴板、文件系统、键鼠）",
     "windows_only: 仅在 Windows 上可运行的测试",

{vools-0.4.0 → vools-0.4.2}/tests/__init__.py

@@ -4,9 +4,3 @@
 注意：测试文件已按子包归档到子目录。
 通过 pytest 运行测试时，pytest 会自动发现所有 test_*.py 文件。
 """
-
-import sys
-import os
-
-# 将 vools 包根目录加入 path
-sys.path.insert(0, os.path.dirname(os.path.dirname(__file__)))

{vools-0.4.0 → vools-0.4.2}/vools/__init__.py

@@ -7,7 +7,7 @@ vools - Python 函数式编程工具集
 import importlib
 from typing import Any
 
-__version__ = "0.4.0"
+__version__ = "0.4.2"
 __author__ = "Victor"
 __license__ = "Apache 2.0"
 
@@ -524,35 +524,3 @@ if _sys.version_info < (3, 7):
     except Exception:
         pass
 
-if __name__ == '__main__':
-    print(f"vools version: {__version__}")
-    print(f"Available exports: {len(__all__)} items")
-
-    @memorize(duration=5)
-    def expensive_function(x):
-        return x ** 2
-
-    print(f"expensive_function(5) = {expensive_function(5)}")
-    print(f"expensive_function(5) = {expensive_function(5)} (cached)")
-
-    print("\n=== 测试 once ===")
-
-    @once
-    def initialize():
-        print("Initializing...")
-        return 42
-
-    print(f"initialize() = {initialize()}")
-    print(f"initialize() = {initialize()} (cached)")
-
-    print("\n=== 测试 iif ===")
-
-    result = iif(True, "yes", "no")
-    print(f"iif(True, 'yes', 'no') = {result}")
-
-    print("\n=== 测试 g ===")
-
-    f = g("x, y => x + y")
-    print(f"g('x, y => x + y')(3, 4) = {f(3, 4)}")
-
-    print("\n所有测试通过!")

{vools-0.4.0 → vools-0.4.2}/vools/bridge/julia/compiler.py

@@ -1,4 +1,4 @@
-"""
+"""
 vools.bridge.julia.compiler - Julia 代码编译
 
 提供 Julia 代码编译为共享库的功能，包括：
@@ -36,10 +36,9 @@ _JULIA_COMPILER = 'julia'
 
 # 常用 PATH 搜索
 _JULIA_SEARCH_PATHS_WINDOWS = [
-    r"C:\Users\victo\AppData\Local\Programs\Julia-1.11.0\bin",
+    os.path.expanduser(r"~\AppData\Local\Programs\Julia-1.11.0\bin"),
     r"C:\Program Files\Julia-1.11.0\bin",
-    r"C:\Users\victo\AppData\Local\Microsoft\WindowsApps",
-    os.path.expanduser("~/AppData/Local/Programs/Julia-1.11.0/bin"),
+    os.path.expanduser(r"~\AppData\Local\Microsoft\WindowsApps"),
 ]
 _JULIA_SEARCH_PATHS_UNIX = [
     "/home/julia/bin",

{vools-0.4.0 → vools-0.4.2}/vools/bridge/manager.py

@@ -899,7 +899,7 @@ def _register_builtin_languages():
     if _IS_WINDOWS:
         nim_paths = [
             os.environ.get('NIM_PATH'),
-            r'C:\Users\victo\.codearts-cpp\tools\mingw\bin',
+            os.path.expanduser(r'~\.codearts-cpp\tools\mingw\bin'),
             r'C:\Program Files\Nim\bin',
             r'C:\nim\bin',
             os.path.join(os.path.dirname(__file__), '..', '..', 'nim', 'bin'),
@@ -908,7 +908,7 @@ def _register_builtin_languages():
     else:
         nim_paths = [
             os.environ.get('NIM_PATH'),
-            '/home/vic/nim-2.2.10/bin',
+            os.path.expanduser('~/nim-2.2.10/bin'),
             '/opt/nim/bin',
             '/usr/local/bin',
             '/usr/bin',
@@ -1021,9 +1021,9 @@ def _register_builtin_languages():
     julia_paths = []
     if _IS_WINDOWS:
         julia_paths = [
-            r'C:\Users\victo\AppData\Local\Programs\Julia-1.11.0\bin',
+            os.path.expanduser(r'~\AppData\Local\Programs\Julia-1.11.0\bin'),
             r'C:\Program Files\Julia-1.11.0\bin',
-            r'C:\Users\victo\AppData\Local\Microsoft\WindowsApps',
+            os.path.expanduser(r'~\AppData\Local\Microsoft\WindowsApps'),
             os.path.expanduser('~/AppData/Local/Programs/Julia-1.11.0/bin'),
         ]
     else:
@@ -1148,7 +1148,7 @@ def _register_builtin_languages():
     mojo_paths = []
     if _IS_WINDOWS:
         mojo_paths = [
-            r'C:\Users\victo\.modular\mojo',
+            os.path.expanduser(r'~\.modular\mojo'),
             os.path.expanduser('~\\.modular\\mojo'),
         ]
     else:

{vools-0.4.0 → vools-0.4.2}/vools/bridge/probe.py

@@ -877,7 +877,7 @@ COMMON_INSTALL_PATHS: Dict[str, List[str]] = {
         r'C:\MinGW\bin',
         r'C:\msys64\mingw64\bin',
         r'C:\Program Files\LLVM\bin',
-        r'C:\Users\victo\.codearts-cpp\tools\mingw\bin',
+        os.path.expanduser(r'~\.codearts-cpp\tools\mingw\bin'),
         '/usr/bin',
         '/usr/local/bin',
     ],
@@ -885,14 +885,14 @@ COMMON_INSTALL_PATHS: Dict[str, List[str]] = {
         r'C:\MinGW\bin',
         r'C:\msys64\mingw64\bin',
         r'C:\Program Files\LLVM\bin',
-        r'C:\Users\victo\.codearts-cpp\tools\mingw\bin',
+        os.path.expanduser(r'~\.codearts-cpp\tools\mingw\bin'),
         '/usr/bin',
         '/usr/local/bin',
     ],
     'rust': [
         os.path.expanduser(r'~\.cargo\bin'),
         r'C:\Program Files\Rust\.cargo\bin',
-        r'C:\Users\victo\.rustup\toolchains\stable-x86_64-pc-windows-msvc\bin',
+        os.path.expanduser(r'~\.rustup\toolchains\stable-x86_64-pc-windows-msvc\bin'),
         os.path.expanduser('~/.cargo/bin'),
         '/usr/local/cargo/bin',
         '/usr/bin',
@@ -909,10 +909,10 @@ COMMON_INSTALL_PATHS: Dict[str, List[str]] = {
         os.environ.get('NIM_PATH', ''),
         r'C:\Program Files\Nim\bin',
         r'C:\nim\bin',
-        r'C:\Users\victo\.choosenim\toolchains\stable\bin',
-        r'C:\Users\victo\.codearts-cpp\tools\mingw\bin',
+        os.path.expanduser(r'~\.choosenim\toolchains\stable\bin'),
+        os.path.expanduser(r'~\.codearts-cpp\tools\mingw\bin'),
         os.path.join(os.path.dirname(os.path.dirname(__file__)), '..', '..', 'nim', 'bin'),
-        '/home/vic/nim-2.2.10/bin',
+        os.path.expanduser('~/nim-2.2.10/bin'),
         '/opt/nim/bin',
         '/usr/local/bin',
         '/usr/bin',
@@ -963,10 +963,9 @@ COMMON_INSTALL_PATHS: Dict[str, List[str]] = {
         '/usr/share/dotnet',
     ],
     'julia': [
-        r'C:\Users\victo\AppData\Local\Programs\Julia-*\bin',
-        r'C:\Program Files\Julia-*\bin',
-        r'C:\Users\victo\AppData\Local\Microsoft\WindowsApps',
         os.path.expanduser(r'~\AppData\Local\Programs\Julia-*\bin'),
+        r'C:\Program Files\Julia-*\bin',
+        os.path.expanduser(r'~\AppData\Local\Microsoft\WindowsApps'),
         '/home/julia/bin',
         '/usr/local/julia/bin',
         '/opt/julia/bin',
@@ -989,7 +988,6 @@ COMMON_INSTALL_PATHS: Dict[str, List[str]] = {
         '/opt/R/bin',
     ],
     'mojo': [
-        r'C:\Users\victo\.modular\mojo\bin',
         os.path.expanduser(r'~\.modular\mojo\bin'),
         os.path.expanduser('~/.modular/mojo/bin'),
         '/opt/mojo/bin',
@@ -997,7 +995,7 @@ COMMON_INSTALL_PATHS: Dict[str, List[str]] = {
     ],
     'python': [
         r'C:\Python*\python.exe',
-        r'C:\Users\victo\AppData\Local\Programs\Python\Python*\python.exe',
+        os.path.expanduser(r'~\AppData\Local\Programs\Python\Python*\python.exe'),
         '/usr/bin',
         '/usr/local/bin',
     ],

{vools-0.4.0 → vools-0.4.2}/vools/cache/memorize.py

@@ -169,23 +169,3 @@ def memorize(func: Optional[Callable] = None, *, duration: float = 3) -> Callabl
         # @memorize 直接调用
         return decorator(func)
 
-
-if __name__ == '__main__':
-    print("=== 测试 memorize ===")
-    
-    @memorize
-    def test_func1():
-        return time.time()
-    
-    for i in range(5):
-        print(f"调用 {i}: {test_func1()}")
-        time.sleep(0.5)
-    
-    @memorize(duration=2)
-    def test_func2():
-        return time.time()
-    
-    print("\n测试 duration 参数:")
-    for i in range(5):
-        print(f"调用 {i}: {test_func2()}")
-        time.sleep(0.5)

{vools-0.4.0 → vools-0.4.2}/vools/cache/persist.py

@@ -303,63 +303,3 @@ def persist(func: Optional[Callable] = None,
         # @persist 直接调用
         return decorator(func)
 
-
-if __name__ == '__main__':
-    print("=== 测试 persist ===")
-    
-    @persist
-    def fetch_weather(city: str, api_key: str = "default"):
-        import random
-        print(f"[执行] 正在获取 {city} 的天气...")
-        time.sleep(1)
-        return random.randint(20, 30)
-
-    temp = fetch_weather("Beijing", file_key="weather_beijing")
-    print(temp)
-
-    temp = fetch_weather("Beijing", file_key="weather_beijing")
-    print(temp)
-
-    temp = fetch_weather("Beijing", file_key="weather_beijing", force=True)
-    print(temp)
-
-    for i in range(20):
-        temp = fetch_weather(
-            "Beijing",
-            file_key="weather_beijing",
-            force_when=lambda result, start, end: time.time() - end > 5 or result > 27
-        )
-        print(temp)
-        time.sleep(1)
-    
-    print("\n=== 测试 persist 指定缓存目录 ===")
-    
-    import tempfile
-    import shutil
-    
-    temp_dir = tempfile.mkdtemp()
-    print(f"临时缓存目录: {temp_dir}")
-    
-    @persist
-    def fetch_data(city: str):
-        import random
-        print(f"[执行] 正在获取 {city} 的数据...")
-        time.sleep(0.5)
-        return random.randint(100, 200)
-    
-    data = fetch_data("Shanghai", file_key="data_shanghai", target_folder=temp_dir)
-    print(data)
-    
-    expected_cache_path = os.path.join(temp_dir, "data_shanghai.json")
-    if os.path.exists(expected_cache_path):
-        print(f"✓ 缓存文件已正确保存到指定目录: {expected_cache_path}")
-    else:
-        print(f"✗ 缓存文件未保存到指定目录")
-    
-    data = fetch_data("Shanghai", file_key="data_shanghai", target_folder=temp_dir)
-    print(data)
-    
-    shutil.rmtree(temp_dir)
-    print(f"✓ 临时目录已清理: {temp_dir}")
-    
-    print("\n所有测试通过!")

{vools-0.4.0 → vools-0.4.2}/vools/data/itor.py

@@ -785,39 +785,6 @@ class Itor:
             self._history_tail = node
 
 
-if __name__ == '__main__':
-    # 示例 1：普通迭代 + 暂停/插队/重启（在副本上操作，不影响原实例）
-    # 注意：插队 99 已被加入 gen 的历史，因此 restart 会先重放 [1, 2, 99]
-    itor = Itor([1, 2, 3, 4, 5])
-    gen = itor()
-    print("basic:", next(gen), next(gen))  # 1, 2
-    gen.send(Node(99))
-    print("jump:", next(gen))               # 99
-    gen.restart()
-    print("restart:", list(gen))            # [1, 2, 99, 3, 4, 5]
-    print("gen state:", gen.state.name)     # STOPPED
-    print("original state:", itor.state.name)  # PENDING（原实例未被影响）
-
-    # 示例 2：使用类方法设置历史保留策略
-    itor2 = Itor([1, 2, 3, 4, 5])
-    Itor.set_history_max(itor2, 3)
-    gen2 = itor2()
-    print("full:", list(gen2))             # [1, 2, 3, 4, 5]
-    gen2.restart()
-    print("last 3:", list(gen2))           # [3, 4, 5]
-
-    # 示例 3：条件插队
-    itor3 = Itor([1, 2, 3, 4, 5])
-    gen3 = itor3()
-    gen3.send(Node(88), jump_when=lambda it: it._history_tail and it._history_tail.val == 2)
-    print("conditional:", list(gen3))      # [1, 2, 88, 3, 4, 5]
-
-    # 示例 4：直接迭代和 next()（使用原实例本身）
-    itor4 = Itor([10, 20, 30])
-    print("iter direct:", list(itor4))         # [10, 20, 30]
-    itor5 = Itor([7, 8, 9])
-    print("next direct:", next(itor5), next(itor5))  # 7, 8
-
 
 # 向后兼容别名：旧代码中直接使用 State 仍可用，但推荐改用 ItorState
 State = ItorState

{vools-0.4.0 → vools-0.4.2}/vools/data/seq.py

@@ -1378,102 +1378,3 @@ def collect(xs,f=None,factory=Seq) :
             if lmd(fx):
                 yield fx
     return factory(gen()) if factory is not None else gen()
-
-
-if __name__ == '__main__':      
-    s = Seq(range(10)) 
-    for i in s[3:7]:
-        print(i,end=',')
-    else:
-        print()
-    from random import randint
-    
-    s1 = Seq.from_callable(lambda : randint(1, 3),lambda x : x == 2)
-    print(s.take(4),s.take(7))
-    print(list(s.skip(3)))
-    z = Seq(s.zip_longest(range(3),fillvalue = randint(1, 100)))
-    print(list(z.flatten()))
-    print(list(s.flatmap_ex(lambda x : ( x % 2,(x,randint(1,10))))))
-    
-    print(_pipe(lambda x:x+1,lambda x:x*2)(3))
-    
-    k = s.map(lambda x:x+1).filter(lambda x:x%2==0).map(lambda x:x*2)
-    print(k.collect(),k.reduce(lambda x,y:x+y,0))
-    
-    data = [1,2,3,4,5,6,7,8,9,10]
-    data = zip_longest(data,data[::-1],data,data[::-2],fillvalue=0)
-    data = Seq(data).flatmap_ex(lambda x : (1,[*x,randint(1,10)])).reduce_by(None,lambda x,y:x+y - x*y)
-    d = data.take_while(lambda x:x[1]<5).collect()
-    print(d)
-    
-    
-    print(Seq(range(10)).grouper(3,'c').collect())
-    
-    
-    def gen():
-        if not hasattr(gen,'n'):
-            gen.n = -1
-        gen.n += 1
-        return gen.n
-    
-
-    def join(s):
-        return ','.join(str(i) for i in s)
-    
-    c = Seq.cycle(gen,10) >> (lambda x:x*2 ) >> (lambda x:x+1 if x > 5 else NONE) 
-    print(c.collect(),c.tee(3).collect())
-    
-    print(c | join)
-    # print(c.tee(3) | Seq.flatmap | join)
-
-    class A:
-        def __init__(self,x):
-            self.x = x
-        @Seq.ensure_seq
-        def gen(self):
-            while True:
-                self.x += 1
-                yield randint(1, 100) + self.x
-    
-
-        def do(self, f=print, pre_f=None, sub_f=None):
-            """Apply a function for side effects, return self.
-
-            Args:
-                f: Function to apply (default print)
-                pre_f: Pre-processing function
-                sub_f: Post-processing function (no return value expected)
-
-            Returns:
-                self, for chaining
-            """
-            rs = self
-            if pre_f:
-                rs = pre_f(rs)
-            rs = f(rs)
-            if sub_f:
-                sub_f(rs)
-            return self
-        def register(self, func):
-            @wraps(func)
-            def _inner(self,*args, **kwargs):
-                return func(self,*args, **kwargs)
-            setattr(self,func.__name__,_inner)
-            return _inner
-    a = A(0)
-    print(a.gen().take(5,True))
-    
-    def f(x):
-        print(x,'registeed')
-    
-    a.register(f)
-    a.f('sd')
-    
-    s = Seq.from_callable(_+1,0)
-
-    s = s.take_while(_<=10)
-    # s = s.take(30)
-    print(s)
-
-    # s = Seq(f()).take_while(_>3)
-    # print(s.collect())

{vools-0.4.0 → vools-0.4.2}/vools/datetime/dates_format.py

@@ -1001,143 +1001,3 @@ class EnhancedDateFormatter:
         """对象表示"""
         return f"EnhancedDateFormatter(template={self.template!r}, run_date={self.date_processor.run_date_compact})"
 
-
-# 使用示例
-if __name__ == "__main__":
-    print("=" * 60)
-    print("EnhancedDateFormatter 使用示例")
-    print("=" * 60)
-    
-    print("\n1. 基本使用示例:")
-    print("-" * 40)
-    
-    formatter = EnhancedDateFormatter("""
-run_date: {run_date}
-run_date_std: {run_date_std}
-run_date-3: {run_date-3}
-run_date_std+3: {run_date_std+3}
-run_week_begin:{run_week_begin}
-run_week_end:{run_week_end}
-run_week_begin-3:{run_week_begin-3}
-run_week_end+3:{run_week_end+3}
-run_month_begin-3:{run_month_begin-3}
-run_month_end+3:{run_month_end+3}
-run_month_begin:{run_month_begin}
-run_month_end:{run_month_end}
-run_week+3&3: {run_week+3&3}
-run_week-3&5: {run_week-3&5}
-run_month+3&13: {run_month+3&13}
-run_month+2&31: {run_month+2&31}
-run_month-3&1: {run_month-3&1}
-run_month-3&31: {run_month-3&31}
-run_week_std+3&3: {run_week_std+3&3}
-run_month_std+2&31: {run_month_std+2&31}
-run_days<12:{run_days<12}
-run_weeks<12&7:{run_weeks<12&7}
-run_months<12&31:{run_months<12&31}
-run_days_std<12:{run_days_std<12}
-run_weeks_std<12&7:{run_weeks_std<12&7}
-run_months_std<12&31:{run_months_std<12&31}
-""", default_run_date='20260403')
-
-    print(formatter.format())
-    
-    print("\n2. 日期列表示例:")
-    print("-" * 40)
-    
-    formatter2 = EnhancedDateFormatter("""
-天列表（往后3天）: {run_days>3}
-天列表（往前3天，标准格式）: {run_days_std<3}
-周列表（往后3周，每周3）: {run_weeks>3&3}
-周列表（往前3周，每周5，标准格式）: {run_weeks_std<3&5}
-月列表（往后3月，每月13号）: {run_months>3&13}
-月列表（往后3月，每月31号）: {run_months>3&31}
-月列表（往前3月，每月1号）: {run_months<3&1}
-月列表（往前3月，每月31号，标准格式）: {run_months_std<3&31}
-""", default_run_date='20260227')
-    
-    result = formatter2.format()
-    print(result)
-    
-    # 验证结果
-    lines = result.strip().split('\n')
-    for line in lines:
-        if '周列表（往后3周，每周3）:' in line:
-            expected = "'20260227'，'20260304'，'20260311'，'20260318'"
-            actual = line.split(':')[1].strip()
-            print(f"\n验证run_weeks>3&3:")
-            print(f"预期: {expected}")
-            print(f"实际: {actual}")
-            print(f"是否正确: {actual == expected}")
-    
-    print("\n3. 综合示例（渐进式替换）:")
-    print("-" * 40)
-    
-    raw_str = "商品：{goods} ,数量：{len(goods)} ,金额：{amt:.2f} ,支用日期：{run_date_std} ,结清日期：{run_date_std+15}"
-    fmt = EnhancedDateFormatter(raw_str, default_run_date='20260227')
-    
-    print("初始状态:")
-    print(fmt.format())
-    print()
-    
-    fmt.set(goods=["a", "b"])
-    print("设置goods后:")
-    print(fmt.format())
-    print()
-    
-    fmt.set(run_date='20260309')
-    print("设置run_date为'20260309'后:")
-    print(fmt.format())
-    print()
-    
-    fmt.set(amt=17.1)
-    print("设置amt后:")
-    print(fmt.format())
-    print()
-    
-    fmt.set(amt=12.3, run_date='2026-09-03')
-    print("设置amt和run_date为'2026-09-03'后:")
-    print(fmt.format())
-    print()
-    
-    print("4. SQL查询示例:")
-    print("-" * 40)
-    
-    sql_template = """
--- 近7天数据
-SELECT * FROM sales 
-WHERE ds >= '{run_days_std<6}'
-  AND ds <= '{run_date_std}'
-  AND channel = '电商'
-
--- 近4周数据（每周一）
-UNION ALL
-SELECT * FROM sales 
-WHERE ds IN ({run_weeks_std<4&1})
-  AND channel = '门店'
-
--- 近3个月数据（每月最后一天）
-UNION ALL
-SELECT * FROM sales 
-WHERE ds IN ({run_months_std<3&31})
-  AND channel = '批发'
-"""
-    
-    formatter4 = EnhancedDateFormatter(sql_template, default_run_date='20260227')
-    print(formatter4.format())
-    
-    print("\n5. 获取剩余占位符:")
-    print("-" * 40)
-    
-    formatter5 = EnhancedDateFormatter("姓名: {name}, 年龄: {age}, 日期: {dt}")
-    formatter5.set(name="张三",age=23).set(dt="{run_date_std-33}").set(run_date='2024-01-01')
-    print(f"{formatter5.is_complete():}")
-    print("格式化结果:", formatter5.format())
-    print("剩余占位符:", formatter5.get_remaining_placeholders())
-    print("是否完整:", formatter5.is_complete())
-
-    formatter5.next.run()
-
-
-    dt = DateProcessor().get_single_date("run_month_end")
-    print(dt)

vools-0.4.2/vools/decorators/cache.py

@@ -0,0 +1,33 @@
+"""
+缓存相关装饰器（已废弃，请使用 vools.cache）
+
+.. deprecated::
+    本模块已废弃，请使用 ``vools.cache`` 替代。
+    ``vools.decorators.cache`` 仍可用作向后兼容，但建议迁移到 ``vools.cache``。
+
+包含：
+- memorize: 函数结果缓存装饰器
+- once: 单次执行装饰器（支持函数和类）
+- persist: 持久化缓存装饰器
+"""
+
+import warnings
+
+from ..cache import (
+    memorize,
+    once,
+    persist,
+    FileLock,
+)
+from ..cache.memorize import TimedCache, _CACHE, _compute_key
+from ..cache.persist import sanitize_file_key, _default_force_when_by_day
+
+
+_DEPRECATION_MSG = (
+    "vools.decorators.cache is deprecated, please use vools.cache instead. "
+    "Importing from vools.decorators.cache will be removed in a future version."
+)
+
+warnings.warn(_DEPRECATION_MSG, DeprecationWarning, stacklevel=2)
+
+__all__ = ['memorize', 'once', 'persist']