ErisPulse 2.5.2.dev3__py3-none-any.whl → 2.5.2.dev4__py3-none-any.whl

ErisPulse/CLI/cli.py

@@ -149,6 +149,51 @@ class CLI:
             )
         )
 
+    def _check_command_typo(self) -> None:
+        """
+        在 argparse 解析之前检查命令拼写
+
+        argparse 的子命令 choices 验证遇到无效命令时会直接打印错误并退出，
+        无法附加自定义提示。因此在此提前拦截，给出"你是不是想用 xxx"的拼写建议。
+        """
+        # 所有有效命令（规范名 + 别名），用于检查输入是否有效
+        all_valid = set(self.registry.list_all()) | set(
+            self.registry.list_aliases().keys()
+        )
+        # 仅规范命令名作为建议候选（不含短别名/缩写，避免扰民）
+        canonical_names = self.registry.list_all()
+
+        # 从 sys.argv 中找到第一个非选项参数（即命令名）
+        cmd = None
+        for arg in sys.argv[1:]:
+            if not arg.startswith("-"):
+                cmd = arg
+                break
+
+        if not cmd or cmd in all_valid:
+            return
+
+        # 命令无效，给出拼写建议（前缀加成确保 ins → install 而非 list）
+        from ..runtime.hints import best_match_with_prefix
+
+        print_banner()
+        suggestion = best_match_with_prefix(
+            cmd, canonical_names, cutoff=0.5
+        )
+
+        console.print(
+            f"[error]{i18n.t('cli.run.unknown_command', command=cmd)}[/]"
+        )
+        if suggestion:
+            console.print(
+                f"[hint]{i18n.t('cli.run.did_you_mean', name=suggestion)}[/]"
+            )
+            console.print()
+            console.print(f"  [dim]epsdk {suggestion} --help[/]")
+        else:
+            self.parser.print_help()
+        sys.exit(1)
+
     def _maybe_show_language_hint(self) -> None:
         """
         在前几次启动时提醒用户确认语言
@@ -197,6 +242,9 @@ class CLI:
         :raises KeyboardInterrupt: 用户中断时抛出
         :raises Exception: 命令执行失败时抛出
         """
+        # 在 argparse 之前检查命令拼写（argparse 的 choices 验证会直接报错退出）
+        self._check_command_typo()
+
         args, unknown = self.parser.parse_known_args()
         args._unknown_args = unknown
 
@@ -240,6 +288,16 @@ class CLI:
                 console.print()
                 command.execute(args)
             else:
+                # 拼写建议：检查是否输入了与已知命令相似的名称
+                from ..runtime.hints import best_match_with_prefix
+
+                suggestion = best_match_with_prefix(
+                    args.command, self.registry.list_all(), cutoff=0.5
+                )
+                if suggestion:
+                    console.print(
+                        f"[hint]{i18n.t('cli.run.did_you_mean', name=suggestion)}[/]"
+                    )
                 console.print(
                     f"[error]{i18n.t('cli.run.unknown_command', command=args.command)}[/]"
                 )

ErisPulse/CLI/cli.pyi

@@ -58,6 +58,14 @@ class CLI:
         打印版本信息
         """
         ...
+    def _check_command_typo(self: object) -> None:
+        """
+        在 argparse 解析之前检查命令拼写
+        
+        argparse 的子命令 choices 验证遇到无效命令时会直接打印错误并退出，
+        无法附加自定义提示。因此在此提前拦截，给出"你是不是想用 xxx"的拼写建议。
+        """
+        ...
     def _maybe_show_language_hint(self: object) -> None:
         """
         在前几次启动时提醒用户确认语言

ErisPulse/CLI/commands/init.py

@@ -34,7 +34,7 @@ class InitCommand(Command):
 
     name = "init"
     description = i18n.t("cli.init.description")
