replx 1.6.7__tar.gz → 1.8__tar.gz

replx-1.8/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: replx
+Version: 1.8
+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,gpio,i2c,spi,uart,pwm,adc
+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`.
+
+### Hardware
+
+- `gpio`: Read, write, and run GPIO sequences.
+- `pwm`: Generate and monitor PWM signals.
+- `adc`: Read ADC pins and run a board-side scope UI.
+- `uart`: Open, write, read, and monitor UART.
+- `spi`: Open, write, read, and transfer SPI data.
+- `i2c`: Scan, read, write, and dump I2C devices.
+
+## 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.8/README.md

@@ -0,0 +1,84 @@
+# 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`.
+
+### Hardware
+
+- `gpio`: Read, write, and run GPIO sequences.
+- `pwm`: Generate and monitor PWM signals.
+- `adc`: Read ADC pins and run a board-side scope UI.
+- `uart`: Open, write, read, and monitor UART.
+- `spi`: Open, write, read, and transfer SPI data.
+- `i2c`: Scan, read, write, and dump I2C devices.
+
+## 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.6.7 → replx-1.8}/pyproject.toml

@@ -9,7 +9,7 @@ description = "replx is a fast, modern MicroPython CLI: turbo REPL, robust file
 readme = "README.md"
 authors = [{ name = "chanmin.park", email = "devcamp@gmail.com" }]
 requires-python = ">=3.10"
-keywords = ["micropython", "repl", "serial", "pyserial", "typer", "mpy-cross", "deploy"]
+keywords = ["micropython", "repl", "serial", "pyserial", "typer", "mpy-cross", "deploy", "gpio", "i2c", "spi", "uart", "pwm", "adc"]
 license = "MIT"
 license-files = ["LICENSE"]
 

{replx-1.6.7 → replx-1.8}/replx/__init__.py

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

{replx-1.6.7 → replx-1.8}/replx/cli/agent/server/handlers/repl.py

@@ -35,8 +35,7 @@ class ReplCommandsMixin:
             while conn.repl.active and conn.repl_protocol:
                 try:
                     data = await loop.run_in_executor(
-                        self._slow_executor,
-                        self._read_repl_chunk, repl
+                        self._slow_executor, self._read_repl_chunk, repl
                     )
                     if data:
                         conn.repl.append_output(data)

{replx-1.6.7 → replx-1.8}/replx/cli/app.py

@@ -353,9 +353,12 @@ def _print_main_help():
             ("mpy", "Compile Python files to .mpy bytecode"),
         ]),
         ("Hardware", [
-            ("i2c", "Scan, read, write, dump I2C devices on the connected board"),
             ("gpio", "Read, write, and run GPIO sequences on the connected board"),
+            ("pwm", "Generate and monitor PWM signals on the connected board"),
             ("adc", "Read ADC pins and run the board-side ADC scope UI"),
+            ("uart", "Open, write, read, monitor UART on the connected board"),
+            ("spi", "Open, write, read, xfer SPI devices on the connected board"),
+            ("i2c", "Scan, read, write, dump I2C devices on the connected board"),
         ]),
     ]
     

{replx-1.6.7 → replx-1.8}/replx/cli/commands/adc.py

@@ -1145,9 +1145,19 @@ def adc_cmd(
     sample: int = typer.Option(10, "--sample", metavar="MS", help="Initial scope render rate"),
     show_help: bool = typer.Option(False, "--help", "-h", is_eager=True, hidden=True),
 ):
-    if show_help or not args:
+    if show_help:
         _print_adc_help()
         raise typer.Exit()
+    if not args:
+        OutputHelper.print_panel(
+            "Subcommands: [bright_blue]read[/bright_blue]  [bright_blue]scope[/bright_blue]\n\n"
+            "  [bright_green]replx PORT adc read GP26[/bright_green]\n"
+            "  [bright_green]replx PORT adc scope GP26 GP27 GP28[/bright_green]\n\n"
+            "Use [bright_blue]replx adc --help[/bright_blue] for details.",
+            title="ADC",
+            border_style="yellow",
+        )
+        raise typer.Exit(1)
 
     subcmd = args[0].lower()
     pos_args = args[1:]

{replx-1.6.7 → replx-1.8}/replx/cli/commands/exec.py

@@ -10,6 +10,7 @@ import shlex
 import hashlib
 import subprocess
 import shutil
+from collections import deque
 from pathlib import Path
 
 import typer
@@ -73,6 +74,29 @@ def _wrap_trailing_expression_for_print(code: str) -> str:
         return code
 
 
