replx 1.3__tar.gz → 1.5__tar.gz

replx-1.5/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: replx
+Version: 1.5
+Summary: replx is a fast, modern MicroPython CLI: turbo REPL, robust file sync (put/get), project install, mpy-cross integration, and smart port discovery.
+Author-email: "chanmin.park" <devcamp@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/PlanXLab/replx
+Project-URL: Repository, https://github.com/PlanXLab/replx
+Project-URL: Issues, https://github.com/PlanXLab/replx/issues
+Keywords: micropython,repl,serial,pyserial,typer,mpy-cross,deploy
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Embedded Systems
+Classifier: Topic :: System :: Hardware :: Universal Serial Bus (USB)
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13.0
+Requires-Dist: pyserial>=3.5
+Requires-Dist: mpy-cross>=1.26
+Requires-Dist: psutil>=5.9.0
+Dynamic: license-file
+
+# replx
+
+[![PyPI version](https://badge.fury.io/py/replx.svg)](https://badge.fury.io/py/replx)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+`replx` is a CLI tool for MicroPython development. It uses an agent-based architecture to manage multiple CLI sessions and multiple boards in a consistent workflow.
+
+## What replx provides
+
+- Shared connection management across terminal sessions
+- Foreground and background board handling per session
+- Workspace-level default device configuration
+- File operations on device storage
+- Script execution, REPL access, and utility commands
+
+## Installation
+
+```sh
+pip install replx
+```
+
+## Command summary
+
+### Connection and session
+
+- `setup`: Initialize workspace settings and register a default device.
+- `scan`: List available serial devices.
+- `status`: Show session and connection state.
+- `fg`: Change the foreground device for the current session.
+- `whoami`: Show the current foreground device.
+- `disconnect`: Close a device connection.
+- `shutdown`: Stop the agent and clear active sessions.
+
+### Execution and interaction
+
+- `exec` (`-c`): Execute inline Python code on the device.
+- `run`: Run a local or device-side script.
+- `repl`: Open an interactive REPL session.
+- `shell`: Open a device file-system shell.
+
+### File operations
+
+- `ls`: List files and directories.
+- `cat`: Print file content.
+- `get`: Download files from device to local.
+- `put`: Upload files from local to device.
+- `cp`: Copy files or directories on device.
+- `mv`: Move or rename files or directories on device.
+- `rm`: Remove files or directories on device.
+- `mkdir`: Create directories on device.
+- `touch`: Create an empty file or update timestamps.
+
+### Device management
+
+- `usage`: Show device storage usage.
+- `reset`: Perform a soft reset.
+- `format`: Format the device file system.
+- `init`: Run initialization scripts on device.
+- `wifi`: Manage Wi-Fi configuration and status.
+- `firmware`: Check, download, or update firmware.
+
+### Package and build
+
+- `pkg`: Search, download, and update packages.
+- `mpy`: Compile `.py` files to `.mpy`.
+
+## Notes
+
+- `scan`, `status`, `whoami`, and `shutdown` are special commands and do not accept `--port`.
+- Most device commands can omit the port when a foreground or workspace default device is available.
+
+## License
+
+MIT

replx-1.5/README.md

@@ -0,0 +1,75 @@
+# replx
+
+[![PyPI version](https://badge.fury.io/py/replx.svg)](https://badge.fury.io/py/replx)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+`replx` is a CLI tool for MicroPython development. It uses an agent-based architecture to manage multiple CLI sessions and multiple boards in a consistent workflow.
+
+## What replx provides
+
+- Shared connection management across terminal sessions
+- Foreground and background board handling per session
+- Workspace-level default device configuration
+- File operations on device storage
+- Script execution, REPL access, and utility commands
+
+## Installation
+
+```sh
+pip install replx
+```
+
+## Command summary
+
+### Connection and session
+
+- `setup`: Initialize workspace settings and register a default device.
+- `scan`: List available serial devices.
+- `status`: Show session and connection state.
+- `fg`: Change the foreground device for the current session.
+- `whoami`: Show the current foreground device.
+- `disconnect`: Close a device connection.
+- `shutdown`: Stop the agent and clear active sessions.
+
+### Execution and interaction
+
+- `exec` (`-c`): Execute inline Python code on the device.
+- `run`: Run a local or device-side script.
+- `repl`: Open an interactive REPL session.
+- `shell`: Open a device file-system shell.
+
+### File operations
+
+- `ls`: List files and directories.
+- `cat`: Print file content.
+- `get`: Download files from device to local.
+- `put`: Upload files from local to device.
+- `cp`: Copy files or directories on device.
+- `mv`: Move or rename files or directories on device.
+- `rm`: Remove files or directories on device.
+- `mkdir`: Create directories on device.
+- `touch`: Create an empty file or update timestamps.
+
+### Device management
+
+- `usage`: Show device storage usage.
+- `reset`: Perform a soft reset.
+- `format`: Format the device file system.
+- `init`: Run initialization scripts on device.
+- `wifi`: Manage Wi-Fi configuration and status.
+- `firmware`: Check, download, or update firmware.
+
+### Package and build
+
+- `pkg`: Search, download, and update packages.
+- `mpy`: Compile `.py` files to `.mpy`.
+
+## Notes
+
+- `scan`, `status`, `whoami`, and `shutdown` are special commands and do not accept `--port`.
+- Most device commands can omit the port when a foreground or workspace default device is available.
+
+## License
+
+MIT

{replx-1.3 → replx-1.5}/replx/__init__.py

@@ -1,5 +1,5 @@
 __all__ = ["__version__", "get_version", "__description__"]
-__version__ = "1.3"
+__version__ = "1.5"
 __description__ = "Fast, modern MicroPython CLI with REPL, file sync, install, and smart port detection."
 __author__ = "PlanX Lab Development Team"
 

{replx-1.3 → replx-1.5}/replx/cli/agent/client/core.py

@@ -33,7 +33,7 @@ class AgentClient:
             self.sock.close()
             self.sock = None
 
-    def send_command(self, command: str, timeout: float = None, **args) -> Dict[str, Any]:
+    def send_command(self, command: str, timeout: float = None, max_retries: int = None, **args) -> Dict[str, Any]:
         if not self.sock:
             self.connect()
 
@@ -58,8 +58,11 @@ class AgentClient:
         request_data = AgentProtocol.encode_message(request)
 
         response = None
-        
-        max_attempts = 1 if effective_timeout < 1.0 else self.MAX_RETRIES
+
+        if max_retries is not None:
+            max_attempts = max(1, max_retries)
+        else:
+            max_attempts = 1 if effective_timeout < 1.0 else self.MAX_RETRIES
 
         for attempt in range(max_attempts):
             try:
@@ -154,7 +157,6 @@ class AgentClient:
         self.sock.settimeout(0.01)
         input_interval = 0.001
         last_input_time = 0
-        error_check_until = time.time() + 0.1
 
         try:
             while True:
@@ -179,15 +181,15 @@ class AgentClient:
                         except Exception:
                             pass
 
+                _pending_error = None
                 try:
                     data, addr = self.sock.recvfrom(MAX_UDP_SIZE)
                     msg = AgentProtocol.decode_message(data)
 
                     if msg and msg.get('seq') == seq:
-                        if now < error_check_until and msg.get('type') == 'response' and msg.get('error'):
-                            raise RuntimeError(msg['error'])
-
-                        if msg.get('type') == 'stream':
+                        if msg.get('type') == 'response' and msg.get('error'):
+                            _pending_error = msg['error']
+                        elif msg.get('type') == 'stream':
                             output = msg.get('output', '')
                             if output and output_callback:
                                 output_callback(output.encode('utf-8'), 'stdout')
@@ -203,6 +205,9 @@ class AgentClient:
                 except Exception:
                     pass
 
+                if _pending_error:
+                    raise RuntimeError(_pending_error)
+
         except KeyboardInterrupt:
             try:
                 self.send_command(Cmd.RUN_STOP, timeout=0.5)
@@ -321,13 +326,14 @@ class AgentClient:
         if port:
             cmd.append(str(port))
 
+        proc = None
         if background:
             if sys.platform == 'win32':
                 startupinfo = subprocess.STARTUPINFO()
                 startupinfo.dwFlags |= subprocess.STARTF_USESHOWWINDOW
                 startupinfo.wShowWindow = 0
 
-                subprocess.Popen(
+                proc = subprocess.Popen(
                     cmd,
                     creationflags=subprocess.CREATE_NEW_PROCESS_GROUP | subprocess.DETACHED_PROCESS,
                     stdout=subprocess.DEVNULL,
@@ -335,7 +341,7 @@ class AgentClient:
                     startupinfo=startupinfo
                 )
             else:
-                subprocess.Popen(
+                proc = subprocess.Popen(
                     cmd,
                     stdout=subprocess.DEVNULL,
                     stderr=subprocess.DEVNULL,
@@ -344,10 +350,12 @@ class AgentClient:
                     close_fds=True
                 )
         else:
-            subprocess.Popen(cmd)
+            proc = subprocess.Popen(cmd)
 
-        for i in range(30):
+        for _ in range(100):
             time.sleep(0.1)
+            if proc is not None and proc.poll() is not None:
+                raise RuntimeError(f"Failed to start agent (process exited with code {proc.returncode})")
             if AgentClient.is_agent_running(port=port):
                 return True
 

{replx-1.3 → replx-1.5}/replx/cli/agent/server/connection_manager.py

@@ -2,11 +2,13 @@ import re
 import sys
 import time
 import threading
+from concurrent.futures import Future as ConcurrentFuture
 from dataclasses import dataclass, field
 from typing import Optional, Dict, Any, List, Tuple
 
 from replx.protocol import ReplProtocol, create_storage
 from replx.utils import parse_device_banner
+from replx.utils.constants import CTRL_B, CTRL_C
 from replx.utils.exceptions import TransportError
 
 
@@ -16,11 +18,11 @@ def _detect_device_info(transport, core: str, device: str = None) -> Tuple[str,
     delay3 = 0.1 if sys.platform != "win32" else 0.2
     
     try:
-        transport.write(b'\r\x03')
+        transport.write(b'\r' + CTRL_C)
         time.sleep(delay1)
         transport.reset_input_buffer()
 
-        transport.write(b'\r\x02')
+        transport.write(b'\r' + CTRL_B)
         time.sleep(delay2)
 
         res = transport.read_available()
@@ -104,6 +106,7 @@ class InteractiveSessionState:
 class ReplSessionState:
     active: bool = False
     ppid: Optional[int] = None
+    reader_future: Optional[ConcurrentFuture] = None
     reader_thread: Optional[threading.Thread] = None
     output_buffer: bytes = b""
     buffer_lock: threading.Lock = field(default_factory=threading.Lock)
@@ -117,6 +120,9 @@ class ReplSessionState:
     def stop(self):
         self.active = False
         self.ppid = None
+        if self.reader_future is not None:
+            self.reader_future.cancel()
+            self.reader_future = None
         if self.reader_thread:
             self.reader_thread.join(timeout=1)
             self.reader_thread = None
@@ -152,7 +158,6 @@ class BoardConnection:
     version: str = "?"
     device_root_fs: str = "/"
     
-    # Unique board ID from machine.unique_id().hex() - lazy evaluated on first command
     board_id: Optional[str] = None
 
     busy: bool = False
@@ -428,10 +433,10 @@ class ConnectionManager:
             conn = self.get_connection(port)
             if conn and conn.repl_protocol:
                 try:
-                    transport = conn.repl_protocol._transport
-                    transport.write(b'\x03')
+                    transport = conn.repl_protocol.transport
+                    transport.write(CTRL_C)
                     time.sleep(0.05)
-                    transport.write(b'\x02')
+                    transport.write(CTRL_B)
                     time.sleep(0.1)
                     transport.reset_input_buffer()
                 except Exception:
@@ -461,8 +466,13 @@ class ConnectionManager:
 
         if conn.repl_protocol:
             try:
-                transport = conn.repl_protocol._transport
+                transport = conn.repl_protocol.transport
                 if transport:
+                    try:
+                        transport.write(CTRL_B)
+                        time.sleep(0.1 if sys.platform == 'win32' else 0.05)
+                    except Exception:
+                        pass
                     transport.close()
             except Exception:
                 pass