vools 0.7.2__tar.gz → 0.7.4__tar.gz

{vools-0.7.2/vools.egg-info → vools-0.7.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vools
-Version: 0.7.2
+Version: 0.7.4
 Summary: Python 函数式编程工具集
 Author-email: Victor <victortop921129@gmail.com>
 License: Apache License
@@ -239,12 +239,18 @@ Provides-Extra: serialize
 Requires-Dist: msgpack>=1.0; extra == "serialize"
 Requires-Dist: orjson>=3.9; extra == "serialize"
 Provides-Extra: rx
-Requires-Dist: vools-rx==0.7.2; extra == "rx"
+Requires-Dist: vools-rx==0.7.4; extra == "rx"
 Provides-Extra: bridges
-Requires-Dist: vools-bridges==0.7.2; extra == "bridges"
+Requires-Dist: vools-bridges==0.7.4; extra == "bridges"
+Provides-Extra: dll32
+Requires-Dist: vools-dll32==0.7.4; extra == "dll32"
+Provides-Extra: xl
+Requires-Dist: vools-xl==0.7.4; extra == "xl"
 Provides-Extra: all
-Requires-Dist: vools-rx==0.7.2; extra == "all"
-Requires-Dist: vools-bridges==0.7.2; extra == "all"
+Requires-Dist: vools-rx==0.7.4; extra == "all"
+Requires-Dist: vools-bridges==0.7.4; extra == "all"
+Requires-Dist: vools-dll32==0.7.4; extra == "all"
+Requires-Dist: vools-xl==0.7.4; extra == "all"
 Provides-Extra: cli
 Requires-Dist: typer>=0.12.0; extra == "cli"
 Requires-Dist: typing-extensions>=4.0.0; extra == "cli"

{vools-0.7.2 → vools-0.7.4}/pyproject.toml

@@ -46,9 +46,11 @@ serialize = [
     "msgpack>=1.0",
     "orjson>=3.9",
 ]
-rx = ["vools-rx==0.7.2"]
-bridges = ["vools-bridges==0.7.2"]
-all = ["vools-rx==0.7.2", "vools-bridges==0.7.2"]
+rx = ["vools-rx==0.7.4"]
+bridges = ["vools-bridges==0.7.4"]
+dll32 = ["vools-dll32==0.7.4"]
+xl = ["vools-xl==0.7.4"]
+all = ["vools-rx==0.7.4", "vools-bridges==0.7.4", "vools-dll32==0.7.4", "vools-xl==0.7.4"]
 cli = [
     "typer>=0.12.0",
     "typing-extensions>=4.0.0",
@@ -75,10 +77,8 @@ include = ["vools*"]
 exclude = [
     "vools.__pycache__",
     "vools.*.__pycache__",
-    "vools.dll32._python32",
-    "vools.dll32._python32.*",
-    "vools.dll32._dlls",
-    "vools.dll32._dlls.*",
+    "vools.dll32*",
+    "vools.xl*",
     "vools.bridge*",
     "vools.reactive*",
 ]
@@ -94,50 +94,8 @@ version = { attr = "vools.__version__" }
     "lib/*.so",
     "lib/windows/*.dll",
     "lib/linux/*.so",
-    "xl/_dlls/*.dll",
-]
-"vools.dll32" = [
-    "_dlls/*.dll",
-    "_dlls/*.tlb",
-    "_dlls/*.ocx",
-    "_python32/python.exe",
-    "_python32/pythonw.exe",
-    "_python32/python3.dll",
-    "_python32/python3*.dll",
-    "_python32/python3*.pyd",
-    "_python32/python3*.zip",
-    "_python32/python3*._pth",
-    "_python32/vcruntime140.dll",
-    "_python32/sqlite3.dll",
-    "_python32/pyexpat.pyd",
-    "_python32/select.pyd",
-    "_python32/unicodedata.pyd",
-    "_python32/winsound.pyd",
-    "_python32/_asyncio.pyd",
-    "_python32/_bz2.pyd",
-    "_python32/_ctypes.pyd",
-    "_python32/_decimal.pyd",
-    "_python32/_distutils_findvs.pyd",
-    "_python32/_elementtree.pyd",
-    "_python32/_hashlib.pyd",
-    "_python32/_lzma.pyd",
-    "_python32/_msi.pyd",
-    "_python32/_multiprocessing.pyd",
-    "_python32/_overlapped.pyd",
-    "_python32/_socket.pyd",
-    "_python32/_sqlite3.pyd",
-    "_python32/_ssl.pyd",
-    "_python32/__init__.py",
-    "_python32/python32_launcher.py",
-]
-
-[tool.setuptools.exclude-package-data]
-"vools.dll32" = [
-    "_python32/Lib/**/*",
-    "_python32/Lib/*",
-    "_python32/**/__pycache__/*",
-    "_python32/**/*.pyc",
-    "_python32/**/*.pyo",
+    "data/*.dll",
+    "data/*.so",
 ]
 
 # ============ pytest ============
@@ -147,7 +105,7 @@ testpaths = ["tests"]
 # 默认不运行（需要外部资源/平台特定）：dll32, xl, monitoring, benchmarks, archive, other
 # 如需运行全部测试，使用: pytest --override-ini="addopts=--tb=short -q"
 # 如需运行特定子项目测试，使用: pytest bridges/tests/ 或 pytest rx/tests/
-addopts = "--tb=short -q --ignore=tests/dll32 --ignore=tests/xl --ignore=tests/monitoring --ignore=tests/benchmarks --ignore=tests/archive --ignore=tests/other --ignore=tests/__rust__ --ignore=tests/__persist__ --ignore=tests/__pycache__"
+addopts = "--tb=short -q --ignore=tests/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.7.2 → vools-0.7.4}/vools/__init__.py

@@ -32,7 +32,7 @@ if not hasattr(subprocess.Popen.__init__, '_vools_patched'):
 import importlib
 from typing import Any
 
-__version__ = "0.7.2"
+__version__ = "0.7.4"
 __author__ = "Victor"
 __license__ = "Apache 2.0"
 
@@ -142,7 +142,6 @@ _lazy_modules = {
     'trd': '.decorators',
     'proc': '.decorators',
     'extend': '.decorators',
-    'smart_partial': '.decorators',
     'delay_curry': '.decorators',
 
     'Pipe': '.functional',
@@ -163,11 +162,9 @@ _lazy_modules = {
     'pipe': '.utils',
 
     'shotcut': '.decorators',
-    'shotcutEx': '.decorators',
     'hoder': '.utils',
     'Hoder': '.utils',
     'timeit': '.decorators',
-    'asyncify': '.decorators',
     'safe': '.decorators',
     'throttle': '.decorators',
     'debounce': '.decorators',
@@ -178,7 +175,6 @@ _lazy_modules = {
     'with_timeout': '.decorators',
     'validate': '.decorators',
     'rate_limit': '.decorators',
-    'log_calls': '.decorators',
     'cache_with_ttl': '.decorators',
     'hybrid_method': '.decorators',
     'classproperty': '.decorators',
@@ -190,10 +186,6 @@ _lazy_modules = {
     'oop': '.oop',
     'calltype': '.oop',
 
-    'vicTools': '.vic',
-    'vicDate': '.vic',
-    'vicText': '.vic',
-    'vicList': '.vic',
 
     'datetime': '.datetime',
 
@@ -266,6 +258,8 @@ OOP_AVAILABLE = True
 DATETIME_AVAILABLE = True
 BRIDGE_AVAILABLE = False
 REACTIVE_AVAILABLE = False
+DLL32_AVAILABLE = False
+XL_AVAILABLE = False
 
 VIC_AVAILABLE = True
 
@@ -305,6 +299,24 @@ def __getattr__(name: str) -> Any:
         except Exception:
             raise AttributeError("vools.reactive is not installed; use pip install 'vools[rx]' or pip install vools-rx")
 
+    if name == 'dll32':
+        global DLL32_AVAILABLE
+        try:
+            module = importlib.import_module('.dll32', package='vools')
+            DLL32_AVAILABLE = True
+            return module
+        except Exception:
+            raise AttributeError("vools.dll32 is not installed; use pip install 'vools[dll32]' or pip install vools-dll32")
+
+    if name == 'xl':
+        global XL_AVAILABLE
+        try:
+            module = importlib.import_module('.xl', package='vools')
+            XL_AVAILABLE = True
+            return module
+        except Exception:
+            raise AttributeError("vools.xl is not installed; use pip install 'vools[xl]' or pip install vools-xl")
+
     if name in _lazy_modules:
         module_path = _lazy_modules[name]
         try:
@@ -349,7 +361,6 @@ __all__ = [
     'trd',
     'proc',
     'extend',
-    'smart_partial',
     'delay_curry',
     'overload',
     'OverloadManager', 'OverloadMode', 'reset_registry',
@@ -390,11 +401,9 @@ __all__ = [
     'pipe',
 
     'shotcut',
-    'shotcutEx',
     'hoder',
     'Hoder',
     'timeit',
-    'asyncify',
     'safe',
     'throttle',
     'debounce',
@@ -405,7 +414,6 @@ __all__ = [
     'with_timeout',
     'validate',
     'rate_limit',
-    'log_calls',
     'cache_with_ttl',
     'hybrid_method',
     'classproperty',
@@ -418,10 +426,6 @@ __all__ = [
     'calltype',
     'OOP_AVAILABLE',
 
-    'vicTools',
-    'vicDate',
-    'vicText',
-    'vicList',
 
     'vDate',
     'get_week',

vools-0.7.4/vools/config.py

@@ -0,0 +1,135 @@
+"""
+vools 配置模块
+
+提供全局配置管理功能，支持数据库连接、缓存策略、线程池等配置项。
+
+所有配置项都有详细说明，包括：
+- 配置项用途
+- 默认值
+- 应用模块
+- 可选值范围
+"""
+
+__all__ = ['DATABASE_CONFIG', 'OTHER_CONFIG', 'PATHS', 'ConfigManager', 'config']
+
+# ============================================================================
+# 数据库配置
+# ============================================================================
+# 用于数据库相关功能（如 persist 装饰器的持久化存储）
+# 当前主要作为预留配置，实际使用时需要填写真实连接信息
+# ============================================================================
+
+DATABASE_CONFIG = {
+    'host': None,              # 数据库主机地址，如 'localhost' 或 '127.0.0.1'
+    'port': None,              # 数据库端口，如 MySQL 默认 3306，PostgreSQL 默认 5432
+    'user': None,              # 数据库用户名
+    'password': None,          # 数据库密码
+    'database': None,          # 数据库名称
+}
+
+# ============================================================================
+# 运行时配置
+# ============================================================================
+# 控制 vools 库的运行时行为，影响多个模块的默认行为
+# ============================================================================
+
+OTHER_CONFIG = {
+    # 缓存相关
+    'cache_duration': 3,       # 缓存持续时间（秒），应用于 memorize 装饰器的默认缓存时长
+    'default_force_when': None, # 默认强制刷新条件，应用于 cache.py 的 persist 装饰器
+    'default_target_folder': None, # 默认目标文件夹，应用于 cache.py 的 persist 装饰器
+    
+    # 并发相关
+    'max_workers': 10,         # 最大工作线程数，应用于 TaskQueue 和 WorkerPool 的默认值
+    
+    # 重试相关
+    'retry_times': 3,          # 默认重试次数，应用于 retry 装饰器的默认值
+    
+    # 数据处理相关
+    'NONE_is_None': False,     # 是否将 NONE 占位符视为 None，应用于 data/seq.py 的 Seq 类
+}
+
+# ============================================================================
+# 路径配置
+# ============================================================================
+# 用于文件操作相关功能，指定数据存储和输出的基础路径
+# ============================================================================
+
+PATHS = {
+    'base_path': None,         # 项目基础路径，所有相对路径的基准目录
+    'data_path': None,         # 数据文件存储路径，如 CSV、JSON 文件的读取位置
+    'output_path': None,       # 输出文件路径，如生成报告、导出数据的保存位置
+}
+
+# ============================================================================
+# 配置管理器类
+# ============================================================================
+# 提供统一的配置访问接口，支持属性式访问
+# ============================================================================
+
+class ConfigManager:
+    """
+    配置管理器
+    
+    提供全局配置的统一访问接口，支持通过属性方式访问各配置项。
+    
+    Example:
+        from vools.config import config
+        
+        # 访问配置
+        print(config.database.host)
+        print(config.other.cache_duration)
+        print(config.paths.base_path)
+        
+        # 修改配置
+        config.other.cache_duration = 5
+        config.paths.base_path = '/data'
+    """
+
+    def do(self, f=print, pre_f=None, sub_f=None):
+        """Apply a function for side effects, return self for chaining.
+        
+        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 __init__(self):
+        self.database = DATABASE_CONFIG
+        self.other = OTHER_CONFIG
+        self.paths = PATHS
+
+# ============================================================================
+# 全局配置实例
+# ============================================================================
+# 推荐使用此实例访问和修改配置
+# ============================================================================
+
+config = ConfigManager()
+# Global config instance, unified config access interface.
+# Usage: from vools.config import config
+
+# ============================================================================
+# 配置项影响的模块汇总
+# ============================================================================
+# | 配置项 | 影响模块 | 说明 |
+# |--------|----------|------|
+# | cache_duration | decorators/cache.py | memorize 装饰器默认缓存时长 |
+# | max_workers | task/core/queue.py | TaskQueue 和 WorkerPool 默认线程数 |
+# | retry_times | decorators/control.py | retry 装饰器默认重试次数 |
+# | default_force_when | decorators/cache.py | persist 装饰器默认强制刷新条件 |
+# | default_target_folder | decorators/cache.py | persist 装饰器默认目标文件夹 |
+# | NONE_is_None | data/seq.py | Seq 类处理 NONE 占位符的方式 |
+# | database.* | decorators/cache.py | persist 装饰器数据库持久化（预留） |
+# | paths.* | 多个模块 | 文件读写操作的基础路径 |

{vools-0.7.2 → vools-0.7.4}/vools/data/itor_nim.py

@@ -54,6 +54,7 @@ class NimItor:
         self._queue = deque()
         self._jump_queue = deque()
         self._source_exhausted = False
+        self._started = False
 
         self._handle = self._dll.newItor()
 
@@ -61,7 +62,15 @@ class NimItor:
     def state(self) -> ItorState:
         if self._handle is None:
             return ItorState.STOPPED
-        return ItorState(self._dll.state(self._handle))
+        dll_state = self._dll.state(self._handle)
+        if dll_state == ItorState.STOPPED.value:
+            return ItorState.STOPPED
+        if dll_state == ItorState.PAUSED.value:
+            return ItorState.PAUSED
+        # DLL 无法区分 PENDING / ITERRING，由 Python 端维护起始标志
+        if self._source_exhausted and not self._queue and not self._jump_queue:
+            return ItorState.STOPPED
+        return ItorState.ITERRING if self._started else ItorState.PENDING
 
     def send(self, jump: Any, jump_when: Optional[Callable[['NimItor'], bool]] = None) -> 'NimItor':
         if jump_when is not None:
@@ -109,6 +118,10 @@ class NimItor:
 
     def __next__(self) -> Any:
         while True:
+            # 已停止的迭代器立即终止（无论队列中是否还有缓存值）
+            if self._handle is not None and self._dll.state(self._handle) == ItorState.STOPPED.value:
+                raise StopIteration
+
             if self._jump_queue:
                 return self._jump_queue.popleft()
 
@@ -120,6 +133,7 @@ class NimItor:
 
             if self._iterator is None:
                 self._iterator = iter(self._iterable)
+                self._started = True
 
             try:
                 item = next(self._iterator)

{vools-0.7.2 → vools-0.7.4}/vools/data/table.py

@@ -1900,7 +1900,12 @@ class Table(Seq):
 
             table = Table.read_excel('data.xlsx')
         """
-        from ..xl import Book
+        try:
+            from ..xl import Book
+        except ImportError as exc:
+            raise ImportError(
+                "vools.xl is not installed; use pip install 'vools[xl]' or pip install vools-xl"
+            ) from exc
 
         if not os.path.exists(filename):
             raise FileNotFoundError(f'File not found: {filename}')
@@ -1974,7 +1979,12 @@ class Table(Seq):
 
             table.write_excel('output.xlsx')
         """
-        from ..xl import Book
+        try:
+            from ..xl import Book
+        except ImportError as exc:
+            raise ImportError(
+                "vools.xl is not installed; use pip install 'vools[xl]' or pip install vools-xl"
+            ) from exc
 
         with Book() as book:
             sheet = book.add_sheet(sheet_name)

{vools-0.7.2 → vools-0.7.4}/vools/decorators/curry_core.py

@@ -215,6 +215,25 @@ class CurryDescriptor:
         Returns:
             如果 instance 为 None 返回 Curried，否则返回绑定后的 Curried
         """
+        # classmethod 委托场景：Python 的 classmethod.__get__ 会把类本身作为
+        # instance 传给 descriptor（instance is owner），此时需将第一个参数 (cls)
+        # 绑定为 owner 并从 required_args 中剔除。
+        is_classmethod_delegation = (
+            owner is not None
+            and isinstance(instance, type)
+            and instance is owner
+            and isinstance(getattr(owner, '__dict__', {}).get(self._name), classmethod)
+        )
+        if is_classmethod_delegation:
+            bound_func = self.func.__get__(owner, owner)
+            pre_attrs = self.pre_attrs.copy()
+            required_args = pre_attrs.get('required_args', [])
+            params = pre_attrs.get('params', {})
+            if required_args:
+                first = required_args[0]
+                pre_attrs['required_args'] = required_args[1:]
+                pre_attrs['params'] = {k: v for k, v in params.items() if k != first}
+            return Curried(bound_func, is_strict=self.is_strict, delaied=self.delaied, **pre_attrs)
         if instance is None:
             return Curried(self.func, is_strict=self.is_strict, delaied=self.delaied, **self.pre_attrs)
         bound_func = self.func.__get__(instance, owner)

{vools-0.7.2 → vools-0.7.4}/vools/security/hash.py

@@ -28,16 +28,29 @@ __all__ = [
 
 # 优先使用 Nim 桥接库（来自 vools.bridge.nim.crypto）
 # crypto.py 已经正确实现了 _nim_sha256/_py_sha256 的自动切换
-try:
-    from ..bridge.nim import sha256 as _nim_sha256_impl
-    from ..bridge.nim import md5 as _nim_md5_impl
-    from ..bridge.nim import sha1 as _nim_sha1_impl
-    _nim_available = True
-except ImportError:
-    _nim_sha256_impl = None
-    _nim_md5_impl = None
-    _nim_sha1_impl = None
-    _nim_available = False
+# 注意：必须延迟导入，避免 import vools 时预加载 vools.bridge 子包，
+# 否则 vools.BRIDGE_AVAILABLE 标志的翻转逻辑永远不执行。
+_nim_available = False
+_nim_sha256_impl = None
+_nim_md5_impl = None
+_nim_sha1_impl = None
+
+
+def _load_nim_impls() -> None:
+    """延迟加载 Nim 桥接实现（仅在需要时导入 vools.bridge）。"""
+    global _nim_available, _nim_sha256_impl, _nim_md5_impl, _nim_sha1_impl
+    if _nim_available:
+        return
+    try:
+        from ..bridge.nim import sha256 as _sha256_impl
+        from ..bridge.nim import md5 as _md5_impl
+        from ..bridge.nim import sha1 as _sha1_impl
+        _nim_sha256_impl = _sha256_impl
+        _nim_md5_impl = _md5_impl
+        _nim_sha1_impl = _sha1_impl
+        _nim_available = True
+    except ImportError:
+        _nim_available = False
 
 
 def _py_sha256_hex(data: bytes) -> str:

{vools-0.7.2 → vools-0.7.4}/vools/security/safe_eval.py

@@ -209,10 +209,22 @@ def safe_eval(expr: str, vars: Optional[Dict[str, Any]] = None) -> Any:
 
 # 导入 shim（shim 不引用 vools 子包，避免循环导入）。
 # 当 vools-bridges 未安装时回退到 None，保证核心 safe_eval 仍然可用。
-try:
-    from ..bridge.rust import safe_eval_shim as _safe_eval_shim
-except Exception:
-    _safe_eval_shim = None
+# 注意：必须延迟导入，避免 import vools 时预加载 vools.bridge 子包，
+# 否则 vools.BRIDGE_AVAILABLE 标志的翻转逻辑永远不执行。
+_safe_eval_shim = None
+
+
+def _load_safe_eval_shim():
+    """延迟加载 Rust safe_eval shim（首次需要时导入 vools.bridge）。"""
+    global _safe_eval_shim
+    if _safe_eval_shim is not None:
+        return _safe_eval_shim
+    try:
+        from ..bridge.rust import safe_eval_shim as _shim
+        _safe_eval_shim = _shim
+    except Exception:
+        _safe_eval_shim = None
+    return _safe_eval_shim
 
 
 def _safe_eval_rust_impl(expr: str, vars: Optional[Dict[str, Any]] = None, timeout_ms: int = 1000) -> Any:
@@ -236,16 +248,17 @@ def _safe_eval_rust_impl(expr: str, vars: Optional[Dict[str, Any]] = None, timeo
         SafeEvalError: 当表达式包含不安全内容时
     """
     # 检查 Rust 是否可用
-    if _safe_eval_shim is None or not _safe_eval_shim.is_rust_available():
+    _shim = _load_safe_eval_shim()
+    if _shim is None or not _shim.is_rust_available():
         raise SafeEvalError("Rust 桥接库不可用")
 
     # 编译表达式为 VM 指令
-    instructions, compile_err = _safe_eval_shim.compile_to_instructions(expr)
+    instructions, compile_err = _shim.compile_to_instructions(expr)
     if compile_err:
         raise SafeEvalError(compile_err)
 
     # 执行指令
-    result = _safe_eval_shim.eval_instructions(instructions, timeout_ms)
+    result = _shim.eval_instructions(instructions, timeout_ms)
 
     if not result.get("ok", False):
         error = result.get("error", {})
@@ -300,7 +313,8 @@ def safe_eval_rust(expr: str, vars: Optional[Dict[str, Any]] = None, timeout_ms:
 
 def is_rust_safe_eval_available() -> bool:
     """检查 Rust 安全沙箱是否可用"""
-    return _safe_eval_shim is not None and _safe_eval_shim.is_rust_available()
+    _shim = _load_safe_eval_shim()
+    return _shim is not None and _shim.is_rust_available()
 
 
 DANGEROUS_PATTERNS = [

{vools-0.7.2 → vools-0.7.4/vools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: vools
-Version: 0.7.2
+Version: 0.7.4
 Summary: Python 函数式编程工具集
 Author-email: Victor <victortop921129@gmail.com>
 License: Apache License
@@ -239,12 +239,18 @@ Provides-Extra: serialize
 Requires-Dist: msgpack>=1.0; extra == "serialize"
 Requires-Dist: orjson>=3.9; extra == "serialize"
 Provides-Extra: rx
-Requires-Dist: vools-rx==0.7.2; extra == "rx"
+Requires-Dist: vools-rx==0.7.4; extra == "rx"
 Provides-Extra: bridges
-Requires-Dist: vools-bridges==0.7.2; extra == "bridges"
+Requires-Dist: vools-bridges==0.7.4; extra == "bridges"
+Provides-Extra: dll32
+Requires-Dist: vools-dll32==0.7.4; extra == "dll32"
+Provides-Extra: xl
+Requires-Dist: vools-xl==0.7.4; extra == "xl"
 Provides-Extra: all
-Requires-Dist: vools-rx==0.7.2; extra == "all"
-Requires-Dist: vools-bridges==0.7.2; extra == "all"
+Requires-Dist: vools-rx==0.7.4; extra == "all"
+Requires-Dist: vools-bridges==0.7.4; extra == "all"
+Requires-Dist: vools-dll32==0.7.4; extra == "all"
+Requires-Dist: vools-xl==0.7.4; extra == "all"
 Provides-Extra: cli
 Requires-Dist: typer>=0.12.0; extra == "cli"
 Requires-Dist: typing-extensions>=4.0.0; extra == "cli"