python-tty 0.1.0__py3-none-any.whl

python_tty/utils/tokenize.py

@@ -0,0 +1,45 @@
+import shlex
+
+
+def tokenize_cmd(cmd: str):
+    cmd = cmd.strip()
+    if cmd == "":
+        return []
+    try:
+        return shlex.split(cmd, posix=True)
+    except ValueError as exc:
+        raise ValueError("Invalid command arguments") from exc
+
+
+def get_command_token(cmd: str):
+    tokens = tokenize_cmd(cmd)
+    return tokens[0] if tokens else ""
+
+
+def get_func_param_strs(cmd: str, param_count: int):
+    if param_count <= 0:
+        return None
+    cmd = cmd.strip()
+    if cmd == "":
+        return []
+    if param_count == 1:
+        tokens = tokenize_cmd(cmd)
+        if len(tokens) == 1:
+            return tokens
+        return [cmd]
+    return tokenize_cmd(cmd)
+
+
+def split_cmd(cmd: str):
+    stripped = cmd.lstrip()
+    if stripped == "":
+        return "", "", []
+    tokens = tokenize_cmd(stripped)
+    if not tokens:
+        return "", "", []
+    token = tokens[0]
+    if stripped.startswith(token):
+        remainder = stripped[len(token):].lstrip()
+    else:
+        remainder = " ".join(tokens[1:])
+    return token, remainder, tokens

python_tty/utils/ui_logger.py

@@ -0,0 +1,17 @@
+import logging
+
+from python_tty.ui.events import UIEventLevel
+from python_tty.ui.output import proxy_print
+
+
+class ConsoleHandler(logging.Handler):
+    def __init__(self):
+        super().__init__()
+
+    def emit(self, record):
+        try:
+            log = self.format(record)
+            proxy_print(log, UIEventLevel.DEBUG)
+        except Exception:
+            self.handleError(record)
+

python_tty-0.1.0.dist-info/METADATA

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: python-tty
+Version: 0.1.0
+Summary: A multi-console TTY framework for complex CLI/TTY apps
+Home-page: https://github.com/ROOKIEMIE/python-tty
+Author: ROOKIEMIE
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: prompt_toolkit>=3.0.32
+Requires-Dist: tqdm
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Command Line Framework (V2: Web/RPC-ready)
+
+[中文](README_zh.md)
+
+V2 extends the TTY core toward Web + RPC, while keeping the current codebase focused on the TTY runtime. At the moment, Web/RPC is planned but not yet implemented.
+
+## Quick Start (TTY Core)
+
+1) Define your consoles and commands (see examples in `src/consoles/examples` and `src/commands/examples`).
+2) Ensure console modules are imported so decorators can register them:
+   - Update `DEFAULT_CONSOLE_MODULES` in `src/consoles/loader.py`, or
+   - Call `load_consoles([...])` manually.
+3) Start the factory:
+
+```python
+from src.console_factory import ConsoleFactory
+
+factory = ConsoleFactory(service=my_business_core)
+factory.start()
+```
+
+The `service` instance is available in all consoles via `console.service`, and in commands via `self.console.service`. If `service` does not inherit `UIEventSpeaker`, a warning is emitted at startup.
+
+## Current Capabilities (TTY Core)
+
+Console layer:
+- `src/consoles/core.py`: `BaseConsole`, `MainConsole`, `SubConsole`
+- `src/consoles/manager.py` and `src/consoles/registry.py` for lifecycle and registration
+
+Commands layer:
+- `src/commands/core.py`: `BaseCommands`, `CommandValidator`
+- `src/commands/registry.py`: `CommandRegistry`, `ArgSpec`
+- `src/commands/general.py`: `GeneralValidator`, `GeneralCompleter`
+- `src/commands/mixins.py`: `CommandMixin` and built-in mixins
+
+UI and utilities:
+- `src/core/events.py`: `UIEvent`, `UIEventLevel`, `UIEventSpeaker`
+- `src/ui/output.py`: `proxy_print`
+- `src/utils/`: `tokenize.py`, `table.py`, `ui_logger.py`
+
+## Roadmap (V2)
+
+Planned milestones for Web + RPC:
+- M1: Meta Descriptor v1 + Exporter
+- M2: RPC proto v1 + local (de)serialization
+- M3: Meta Web Server (HTTP + WS)
+- M4: RPC Server (mTLS + allowlist + audit)
+- M5: Unified execution system (CommandExecutor)

python_tty-0.1.0.dist-info/RECORD