-    aliases = ["ini"]
+    aliases = []
 
     def __init__(self):
         """

ErisPulse/CLI/commands/list.py

@@ -104,6 +104,8 @@ class ListCommand(Command):
                 console.print(
                     f"[dim]  {i18n.t('cli.list.count_modules', count=count)}[/]"
                 )
+                # 展示模块注册的脚本入口
+                self._print_package_scripts(installed["modules"])
             else:
                 console.print(f"[dim]  {i18n.t('cli.list.no_modules')}[/]")
 
@@ -162,3 +164,33 @@ class ListCommand(Command):
             if adapter_info["package"] == package_name:
                 return adapter_info["version"] != current_version
         return False
+
+    def _print_package_scripts(self, packages: dict) -> None:
+        """
+        发现并展示已安装模块包注册的 console_scripts 入口
+
+        :param packages: [dict] 模块信息字典 {name: {package, version, ...}}
+        """
+        import importlib.metadata
+
+        all_scripts: list[tuple[str, str]] = []
+
+        for module_name, info in packages.items():
+            package_name = info.get("package", "")
+            if not package_name:
+                continue
+            try:
+                dist = importlib.metadata.distribution(package_name)
+                for ep in dist.entry_points:
+                    if ep.group == "console_scripts":
+                        all_scripts.append((module_name, ep.name))
+            except Exception:
+                continue
+
+        if not all_scripts:
+            return
+
+        console.print()
+        console.print(f"  [dim]{i18n.t('cli.list.scripts_header')}[/]")
+        for module_name, script_name in all_scripts:
+            console.print(f"  [module]{module_name}[/]  [cyan]{script_name}[/]")

ErisPulse/CLI/commands/list.pyi

@@ -52,3 +52,10 @@ class ListCommand(Command):
         :return: [bool] 存在更新版本返回 True，否则返回 False
         """
         ...
+    def _print_package_scripts(self: object, packages: dict) -> None:
+        """
+        发现并展示已安装模块包注册的 console_scripts 入口
+        
+        :param packages: [dict] 模块信息字典 {name: {package, version, ...}}
+        """
+        ...

ErisPulse/CLI/commands/list_remote.py

@@ -26,7 +26,7 @@ class ListRemoteCommand(Command):
 
     name = "list-remote"
     description = i18n.t("cli.list_remote.description")
