mpytool 2.3.2__tar.gz → 2.3.4__tar.gz

{mpytool-2.3.2/mpytool.egg-info → mpytool-2.3.4}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: mpytool
-Version: 2.3.2
+Version: 2.3.4
 Summary: MPY tool - manage files on devices running MicroPython
-Author-email: Pavel Revak <pavel.revak@gmail.com>
+Author-email: Pavel Revak <pavelrevak@gmail.com>
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/pavelrevak/mpytool
+Project-URL: Homepage, https://github.com/cortexm/mpytool
 Keywords: MPY,micropython
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -55,7 +55,7 @@ pip3 install mpytool
 ### Installation from git (latest development version)
 
 ```bash
-pip3 install git+https://github.com/pavelrevak/mpytool.git
+pip3 install git+https://github.com/cortexm/mpytool.git
 ```
 
 ### Installation in virtualenv
@@ -254,7 +254,11 @@ RESET soft
 $ mpytool reset --machine    # MCU reset (machine.reset, auto-reconnect)
 RESET machine
 
-$ mpytool reset -- monitor   # reset and monitor output
+$ mpytool reset -- monitor   # reset and monitor until program ends
+RESET soft
+MONITOR (until program ends, -f to follow)
+
+$ mpytool reset -- monitor -f  # reset and monitor continuously
 RESET soft
 MONITOR (Ctrl+C to stop)
 
@@ -275,7 +279,8 @@ REPL (Ctrl+] to exit)  CWD: /  PATH: : :.frozen :/lib
 
 $ mpytool -p /dev/ttyUSB0 repl       # specify port
 $ mpytool -b 9600 repl               # specify baudrate
-$ mpytool -p /dev/ttyUSB0 -b 9600 monitor   # monitor at 9600 baud
+$ mpytool -p /dev/ttyUSB0 -b 9600 monitor   # monitor until program ends
+$ mpytool monitor -f                        # follow output continuously (Ctrl-C to stop)
 ```
 
 The `repl` command with `-v` flag displays current working directory (CWD) and `sys.path` before entering REPL, making it easy to see the device state after `mount`, `cd`, or `path` commands.
@@ -284,24 +289,30 @@ Both `repl` and `monitor` can be used as general-purpose serial tools - not just
 
 ### Execute Python code on device
 ```
-$ mpytool exec "print('Hello!')"
+$ mpytool exec "print('Hello!')"         # execute and stream output
 EXEC: print('Hello!')
 Hello!
 
 $ mpytool exec "import sys; print(sys.version)"
 EXEC: import sys; print(sys.version)
 3.4.0; MicroPython v1.24.0
+
+$ mpytool exec "long_task()" -t 30       # timeout after 30 seconds
+$ mpytool exec "start_server()" -t 0     # fire-and-forget (don't wait)
 ```
 
 ### Run local Python file on device
 ```
-$ mpytool run script.py                  # run script (fire-and-forget)
+$ mpytool run script.py                  # run and stream output
 RUN: script.py (128 bytes)
+Hello from script!
 
-$ mpytool run script.py -- monitor       # run script and capture output
+$ mpytool run script.py -t 0             # fire-and-forget (don't wait)
 RUN: script.py (128 bytes)
-MONITOR (Ctrl+C to stop)
-Hello from script!
+
+$ mpytool run script.py -t 10            # timeout after 10 seconds
+RUN: script.py (128 bytes)
+Done!
 ```
 
 ### Edit file on device
@@ -608,11 +619,12 @@ Scanning...
 
 ## Debug output
 
-- `-d` print warnings (yellow)
-- `-dd` print info messages (purple)
-- `-ddd` print debug messages (blue)
+By default, errors and warnings are shown.
+
+- `-d` also print info messages (purple)
+- `-dd` also print debug messages (blue)
 
-For reporting bugs, please include `-ddd` output in the issue.
+For reporting bugs, please include `-dd` output in the issue.
 
 ## Performance
 
@@ -649,7 +661,7 @@ autoload -Uz compinit && compinit
 **Quick install (or update):**
 ```bash
 mkdir -p ~/.zsh/completions
-curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/_mpytool -o ~/.zsh/completions/_mpytool
+curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/_mpytool -o ~/.zsh/completions/_mpytool
 grep -q '\.zsh/completions' ~/.zshrc || echo 'fpath=(~/.zsh/completions $fpath); autoload -Uz compinit && compinit' >> ~/.zshrc
 exec zsh
 ```
@@ -670,17 +682,17 @@ source ~/.mpytool-completion.bash
 
 **Quick install (Linux system-wide):**
 ```bash
-sudo curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/mpytool.bash -o /etc/bash_completion.d/mpytool && exec bash
+sudo curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/mpytool.bash -o /etc/bash_completion.d/mpytool && exec bash
 ```
 
 **Quick install (macOS Homebrew):**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/mpytool.bash -o /usr/local/etc/bash_completion.d/mpytool && exec bash
+curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/mpytool.bash -o /usr/local/etc/bash_completion.d/mpytool && exec bash
 ```
 
 **Quick install (user directory):**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/mpytool.bash -o ~/.mpytool-completion.bash
+curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/mpytool.bash -o ~/.mpytool-completion.bash
 grep -q 'mpytool-completion' ~/.bashrc || echo 'source ~/.mpytool-completion.bash' >> ~/.bashrc
 exec bash
 ```
@@ -756,4 +768,4 @@ MIT
 ### Support
 
 - Basic support is free over GitHub issues.
-- Professional support is available over email: [Pavel Revak](mailto:pavel.revak@gmail.com?subject=[GitHub]%20mpytool).
+- Professional support is available over email: [Pavel Revak](mailto:pavelrevak@gmail.com?subject=[GitHub]%20mpytool).

mpytool-2.3.2/PKG-INFO → mpytool-2.3.4/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: mpytool
-Version: 2.3.2
-Summary: MPY tool - manage files on devices running MicroPython
-Author-email: Pavel Revak <pavel.revak@gmail.com>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/pavelrevak/mpytool
-Keywords: MPY,micropython
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyserial>=3.0
-Dynamic: license-file
-
 # mpytool
 
 MPY tool - manage files on devices running MicroPython
@@ -55,7 +41,7 @@ pip3 install mpytool
 ### Installation from git (latest development version)
 
 ```bash
-pip3 install git+https://github.com/pavelrevak/mpytool.git
+pip3 install git+https://github.com/cortexm/mpytool.git
 ```
 
 ### Installation in virtualenv
@@ -254,7 +240,11 @@ RESET soft
 $ mpytool reset --machine    # MCU reset (machine.reset, auto-reconnect)
 RESET machine
 
-$ mpytool reset -- monitor   # reset and monitor output
+$ mpytool reset -- monitor   # reset and monitor until program ends
+RESET soft
+MONITOR (until program ends, -f to follow)
+
+$ mpytool reset -- monitor -f  # reset and monitor continuously
 RESET soft
 MONITOR (Ctrl+C to stop)
 
@@ -275,7 +265,8 @@ REPL (Ctrl+] to exit)  CWD: /  PATH: : :.frozen :/lib
 
 $ mpytool -p /dev/ttyUSB0 repl       # specify port
 $ mpytool -b 9600 repl               # specify baudrate
-$ mpytool -p /dev/ttyUSB0 -b 9600 monitor   # monitor at 9600 baud
+$ mpytool -p /dev/ttyUSB0 -b 9600 monitor   # monitor until program ends
+$ mpytool monitor -f                        # follow output continuously (Ctrl-C to stop)
 ```
 
 The `repl` command with `-v` flag displays current working directory (CWD) and `sys.path` before entering REPL, making it easy to see the device state after `mount`, `cd`, or `path` commands.
@@ -284,24 +275,30 @@ Both `repl` and `monitor` can be used as general-purpose serial tools - not just
 
 ### Execute Python code on device
 ```
-$ mpytool exec "print('Hello!')"
+$ mpytool exec "print('Hello!')"         # execute and stream output
 EXEC: print('Hello!')
 Hello!
 
 $ mpytool exec "import sys; print(sys.version)"
 EXEC: import sys; print(sys.version)
 3.4.0; MicroPython v1.24.0
+
+$ mpytool exec "long_task()" -t 30       # timeout after 30 seconds
+$ mpytool exec "start_server()" -t 0     # fire-and-forget (don't wait)
 ```
 
 ### Run local Python file on device
 ```
-$ mpytool run script.py                  # run script (fire-and-forget)
+$ mpytool run script.py                  # run and stream output
+RUN: script.py (128 bytes)
+Hello from script!
+
+$ mpytool run script.py -t 0             # fire-and-forget (don't wait)
 RUN: script.py (128 bytes)
 
-$ mpytool run script.py -- monitor       # run script and capture output
+$ mpytool run script.py -t 10            # timeout after 10 seconds
 RUN: script.py (128 bytes)
-MONITOR (Ctrl+C to stop)
-Hello from script!
+Done!
 ```
 
 ### Edit file on device