+def _is_repl_enter_key(ch: bytes) -> bool:
+    return ch in (b"\r", b"\n", b"\r\n", b"\n\r")
+
+
+def _setup_readline_for_repl():
+    try:
+        import readline
+    except ImportError:
+        return None
+
+    try:
+        readline.parse_and_bind("set editing-mode emacs")
+    except Exception:
+        pass
+
+    try:
+        readline.set_auto_history(False)
+    except Exception:
+        pass
+
+    return readline
+
+
 def _resolve_vscode_command() -> list[str] | None:
     candidates = ["code", "code-insiders", "codium"]
     comspec = os.environ.get("COMSPEC", "cmd.exe")
@@ -1355,6 +1379,45 @@ Start a live MicroPython session where you can type code line by line.
     
     repl_running = [True]
     reader_client = [None]
+    pending_echoes = deque()
+    pending_echo_lock = threading.Lock()
+    pending_output_fragment = [""]
+
+    def _queue_pending_echo(line: str) -> None:
+        with pending_echo_lock:
+            pending_echoes.append(line + "\r\n")
+
+    def _strip_pending_echo(output: str) -> str:
+        if not output:
+            return output
+
+        with pending_echo_lock:
+            text = pending_output_fragment[0] + output
+            normalized = text.replace("\r\n", "\n")
+            pending_output_fragment[0] = ""
+
+            if not normalized:
+                return ""
+
+            trailing_fragment = "" if normalized.endswith("\n") else normalized.split("\n")[-1]
+            lines = normalized.splitlines(keepends=True)
+            if trailing_fragment and lines:
+                lines = lines[:-1]
+
+            kept: list[str] = []
+            for line in lines:
+                if pending_echoes and line == pending_echoes[0].replace("\r\n", "\n"):
+                    pending_echoes.popleft()
+                    continue
+                kept.append(line)
+
+            if trailing_fragment:
+                if pending_echoes and pending_echoes[0].replace("\r\n", "\n").startswith(trailing_fragment):
+                    pending_output_fragment[0] = trailing_fragment
+                else:
+                    kept.append(trailing_fragment)
+
+            return "".join(kept)
     
     def reader_thread_func():
         try:
@@ -1366,6 +1429,10 @@ Start a live MicroPython session where you can type code line by line.
                     output = result.get('output', '')
                     if output:
                         sleep_time = 0.005
+                        if sys.platform == 'darwin':
+                            output = _strip_pending_echo(output)
+                            if not output:
+                                continue
                         output = colorize_prompt(output)
                         if IS_WINDOWS:
                             sys.stdout.buffer.write(output.encode('utf-8').replace(b'\r', b''))
@@ -1390,6 +1457,7 @@ Start a live MicroPython session where you can type code line by line.
     reader.start()
     
     writer_client = _create_agent_client()
+    repl_enter_data = '\r'
 
     _old_console_mode = disable_quick_edit_mode()
 
@@ -1430,53 +1498,73 @@ Start a live MicroPython session where you can type code line by line.
     _atexit.register(_restore_console)
 
     input_buffer = ""
-    
+
     try:
-        while True:
-            char = _repl_getch()
-            
-            if char == b'\x00' or not char:
-                continue
-            
-            if char == CTRL_D:
-                input_buffer = ""
+        if sys.platform == 'darwin':
+            readline_mod = _setup_readline_for_repl()
+            while True:
                 try:
-                    writer_client.send_command('repl_write', data='\x04', timeout=1.5, max_retries=1)
-                except Exception:
+                    line = input()
+                except EOFError:
                     break
-                continue
-            
-            if char in (b'\r', b'\n'):
-                if input_buffer.strip() == 'exit()':
-                    repl_running[0] = False
-                    reader.join(timeout=0.3)
+                except KeyboardInterrupt:
                     try:
                         writer_client.send_command('repl_write', data='\x03', timeout=1.5, max_retries=1)
                     except Exception:
-                        pass
+                        break
+                    continue
+
+                if line.strip() == 'exit()':
                     break
-                input_buffer = ""
+
                 try:
-                    writer_client.send_command('repl_write', data='\r', timeout=1.5, max_retries=1)
+                    if readline_mod and line and (readline_mod.get_current_history_length() == 0 or readline_mod.get_history_item(readline_mod.get_current_history_length()) != line):
+                        readline_mod.add_history(line)
+                    _queue_pending_echo(line)
+                    writer_client.send_command('repl_write', data=line + repl_enter_data, timeout=1.5, max_retries=1)
                 except Exception:
                     break
-            elif char == b'\x7f' or char == b'\x08':
-                if input_buffer:
-                    input_buffer = input_buffer[:-1]
-                try:
-                    writer_client.send_command('repl_write', data=char.decode('utf-8', errors='replace'), timeout=1.5, max_retries=1)
-                except Exception:
+        else:
+            while True:
+                char = getch()
+                
+                if char == b'\x00' or not char:
+                    continue
+                
+                if char == CTRL_D:
                     break