-    aliases = ["lr"]
+    aliases = ["lsr"]
 
     def __init__(self):
         """

ErisPulse/CLI/console.py

@@ -89,6 +89,7 @@ theme = Theme(
         "module": "#80CBC4",
         "adapter": "#7DBFE0",
         "cli": "#A0B0C0",
+        "hint": "#CE93D8",
     }
 )
 

ErisPulse/CLI/i18n/locales/en.py

@@ -15,6 +15,7 @@ TRANSLATIONS = {
     "cli.parser.optionals_title": "Options",
     "cli.run.unknown_args": "Unknown arguments: {args}",
     "cli.run.unknown_command": "Unknown command: {command}",
+    "cli.run.did_you_mean": "Did you mean '{name}'?",
     "cli.run.user_interrupted": "Operation interrupted by user",
     "cli.run.exec_error": "Error executing command: {error}",
     "cli.run.version_text": "ErisPulse SDK version: {version}",
@@ -176,6 +177,7 @@ TRANSLATIONS = {
     "cli.list.status_disabled": "Disabled",
     "cli.list.count_modules": "{count} module(s)",
     "cli.list.no_modules": "No matching modules",
+    "cli.list.scripts_header": "Module-registered CLI tools:",
     "cli.list.header_adapter": "Adapter Name",
     "cli.list.count_adapters": "{count} adapter(s)",
     "cli.list.no_adapters": "No matching adapters",

ErisPulse/CLI/i18n/locales/ja.py

@@ -15,6 +15,7 @@ TRANSLATIONS = {
     "cli.parser.optionals_title": "オプション",
     "cli.run.unknown_args": "認識できない引数: {args}",
     "cli.run.unknown_command": "未知のコマンド: {command}",
+    "cli.run.did_you_mean": "もしかして '{name}' コマンドですか？",
     "cli.run.user_interrupted": "操作がユーザーにより中断されました",
     "cli.run.exec_error": "コマンド実行中にエラーが発生しました: {error}",
     "cli.run.version_text": "ErisPulse SDK バージョン: {version}",
@@ -176,6 +177,7 @@ TRANSLATIONS = {
     "cli.list.status_disabled": "無効",
     "cli.list.count_modules": "{count} 個のモジュール",
     "cli.list.no_modules": "該当するモジュールはありません",
+    "cli.list.scripts_header": "モジュール登録のコマンドラインツール：",
     "cli.list.header_adapter": "アダプター名",
     "cli.list.count_adapters": "{count} 個のアダプター",
     "cli.list.no_adapters": "該当するアダプターはありません",

ErisPulse/CLI/i18n/locales/ru.py

@@ -15,6 +15,7 @@ TRANSLATIONS = {
     "cli.parser.optionals_title": "Параметры",
     "cli.run.unknown_args": "Неизвестные аргументы: {args}",
     "cli.run.unknown_command": "Неизвестная команда: {command}",
+    "cli.run.did_you_mean": "Возможно, вы имели в виду команду '{name}'?",
     "cli.run.user_interrupted": "Операция прервана пользователем",
     "cli.run.exec_error": "Ошибка при выполнении команды: {error}",
     "cli.run.version_text": "ErisPulse SDK версия: {version}",
@@ -176,6 +177,7 @@ TRANSLATIONS = {
     "cli.list.status_disabled": "Отключен",
     "cli.list.count_modules": "{count} модуля(ей)",
     "cli.list.no_modules": "Нет подходящих модулей",
+    "cli.list.scripts_header": "Инструменты командной строки модулей:",
     "cli.list.header_adapter": "Имя адаптера",
     "cli.list.count_adapters": "{count} адаптера(ов)",
     "cli.list.no_adapters": "Нет подходящих адаптеров",

ErisPulse/CLI/i18n/locales/zh_cn.py

@@ -15,6 +15,7 @@ TRANSLATIONS = {
     "cli.parser.optionals_title": "选项",
     "cli.run.unknown_args": "未识别的参数: {args}",
     "cli.run.unknown_command": "未知命令: {command}",
+    "cli.run.did_you_mean": "你是不是想用 '{name}' 命令？",
     "cli.run.user_interrupted": "操作被用户中断",
     "cli.run.exec_error": "执行命令时出错: {error}",
     "cli.run.version_text": "ErisPulse SDK 版本: {version}",
@@ -176,6 +177,7 @@ TRANSLATIONS = {
     "cli.list.status_disabled": "禁用",
     "cli.list.count_modules": "{count} 个模块",
     "cli.list.no_modules": "没有符合条件的模块",
+    "cli.list.scripts_header": "模块注册的命令行工具：",
     "cli.list.header_adapter": "适配器名",
     "cli.list.count_adapters": "{count} 个适配器",
     "cli.list.no_adapters": "没有符合条件的适配器",

ErisPulse/CLI/i18n/locales/zh_tw.py

@@ -15,6 +15,7 @@ TRANSLATIONS = {
     "cli.parser.optionals_title": "選項",
     "cli.run.unknown_args": "無法識別的參數: {args}",
     "cli.run.unknown_command": "未知的命令: {command}",
+    "cli.run.did_you_mean": "你是不是想用 '{name}' 指令？",
     "cli.run.user_interrupted": "操作被使用者中斷",
     "cli.run.exec_error": "執行命令時發生錯誤: {error}",
     "cli.run.version_text": "ErisPulse SDK 版本: {version}",
@@ -176,6 +177,7 @@ TRANSLATIONS = {
     "cli.list.status_disabled": "停用",
     "cli.list.count_modules": "{count} 個模組",
     "cli.list.no_modules": "沒有符合條件的模組",
+    "cli.list.scripts_header": "模組註冊的命令列工具：",
     "cli.list.header_adapter": "適配器名",
     "cli.list.count_adapters": "{count} 個適配器",
     "cli.list.no_adapters": "沒有符合條件的適配器",

ErisPulse/Core/Bases/__init__.py

@@ -7,6 +7,7 @@ ErisPulse 基础模块
 from .adapter import SendDSL, RequestDSL, BaseAdapter
 from .module import BaseModule
 from .storage import BaseStorage, BaseQueryBuilder
+from .kv_builder import KVQueryBuilder
 from .errors import (
     ErisPulseError,
     ClientError,
@@ -27,6 +28,7 @@ __all__ = [
     "BaseModule",
     "BaseStorage",
     "BaseQueryBuilder",
+    "KVQueryBuilder",
     "HttpRequest",
     "WebSocketConnection",
     "WebSocketConnectionBase",

ErisPulse/Core/Bases/__init__.pyi

@@ -13,6 +13,7 @@ ErisPulse 基础模块
 from .adapter import SendDSL, RequestDSL, BaseAdapter
 from .module import BaseModule
 from .storage import BaseStorage, BaseQueryBuilder
+from .kv_builder import KVQueryBuilder
 from .errors import ErisPulseError, ClientError, ClientConnectionError, ClientTimeoutError, HTTPStatusError, WebSocketError, WebSocketDisconnect
 from .websocket import WebSocketConnectionBase, WSMessage
 from .router import HttpRequest, WebSocketConnection

ErisPulse/Core/Bases/kv_builder.py

@@ -0,0 +1,378 @@
+"""
+ErisPulse KV 查询构建器
+
+将链式 SQL 操作（Table/Insert/Select/Where 等）映射为 KV 键前缀操作。
+任何实现了 BaseStorage KV 接口的后端（Redis、内存字典等）均可使用。
+
+键命名规则：
+    _table:{table_name}:schema    — 表结构定义（列名 → 类型）
+    _table:{table_name}:next_id   — 自增 ID 计数器
+    _table:{table_name}:data:{id} — 行数据（JSON 序列化）
+
+使用方式：
+    >>> storage = MyKVStorage()
+    >>> qb = KVQueryBuilder(storage, "users")
+    >>> qb.Insert({"name": "Alice", "age": 30}).Execute()
+
+{!--< tips >!--}
+1. 查询性能取决于 get_all_keys() 的效率
+2. WHERE 条件在 Python 内存中过滤，不适合百万级数据
+3. 适合中小规模的结构化数据存储
+{!--< /tips >!--}
+"""
+
+import json
+from typing import Any
+
+from .storage import BaseQueryBuilder
+
+_TABLE_PREFIX = "__erispulse_sql__"
+
+
+class KVQueryBuilder(BaseQueryBuilder):
+    """
+    基于 KV 存储的查询构建器
+
+    将 Insert/Select/Update/Delete/Where/OrderBy/Limit 等链式操作
+    映射为对 BaseStorage KV 接口的调用。
+    """
+
+    def __init__(self, storage, table: str):
+        super().__init__(storage, table)
+        self._table_prefix = f"{_TABLE_PREFIX}:{table}"
+        self._bound_clauses: list[str] | None = None
+
+    # ---- key helpers ----
+
+    def _schema_key(self) -> str:
+        return f"{self._table_prefix}:schema"
+
+    def _next_id_key(self) -> str:
+        return f"{self._table_prefix}:next_id"
+
+    def _row_key(self, row_id: int) -> str:
+        return f"{self._table_prefix}:data:{row_id}"
+
+    def _row_prefix(self) -> str:
+        return f"{self._table_prefix}:data:"
+
+    # ---- ID management ----
+
+    def _get_next_id(self) -> int:
+        """获取并递增自增 ID"""
+        current = self._storage.get(self._next_id_key(), 1)
+        next_id = int(current)
+        self._storage.set(self._next_id_key(), next_id + 1)
+        return next_id
+
+    def _set_next_id(self, value: int) -> None:
+        self._storage.set(self._next_id_key(), value)
+
+    # ---- row scan ----
+
+    def _scan_rows(self) -> list[tuple[int, dict]]:
+        """扫描所有行，返回 [(row_id, row_data), ...]"""
+        all_keys = self._storage.get_all_keys()
+        rows = []
+        for key in all_keys:
+            if key.startswith(self._row_prefix()):
+                try:
+                    row_id = int(key.rsplit(":", 1)[-1])
+                except (ValueError, IndexError):
+                    continue
+                value = self._storage.get(key)
+                if isinstance(value, str):
+                    try:
+                        value = json.loads(value)
+                    except json.JSONDecodeError:
+                        # 兼容非 JSON 值
+                        pass
+                if isinstance(value, dict):
+                    rows.append((row_id, value))
+        return rows
+
+    # ---- where matching ----
+
+    def _match_row(self, row: dict) -> bool:
+        """检查行是否满足所有 WHERE 条件"""
+        if self._bound_clauses is None:
+            self._bind_clauses()
+        for clause in self._bound_clauses:
+            if not self._eval_clause(row, clause):
+                return False
+        return True
+
+    def _bind_clauses(self):
+        """将 WHERE 子句中的 ? 替换为实际参数（只执行一次）"""
+        self._bound_clauses = []
+        params = list(self._where_params)
+        for clause in self._where_clauses:
+            if "?" in clause and params:
+                val = params.pop(0)
+                if isinstance(val, str):
+                    val = f"'{val}'"
+                clause = clause.replace("?", str(val), 1)
+            self._bound_clauses.append(clause)
+
+    def _eval_clause(self, row: dict, clause: str) -> bool:
+        """评估单条已绑定的 WHERE 子句
+
+        clause 中的占位符 `?` 已在 `_bind_clauses` 中替换为实际值。
+        支持的操作符: =, !=, >, >=, <, <=, LIKE
+        """
+        parts = clause.strip().split(None, 2)
+        if len(parts) < 3:
+            return True
+
+        column, op, expected = parts[0], parts[1], parts[2]
+
+        # 去掉引号
+        expected = expected.strip("'\"")
+
+        actual = row.get(column)
+
+        # 类型转换
+        try:
+            expected = self._coerce_value(expected, actual)
+        except (ValueError, TypeError):
+            pass
+
+        if op == "=":
+            return actual == expected
+        elif op == "!=":
+            return actual != expected
+        elif op == ">":
+            return self._safe_cmp(actual, expected) > 0
+        elif op == ">=":
+            return self._safe_cmp(actual, expected) >= 0
+        elif op == "<":
+            return self._safe_cmp(actual, expected) < 0
+        elif op == "<=":
+            return self._safe_cmp(actual, expected) <= 0
+        elif op.upper() == "LIKE":
+            pattern = str(expected).replace("%", ".*").replace("_", ".")
+            import re
+            return bool(re.match(pattern, str(actual), re.IGNORECASE))
+        return True
+
+    @staticmethod
+    def _coerce_value(expected: Any, actual: Any) -> Any:
+        """根据 actual 的类型，将 expected 转换为同类型"""
+        if expected is None or actual is None:
+            return expected
+        if isinstance(actual, bool):
+            return str(expected).lower() in ("true", "1", "yes")
+        if isinstance(actual, int):
+            return int(expected)
+        if isinstance(actual, float):
+            return float(expected)
+        return str(expected)
+
+    @staticmethod
+    def _safe_cmp(a: Any, b: Any) -> int:
+        """安全比较，处理 None"""
+        if a is None and b is None:
+            return 0
+        if a is None:
+            return -1
+        if b is None:
+            return 1
+        try:
+            if a < b:
+                return -1
+            elif a > b:
+                return 1
+            return 0
+        except TypeError:
+            return -1 if str(a) < str(b) else 1
+
+    # ---- Execute ----
+
+    def Execute(self) -> list[tuple] | int:
+        if self._operation == "insert":
+            return self._exec_insert()
+        elif self._operation == "insert_multi":
+            return self._exec_insert_multi()
+        elif self._operation == "select":
+            return self._exec_select()
+        elif self._operation == "update":
+            return self._exec_update()
+        elif self._operation == "delete":
+            return self._exec_delete()
+        raise ValueError(f"Unknown operation: {self._operation}")
+
+    def _exec_insert(self) -> int:
+        if not isinstance(self._data, dict):
+            raise ValueError("Insert 操作需要字典数据")
+        row_id = self._get_next_id()
+        self._storage.set(self._row_key(row_id), json.dumps(self._data, ensure_ascii=False))
+        return 1
+
+    def _exec_insert_multi(self) -> int:
+        if not isinstance(self._data, list):
+            raise ValueError("InsertMulti 操作需要列表数据")
+        count = 0
+        for row in self._data:
+            row_id = self._get_next_id()
+            self._storage.set(self._row_key(row_id), json.dumps(row, ensure_ascii=False))
+            count += 1
+        return count
+
+    def _exec_select(self) -> list[tuple]:
+        rows = self._scan_rows()
+        # filter
+        if self._where_clauses:
+            rows = [(rid, r) for rid, r in rows if self._match_row(r)]
+        # order
+        if self._order_by:
+            for col, desc in reversed(self._order_by):
+                try:
+                    rows.sort(key=lambda x: x[1].get(col, ""), reverse=desc)
+                except TypeError:
+                    rows.sort(key=lambda x: str(x[1].get(col, "")), reverse=desc)
+        # offset
+        if self._offset:
+            rows = rows[self._offset:]
+        # limit
+        if self._limit is not None:
+            rows = rows[:self._limit]
+        # project
+        if self._columns:
+            return [tuple(r.get(c) for c in self._columns) for _, r in rows]
+        else:
+            return [tuple(r.values()) for _, r in rows]
+
+    def _exec_update(self) -> int:
+        if not isinstance(self._data, dict):
+            raise ValueError("Update 操作需要字典数据")
+        count = 0
+        for row_id, row in self._scan_rows():
+            if self._match_row(row):
+                row.update(self._data)
+                self._storage.set(self._row_key(row_id), json.dumps(row, ensure_ascii=False))
+                count += 1
+        return count
+
+    def _exec_delete(self) -> int:
+        count = 0
+        for row_id, row in self._scan_rows():
+            if self._match_row(row):
+                self._storage.delete(self._row_key(row_id))
+                count += 1
+        return count
+
+    # ---- ExecuteOne / Count / Exists ----
+
+    def ExecuteOne(self) -> tuple | None:
+        old_limit = self._limit
+        self._limit = 1
+        try:
+            rows = self._exec_select()
+            return rows[0] if rows else None
+        finally:
+            self._limit = old_limit
+
+    def Count(self) -> int:
+        rows = self._scan_rows()
+        if self._where_clauses:
+            rows = [(rid, r) for rid, r in rows if self._match_row(r)]
+        return len(rows)
+
+    def Exists(self) -> bool:
+        return self.Count() > 0
+
+    # ==================== 异步接口 ====================
+
+    async def _ascan_rows(self) -> list[tuple[int, dict]]:
+        """异步扫描所有行"""
+        all_keys = await self._storage.aget_all_keys()
+        rows = []
+        for key in all_keys:
+            if key.startswith(self._row_prefix()):
+                try:
+                    row_id = int(key.rsplit(":", 1)[-1])
+                except (ValueError, IndexError):
+                    continue
+                value = await self._storage.aget(key)
+                if isinstance(value, str):
+                    try:
+                        value = json.loads(value)
+                    except json.JSONDecodeError:
+                        pass
+                if isinstance(value, dict):
+                    rows.append((row_id, value))
+        return rows
+
+    async def aExecute(self) -> list[tuple] | int:
+        """异步执行查询"""
+        if self._operation == "insert":
+            if not isinstance(self._data, dict):
+                raise ValueError("Insert 操作需要字典数据")
+            row_id = self._get_next_id()
+            await self._storage.aset(self._row_key(row_id), json.dumps(self._data, ensure_ascii=False))
+            return 1
+        elif self._operation == "insert_multi":
+            if not isinstance(self._data, list):
+                raise ValueError("InsertMulti 操作需要列表数据")
+            count = 0
+            for row in self._data:
+                row_id = self._get_next_id()
+                await self._storage.aset(self._row_key(row_id), json.dumps(row, ensure_ascii=False))
+                count += 1
+            return count
+        elif self._operation == "select":
+            return await self._aexec_select()
+        elif self._operation == "update":
+            if not isinstance(self._data, dict):
+                raise ValueError("Update 操作需要字典数据")
+            count = 0
+            for row_id, row in await self._ascan_rows():
+                if self._match_row(row):
+                    row.update(self._data)
+                    await self._storage.aset(self._row_key(row_id), json.dumps(row, ensure_ascii=False))
+                    count += 1
+            return count
+        elif self._operation == "delete":
+            count = 0
+            for row_id, row in await self._ascan_rows():
+                if self._match_row(row):
+                    await self._storage.adelete(self._row_key(row_id))
+                    count += 1
+            return count
+        raise ValueError(f"Unknown operation: {self._operation}")
+
+    async def _aexec_select(self) -> list[tuple]:
+        rows = await self._ascan_rows()
+        if self._where_clauses:
+            rows = [(rid, r) for rid, r in rows if self._match_row(r)]
+        if self._order_by:
+            for col, desc in reversed(self._order_by):
+                try:
+                    rows.sort(key=lambda x: x[1].get(col, ""), reverse=desc)
+                except TypeError:
+                    rows.sort(key=lambda x: str(x[1].get(col, "")), reverse=desc)
+        if self._offset:
+            rows = rows[self._offset:]
+        if self._limit is not None:
+            rows = rows[:self._limit]
+        if self._columns:
+            return [tuple(r.get(c) for c in self._columns) for _, r in rows]
+        return [tuple(r.values()) for _, r in rows]
+
+    async def aExecuteOne(self) -> tuple | None:
+        old_limit = self._limit
+        self._limit = 1
+        try:
+            rows = await self._aexec_select()
+            return rows[0] if rows else None
+        finally:
+            self._limit = old_limit
+
+    async def aCount(self) -> int:
+        rows = await self._ascan_rows()
+        if self._where_clauses:
+            rows = [(rid, r) for rid, r in rows if self._match_row(r)]
+        return len(rows)
+
+    async def aExists(self) -> bool:
+        return await self.aCount() > 0