@@ -608,11 +605,12 @@ Scanning...
 
 ## Debug output
 
-- `-d` print warnings (yellow)
-- `-dd` print info messages (purple)
-- `-ddd` print debug messages (blue)
+By default, errors and warnings are shown.
+
+- `-d` also print info messages (purple)
+- `-dd` also print debug messages (blue)
 
-For reporting bugs, please include `-ddd` output in the issue.
+For reporting bugs, please include `-dd` output in the issue.
 
 ## Performance
 
@@ -649,7 +647,7 @@ autoload -Uz compinit && compinit
 **Quick install (or update):**
 ```bash
 mkdir -p ~/.zsh/completions
-curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/_mpytool -o ~/.zsh/completions/_mpytool
+curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/_mpytool -o ~/.zsh/completions/_mpytool
 grep -q '\.zsh/completions' ~/.zshrc || echo 'fpath=(~/.zsh/completions $fpath); autoload -Uz compinit && compinit' >> ~/.zshrc
 exec zsh
 ```
@@ -670,17 +668,17 @@ source ~/.mpytool-completion.bash
 
 **Quick install (Linux system-wide):**
 ```bash
-sudo curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/mpytool.bash -o /etc/bash_completion.d/mpytool && exec bash
+sudo curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/mpytool.bash -o /etc/bash_completion.d/mpytool && exec bash
 ```
 
 **Quick install (macOS Homebrew):**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/mpytool.bash -o /usr/local/etc/bash_completion.d/mpytool && exec bash
+curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/mpytool.bash -o /usr/local/etc/bash_completion.d/mpytool && exec bash
 ```
 
 **Quick install (user directory):**
 ```bash
