ygo 1.1.4__py3-none-any.whl → 1.1.6__py3-none-any.whl

ygo/__init__.py

@@ -19,8 +19,9 @@ from .utils import (
     module_from_str,
     fn_from_str,
 )
+from .lazy import lazy_import
 
-__version__ = "v1.1.4"
+__version__ = "v1.1.6"
 
 __all__ = [
     "FailTaskError",
@@ -33,5 +34,6 @@ __all__ = [
     "fn_info",
     "fn_from_str",
     "module_from_str",
-    "pool"
+    "pool",
+    "lazy_import"
 ]

ygo/lazy.py

@@ -0,0 +1,50 @@
+# -*- coding: utf-8 -*-
+"""
+---------------------------------------------
+Copyright (c) 2025 ZhangYundi
+Licensed under the MIT License. 
+Created on 2025/6/29 10:36
+Email: yundi.xxii@outlook.com
+Description:
+---------------------------------------------
+"""
+
+from typing import Any
+from hydra._internal.utils import _locate
+
+class LazyImport:
+    def __init__(self, full_name: str):
+        self._full_name = full_name
+        self._obj = None
+
+    def _load(self) -> Any:
+        if self._obj is None:
+            self._obj = _locate(self._full_name)
+        return self._obj
+
+    def __getattr__(self, attr: str) -> Any:
+        obj = self._load()
+        return getattr(obj, attr)
+
+    def __dir__(self) -> list[str]:
+        obj = self._load()
+        return dir(obj)
+
+    def __call__(self, *args, **kwargs) -> Any:
+        obj = self._load()
+        if isinstance(obj, type):
+            return obj(*args, **kwargs)
+        elif callable(obj):
+            return obj(*args, **kwargs)
+        else:
+            raise TypeError(f"The target `{self._full_name}` is not callable or instantiable.")
+
+    def __str__(self):
+        return self._full_name
+
+    def __repr__(self):
+        return self._full_name
+
+def lazy_import(full_name: str):
+    """实现模块和方法的懒加载"""
+    return LazyImport(full_name)

ygo/utils.py

@@ -9,10 +9,44 @@ Created on 2025/5/26 23:31
 
 import inspect
 import os
+from functools import wraps
 from pathlib import Path
-
+import warnings
 from .delay import delay
 
+def deprecated(use_instead: str = None):
+    """
+    标记方法为弃用
+
+    Parameters
+    ----------
+    use_instead: str
+        推荐替代使用的方法或者类名称
+    Returns
+    -------
+
+    """
+
+    def decorator(func):
+        """
+        装饰器
+        Parameters
+        ----------
+        func: callable
+            被装饰的函数
+        Returns
+        -------
+
+        """
+        @wraps(func)
+        def wrapper(*args, **kwargs):
+            msg = f"`{func.__name__}` is deprecated. "
+            if use_instead:
+                msg += f"Please use `{use_instead}` instead."
+            warnings.warn(msg, category=DeprecationWarning, stacklevel=2)
+            return func(*args, **kwargs)
+        return wrapper
+    return decorator
 
 def fn_params(func: callable):
     """
@@ -111,7 +145,7 @@ def fn_info(fn: callable) -> str:
     """
     return s
 
-
+@deprecated("lazy_import")
 def fn_from_str(s):
     """
     字符串导入对应fn
@@ -128,7 +162,7 @@ def fn_from_str(s):
     _callable = getattr(mod, func)
     return _callable
 
-
+@deprecated("lazy_import")
 def module_from_str(s):
     """字符串导入模块"""
     import importlib

{ygo-1.1.4.dist-info → ygo-1.1.6.dist-info}/METADATA

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: ygo
-Version: 1.1.4
+Version: 1.1.6
 Summary: 一个轻量级 Python 工具包，支持 并发执行（带进度条）、延迟调用、链式绑定参数、函数信息获取、模块/函数动态加载。并结合 ylog 提供日志记录能力
 Project-URL: homepage, https://github.com/link-yundi/ygo
 Project-URL: repository, https://github.com/link-yundi/ygo
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: hydra-core>=1.3.2
 Requires-Dist: joblib>=1.5.0
 Requires-Dist: loguru>=0.7.3
 Requires-Dist: tqdm>=4.67.1

ygo-1.1.6.dist-info/RECORD

@@ -0,0 +1,13 @@
+ygo/__init__.py,sha256=FLytzQXxm255WUZE_NgdMrKORq3UPE_YDjqRe9xAXDg,728
+ygo/delay.py,sha256=66xtPXqyD630FL7LWL5qJKAIZvyGDwZyM4qPfk8Czlg,2206
+ygo/exceptions.py,sha256=0OYDYt_9KKo8mF2XBG5QkCMr3-ASp69VDSPOEwlIsrI,660
+ygo/lazy.py,sha256=IwWOv3zYWGGuFefvZwZyP-zokyB4EnQWmySstSk3dJg,1320
+ygo/pool.py,sha256=bnHm4TtnRoFBv5UvV7WpuObJoK4FdoRf65mvf82yEyI,7052
+ygo/utils.py,sha256=paeYb8TwonIaDwusE6YV9v_-Y-WzVjGgSa_c1mblw3Y,4040
+ygo-1.1.6.dist-info/licenses/LICENSE,sha256=6AKUWQ1xe-jwPSFv_H6FMQLNNWb7AYqzuEUTwlP2S8M,1067
+ylog/__init__.py,sha256=S_M_Hv_gKI_U9XUNn3rCu5h9NHZndVMRfRjMs2sjHyw,452
+ylog/core.py,sha256=l8vrSgCLQGIeQN_mqw8rMNp3W7m41nqJIH48DHtW16c,9105
+ygo-1.1.6.dist-info/METADATA,sha256=Iy7McK7cGWUbx7KMQv9lDfkcGqVhy4cv7qQnQeeaUxg,4877
+ygo-1.1.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ygo-1.1.6.dist-info/top_level.txt,sha256=sY7lJBJ2ncfEMAxoNBVay0RVUixpVt9Osuwwy0_uWqU,9
+ygo-1.1.6.dist-info/RECORD,,

ygo-1.1.4.dist-info/RECORD

@@ -1,12 +0,0 @@
-ygo/__init__.py,sha256=p1H7HHDRz1tnJiLOrfZrkssZID_dFTgVWuNbkDs7iig,679
-ygo/delay.py,sha256=66xtPXqyD630FL7LWL5qJKAIZvyGDwZyM4qPfk8Czlg,2206
-ygo/exceptions.py,sha256=0OYDYt_9KKo8mF2XBG5QkCMr3-ASp69VDSPOEwlIsrI,660
-ygo/pool.py,sha256=bnHm4TtnRoFBv5UvV7WpuObJoK4FdoRf65mvf82yEyI,7052
-ygo/utils.py,sha256=c-g4fJgeZp8diinkJhX4DAJBZEhH2tHYniUzRlt1EgU,3178
-ygo-1.1.4.dist-info/licenses/LICENSE,sha256=6AKUWQ1xe-jwPSFv_H6FMQLNNWb7AYqzuEUTwlP2S8M,1067
-ylog/__init__.py,sha256=S_M_Hv_gKI_U9XUNn3rCu5h9NHZndVMRfRjMs2sjHyw,452
-ylog/core.py,sha256=l8vrSgCLQGIeQN_mqw8rMNp3W7m41nqJIH48DHtW16c,9105
-ygo-1.1.4.dist-info/METADATA,sha256=QZuBuYJ5d11sUgcJ9iMZ8WY7E168_ee3EaaB6blytPE,4844
-ygo-1.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ygo-1.1.4.dist-info/top_level.txt,sha256=sY7lJBJ2ncfEMAxoNBVay0RVUixpVt9Osuwwy0_uWqU,9
-ygo-1.1.4.dist-info/RECORD,,