-            else:
-                if char >= b' ':
+                
+                if _is_repl_enter_key(char):
+                    if input_buffer.strip() == 'exit()':
+                        repl_running[0] = False
+                        reader.join(timeout=0.3)
+                        try:
+                            writer_client.send_command('repl_write', data='\x03', timeout=1.5, max_retries=1)
+                        except Exception:
+                            pass
+                        break
+                    input_buffer = ""
                     try:
-                        input_buffer += char.decode('utf-8', errors='ignore')
-                    except UnicodeDecodeError:
-                        pass
-                try:
-                    writer_client.send_command('repl_write', data=char.decode('utf-8', errors='replace'), timeout=1.5, max_retries=1)
-                except Exception:
-                    break
+                        writer_client.send_command('repl_write', data=repl_enter_data, timeout=1.5, max_retries=1)
+                    except Exception:
+                        break
+                elif char == b'\x7f' or char == b'\x08':
+                    if input_buffer:
+                        input_buffer = input_buffer[:-1]
+                    try:
+                        writer_client.send_command('repl_write', data=char.decode('utf-8', errors='replace'), timeout=1.5, max_retries=1)
+                    except Exception:
+                        break
+                else:
+                    if char >= b' ':
+                        try:
+                            input_buffer += char.decode('utf-8', errors='ignore')
+                        except UnicodeDecodeError:
+                            pass
+                    try:
+                        writer_client.send_command('repl_write', data=char.decode('utf-8', errors='replace'), timeout=1.5, max_retries=1)
+                    except Exception:
+                        break
                 
     except KeyboardInterrupt:
         pass

{replx-1.6.7 → replx-1.8}/replx/cli/commands/gpio.py

@@ -263,7 +263,6 @@ _next_level = bytearray(1)
 
 
 def _isr(pin):
-    """Hard-IRQ handler: zero heap allocation."""
     global _wr, _overflow
     nxt = (_wr + 1) % _BUF_SIZE
     if nxt == _rd:
@@ -276,7 +275,6 @@ def _isr(pin):
 
 
 def _flush_buf():
-    """Drain all pending edges into a plain list (called from main loop only)."""
     global _rd, _overflow
     edges = []
     while _rd != _wr:
@@ -307,7 +305,6 @@ def _make_plot():
 
 
 def _poll_key():
-    """Return the first pending character, or None. Raises KeyboardInterrupt on Ctrl+C."""
     r, _, _ = _sel.select([sys.stdin], [], [], 0)
     if not r:
         return None
@@ -318,7 +315,6 @@ def _poll_key():
 
 
 def _draw_log(w, log_buf, log_pos):
-    """Redraw all 8 edge-log rows (oldest at top, newest at bottom)."""
     for i in range(_LOG_N):
         idx = (log_pos - _LOG_N + i) % _LOG_N
         entry = log_buf[idx]
@@ -394,10 +390,8 @@ def main():
 
             t_now = time.ticks_us()
             held = time.ticks_diff(t_now, last_change_t)
-            # Update last known level from IRQ edge history (avoids pin.value() race)
             if edges:
                 last_irq_level = edges[-1][1]
-            # Advance scope exactly one tick per render loop with correct level
             _pt = sc._t
             sc.tick([float(last_irq_level)])
             if sc._t <= _pt:
@@ -468,7 +462,6 @@ def _make_write_code(pin_no: int, pin_name: str, value: int) -> str:
 
 
 def _mk_timeout_exit(action: str, read_pin_name: str, indent: int = 12) -> str:
-    """Generate the MicroPython timeout-exit snippet (used inside while loops)."""
     pad = " " * indent
     return (
         f"{pad}res['read_action']={action!r}\n"
@@ -1178,9 +1171,20 @@ def gpio_cmd(
     repeat: int = typer.Option(1, "--repeat", metavar="N", help="Repeat gpio read N times (0=infinite until Ctrl+C, default 1)"),
     show_help: bool = typer.Option(False, "--help", "-h", is_eager=True, hidden=True),
 ):
-    if show_help or not args:
+    if show_help:
         _print_gpio_help()
         raise typer.Exit()
+    if not args:
+        OutputHelper.print_panel(
+            "Subcommands: [bright_blue]monitor[/bright_blue]  [bright_blue]read[/bright_blue]  [bright_blue]write[/bright_blue]  [bright_blue]seq[/bright_blue]\n\n"
+            "  [bright_green]replx PORT gpio read GP1[/bright_green]\n"
+            "  [bright_green]replx PORT gpio write GP25 1[/bright_green]\n"
+            "  [bright_green]replx PORT gpio monitor GP1[/bright_green]\n\n"
+            "Use [bright_blue]replx gpio --help[/bright_blue] for details.",
+            title="GPIO",
+            border_style="yellow",
+        )
+        raise typer.Exit(1)
 
     subcmd = args[0].lower()
     pos_args = args[1:]