@@ -0,0 +1,40 @@
+python_tty/__init__.py,sha256=VZvoBsZTUvvolO2r3hwsC2r-BDTxjpy6zZjykO0_ZT4,376
+python_tty/console_factory.py,sha256=yRWXsh8mNGyAxUUXe3el3ENKqL4fuAfUqZYBtScCii4,3666
+python_tty/commands/__init__.py,sha256=n3Thx4nzfnwFzEJ6JtrpX0_WuC1bntjtlH3-_ZSPPx8,455
+python_tty/commands/core.py,sha256=3TNfSGfMa8VxO_6Eoj7qMGJgnIdUGejHK2_UDReaeHo,4892
+python_tty/commands/decorators.py,sha256=MTCQrFlTK8cAHrgGjtjHETVmdnYI4-51G6CpcGP74S0,2656
+python_tty/commands/general.py,sha256=2uu848GJzdMpYv0bOAZwG7zczxeczzk0Ppdt413rjG0,3555
+python_tty/commands/mixins.py,sha256=zI47zAFmZ2uvuzohpq4wabXiHb45PbbXxmYkAVaM5Lw,1761
+python_tty/commands/registry.py,sha256=NQg87PHDSH8Pk8Zg9oUayi76O0LAJ-8EDAyrCdypH-0,7041
+python_tty/commands/examples/__init__.py,sha256=hToJIEZp-EK5atELlxola1U6pd-w21yhIqxD1MXo170,190
+python_tty/commands/examples/root_commands.py,sha256=L7cVS5I5ZrIrdSPS1Z1EIlOLN6WRDT925LSBR7uLi4M,1200
+python_tty/commands/examples/sub_commands.py,sha256=7Mfn48u8nKRTkY1bc3Fj4qYU9e_7aU8dB829AOQmDmc,447
+python_tty/config/__init__.py,sha256=5NlOOKUL0BqqO0zFPyN8N0MUDyfobEfjF2UM_FLkgkY,213
+python_tty/config/config.py,sha256=Seis2foQv6f1AEVQZM0IQGRYJBs2Dixm3G0hYlXIa0E,910
+python_tty/consoles/__init__.py,sha256=A_MC6Ot1EuQvjeSM75y5lE4WSbDph_t1JQYX8nuhmSU,403
+python_tty/consoles/core.py,sha256=ZWJub29TrlZB6oRXNXBRMGUvnNqvuUn_QT_tVa2lUaQ,5340
+python_tty/consoles/decorators.py,sha256=1RvZBpNXmvAF0J81duLc2uXsd9fX8VUrM5ZAPQjZqwQ,1554
+python_tty/consoles/loader.py,sha256=FAlRwewsiJb5qkqgmPDKEszJ59X4nG85QHbhfc-knBQ,371
+python_tty/consoles/manager.py,sha256=Z-0WepObqIL-Alt_ZmEIl9Kv-rMYy_xWSU359g2tYfw,4928
+python_tty/consoles/registry.py,sha256=IlwP-uhK8EnN-M4lEqdr8wggn9BJdraDGcq8u_BvIOw,3891
+python_tty/consoles/examples/__init__.py,sha256=8f_zr6JPVx1CCR9SEqqUVVOh689t6pZ0XoAigEnftDQ,190
+python_tty/consoles/examples/root_console.py,sha256=lg_p1KIYhF1z3WfGaoWsXelm46KD8HRHq_47F8Ol3yQ,834
+python_tty/consoles/examples/sub_console.py,sha256=K-IyIy1UL4kj6QKCU-L-4CUSzPca-Flw-ePaKPmNa6Q,885
+python_tty/exceptions/__init__.py,sha256=58tyDjS4S_jL4axvdmnryLoE9Sr73o5U6jehZvivbd8,161
+python_tty/exceptions/console_exception.py,sha256=5xwfYsHvqYmFVnwbGq3eDGk9FZyE6eV9l6YobTqaa-w,231
+python_tty/executor/__init__.py,sha256=k4Jv7n72IQN9BLmvi6ENbKhq405E5x8ongnVJXUFUhw,219
+python_tty/executor/executor.py,sha256=pnIODl4nI_foU6mgt6KdDiFLpGvVvAOUY6yWrATii7M,13561
+python_tty/executor/models.py,sha256=FJDxV58DR2pK3g5-kA0d-SLcBV14nn6Fm34MhmkKx30,997
+python_tty/frontends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_tty/meta/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_tty/ui/__init__.py,sha256=wBSHvOMA8cZJQJk4D8UjvqHB3ujvBte0E064IUABbbc,327
+python_tty/ui/events.py,sha256=qgyhDjkdU-K6j7_LDz9G33OZZxkHWOVxulq-oMzUBuU,1356
+python_tty/ui/output.py,sha256=3_linB6hpDfQHbuff6bm9HcdgCB21RUrkDI7iHvL5x8,2690
+python_tty/utils/__init__.py,sha256=8ky8A4s6NbxaEokdnUxhCxgIXjq5nFCeyOApjg0RfvI,338
+python_tty/utils/table.py,sha256=rAzxm-XTKbvKsn1Qoe_rXVjU6_5nQpJzSkgYZIRQBK8,4310
+python_tty/utils/tokenize.py,sha256=TnZd1o6LmvqbMWON_RTVk4q664TviIQTFVkNX4CTUBs,1055
+python_tty/utils/ui_logger.py,sha256=dCqflrliX2T6GdTFonUwEiHYHHF-wlj1QkqpVsFvxio,393
+python_tty-0.1.0.dist-info/METADATA,sha256=6gjvKuhYCMWeiyoEIy7gS2Z6jSrPK1VI8grMmqXiP6E,2293
+python_tty-0.1.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+python_tty-0.1.0.dist-info/top_level.txt,sha256=ZAEMWTGLkGwrlNN-lOeuJzAHB_xHAiEAecJ7CzS7FnY,11
+python_tty-0.1.0.dist-info/RECORD,,

python_tty-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

python_tty-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+python_tty