-curl -fsSL https://raw.githubusercontent.com/pavelrevak/mpytool/main/completions/mpytool.bash -o ~/.mpytool-completion.bash
+curl -fsSL https://raw.githubusercontent.com/cortexm/mpytool/main/completions/mpytool.bash -o ~/.mpytool-completion.bash
 grep -q 'mpytool-completion' ~/.bashrc || echo 'source ~/.mpytool-completion.bash' >> ~/.bashrc
 exec bash
 ```
@@ -756,4 +754,4 @@ MIT
 ### Support
 
 - Basic support is free over GitHub issues.
-- Professional support is available over email: [Pavel Revak](mailto:pavel.revak@gmail.com?subject=[GitHub]%20mpytool).
+- Professional support is available over email: [Pavel Revak](mailto:pavelrevak@gmail.com?subject=[GitHub]%20mpytool).

{mpytool-2.3.2 → mpytool-2.3.4}/mpytool/__init__.py

@@ -3,6 +3,6 @@
 from mpytool.conn import ConnError, Timeout
 from mpytool.conn_serial import ConnSerial
 from mpytool.conn_socket import ConnSocket
-from mpytool.mpy_comm import MpyError, CmdError
+from mpytool.mpy_comm import MpyComm, MpyError, CmdError
 from mpytool.mpy import Mpy, PathNotFound, FileNotFound, DirNotFound
 from mpytool.logger import SimpleColorLogger

{mpytool-2.3.2 → mpytool-2.3.4}/mpytool/cmd_cp.py

@@ -79,8 +79,8 @@ class CopyCommand:
         # Cache
         self._remote_file_cache = {}
 
-        # Debug mode
-        self._is_debug = getattr(self._log, 'loglevel', 1) >= 4
+        # Info mode disables progress overwrite (each update on new line)
+        self._is_info = self._log.is_info
 
     @property
     def _verbose(self):
@@ -196,7 +196,7 @@ class CopyCommand:
             line = self._format_progress_line(percent, total)
         else:
             line = self._format_compact_progress(f"{percent:3d}%", total)
-        if self._is_debug:
+        if self._is_info:
             self.verbose(line, color='cyan')
         else:
             self.verbose(line, color='cyan', end='', overwrite=True)
@@ -207,7 +207,7 @@ class CopyCommand:
             line = self._format_progress_line(100, total, encodings)
         else:
             line = self._format_compact_complete(total)
-        self.verbose(line, color='cyan', overwrite=not self._is_debug)
+        self.verbose(line, color='cyan', overwrite=not self._is_info)
 
     def _set_progress_info(self, src, dst, is_src_remote, is_dst_remote):
         """Set progress source and destination paths"""
@@ -673,7 +673,7 @@ class CopyCommand:
         self._force = force
         self._compress = compress
         if mpy:
-            self._mpy_cross = MpyCross(self._log, self.verbose)
+            self._mpy_cross = MpyCross(self._log)
 
         try:
             self._run_impl(paths)
@@ -831,7 +831,7 @@ class CopyCommand:
 
     def print_transfer_info(self):
         """Print transfer settings (chunk size and compression)"""
-        chunk = self.mpy.detect_chunk_size()
+        chunk = self.mpy.chunk_size
         chunk_str = f"{chunk // 1024}K" if chunk >= 1024 else str(chunk)
         if self._compress is None:
             compress = self.mpy.detect_deflate()

{mpytool-2.3.2 → mpytool-2.3.4}/mpytool/conn.py

@@ -3,6 +3,8 @@
 import time as _time
 import select as _select
 
+from mpytool.logger import SimpleColorLogger as _SimpleColorLogger
+
 # VFS escape byte - signals start of VFS command from device
 ESCAPE = 0x18
 
@@ -17,7 +19,7 @@ class Timeout(ConnError):
 
 class Conn():
     def __init__(self, log=None):
-        self._log = log
+        self._log = log if log is not None else _SimpleColorLogger()
         self._buffer = bytearray()
         self._escape_handlers = {}  # {escape_byte: handler}
         self._active_handler = None  # Currently processing handler

{mpytool-2.3.2 → mpytool-2.3.4}/mpytool/conn_serial.py

@@ -22,20 +22,24 @@ class ConnSerial(_conn.Conn):
         # Windows: pyserial has no fd, select() works only with sockets
         if not hasattr(self._serial, 'fd'):
             self._has_data = self._has_data_polling
-        # Debug info about port type
-        if self._log:
-            port = serial_config.get('port', '')
-            if self._port_info and self._port_info.vid:
-                vid = self._port_info.vid
-                pid = self._port_info.pid
-                self._log.info(
-                    "Connected to %s [%04X:%04X %s]",
-                    port, vid, pid, self.port_type)
-            else:
-                self._log.info("Connected to %s [unknown serial port]", port)
+        # Debug info about port
+        port = serial_config.get('port', '')
+        if self._port_info and self._port_info.vid:
+            desc = _utils._port_description(self._port_info)
+            self._log.info("Connected to %s [%s]", port, desc)
+        else:
+            self._log.info("Connected to %s [unknown serial port]", port)
 
     def close(self):
         if self._serial:
+            # Prevent ESP32 reset when driver clears DTR/RTS on close
+            # Only for USB-UART bridges (CP2102, CH340, etc.), not USB-CDC
+            if self._is_usb_uart():
+                try:
+                    self._serial.rts = False
+                    self._serial.dtr = False
+                except OSError:
+                    pass
             self._serial.close()
             self._serial = None
 
@@ -69,7 +73,7 @@ class ConnSerial(_conn.Conn):
             in_waiting = self._serial.in_waiting
             if in_waiting > 0:
                 data = self._serial.read(in_waiting)
-                if data and self._log:
+                if data:
                     self._log.debug("RX: %r", data)
                 return data
             return None
@@ -80,8 +84,7 @@ class ConnSerial(_conn.Conn):
         """Write data to serial port"""
         if self._serial is None:
             raise _conn.ConnError("Not connected")
-        if self._log:
-            self._log.debug("TX: %r", data)
+        self._log.debug("TX: %r", data)
         try:
             return self._serial.write(data)
         except OSError as err:
@@ -117,8 +120,7 @@ class ConnSerial(_conn.Conn):
         if not self._is_usb_uart():
             raise _conn.ConnError(
                 f"Hardware reset not supported on {self.port_type}")
-        if self._log:
-            self._log.info("hard_reset: using DTR/RTS")
+        self._log.info("hard_reset: using DTR/RTS")
         self._serial.setDTR(False)  # GPIO0 high (normal boot)
         self._serial.setRTS(True)   # Assert reset
         _time.sleep(0.1)
@@ -159,8 +161,7 @@ class ConnSerial(_conn.Conn):
         if not self._is_usb_uart():
             raise _conn.ConnError(
                 f"Bootloader reset not supported on {self.port_type}")
-        if self._log:
-            self._log.info("reset_to_bootloader: using DTR/RTS")
+        self._log.info("reset_to_bootloader: using DTR/RTS")
         self._serial.setDTR(False)  # GPIO0 high
         self._serial.setRTS(True)   # Assert reset
         _time.sleep(0.1)

{mpytool-2.3.2 → mpytool-2.3.4}/mpytool/conn_socket.py

@@ -49,8 +49,7 @@ class ConnSocket(_conn.Conn):
         try:
             data = self._socket.recv(4096)
             if data:
-                if self._log:
-                    self._log.debug("RX: %r", data)
+                self._log.debug("RX: %r", data)
                 return data
         except BlockingIOError:
             pass
@@ -62,8 +61,7 @@ class ConnSocket(_conn.Conn):
         """Write data to socket"""
         if self._socket is None:
             raise _conn.ConnError("Not connected")
-        if self._log:
-            self._log.debug("TX: %r", data)
+        self._log.debug("TX: %r", data)
         try:
             return self._socket.send(data)
         except OSError as err:

{mpytool-2.3.2 → mpytool-2.3.4}/mpytool/logger.py

@@ -4,6 +4,12 @@ import os as _os
 import sys as _sys
 
 
+# Log levels (compatible with Python logging)
+DEBUG = 10
+INFO = 20
+WARNING = 30
+ERROR = 40
+
 class SimpleColorLogger():
     # ANSI color codes
     _RESET = '\033[0m'
@@ -25,7 +31,7 @@ class SimpleColorLogger():
         'cyan': _BOLD_CYAN,
     }
 
-    def __init__(self, loglevel=1, verbose_level=0):
+    def __init__(self, loglevel=WARNING, verbose_level=0):
         self._loglevel = loglevel
         self._verbose_level = verbose_level
         self._is_tty = _sys.stderr.isatty()
@@ -40,9 +46,24 @@ class SimpleColorLogger():
 
     @property
     def loglevel(self):
-        """Return current log level (1=error, 2=warning, 3=info, 4=debug)"""
+        """Return current log level (DEBUG=10, INFO=20, WARNING=30, ERROR=40)"""
         return self._loglevel
 
+    @property
+    def is_debug(self):
+        """True if debug messages are enabled"""
+        return self._loglevel <= DEBUG
+
+    @property
+    def is_info(self):
+        """True if info messages are enabled"""
+        return self._loglevel <= INFO
+
+    @property
+    def is_warning(self):
+        """True if warning messages are enabled"""
+        return self._loglevel <= WARNING
+
     def colorize(self, text, color):
         """Return text wrapped in color codes if colors are enabled"""
         if not self._color:
@@ -67,7 +88,7 @@ class SimpleColorLogger():
     def error(self, msg, *args):
         if args:
             msg = msg % args
-        if self._loglevel >= 1:
+        if self._loglevel <= ERROR:
             if self._color:
                 self.log(f"{self._BOLD_RED}{msg}{self._RESET}")
             else:
@@ -76,7 +97,7 @@ class SimpleColorLogger():
     def warning(self, msg, *args):
         if args:
             msg = msg % args
-        if self._loglevel >= 2:
+        if self._loglevel <= WARNING:
             if self._color:
                 self.log(f"{self._BOLD_YELLOW}{msg}{self._RESET}")
             else:
@@ -85,7 +106,7 @@ class SimpleColorLogger():
     def info(self, msg, *args):
         if args:
             msg = msg % args
-        if self._loglevel >= 3:
+        if self._loglevel <= INFO:
             if self._color:
                 self.log(f"{self._BOLD_MAGENTA}{msg}{self._RESET}")
             else:
@@ -94,7 +115,7 @@ class SimpleColorLogger():
     def debug(self, msg, *args):
         if args:
             msg = msg % args
-        if self._loglevel >= 4:
+        if self._loglevel <= DEBUG:
             if self._color:
                 self.log(f"{self._BOLD_BLUE}{msg}{self._RESET}")
             else: