mpytool 2.3.3__tar.gz → 2.3.5__tar.gz

mpytool-2.3.5/.github/workflows/integration.yml

@@ -0,0 +1,53 @@
+name: Integration Tests
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+
+jobs:
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - run: pip install -e .
+      - run: python -m unittest discover tests/ -v
+
+  linux-integration:
+    runs-on: [self-hosted, Linux]
+    needs: unit-tests
+    strategy:
+      fail-fast: false
+      matrix:
+        device: [ESP32]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install package
+        run: $HOME/actions-runner/.venv/bin/pip install -e .
+      - name: Integration tests (${{ matrix.device }})
+        run: |
+          export PATH="$HOME/actions-runner/.venv/bin:$PATH"
+          export MPYTOOL_TEST_PORT_RW="$(cat ~/actions-runner/.config/mpytool/${{ matrix.device }})"
+          python -m unittest tests.test_integration tests.test_cli -v
+
+  win-integration:
+    runs-on: [self-hosted, Windows]
+    needs: unit-tests
+    strategy:
+      fail-fast: false
+      matrix:
+        device: [ESP32S3]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install package
+        run: C:\actions-runner\.venv\Scripts\pip install -e .
+        shell: cmd
+      - name: Integration tests (${{ matrix.device }})
+        run: |
+          set PATH=C:\actions-runner\.venv\Scripts;%PATH%
+          set /p MPYTOOL_TEST_PORT_RW=<C:\actions-runner\.config\mpytool\${{ matrix.device }}
+          python -m unittest tests.test_integration tests.test_cli -v
+        shell: cmd

mpytool-2.3.5/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Install package
+        run: pip install .
+
+      - name: Run unit tests
+        run: python -m unittest discover -v tests/
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

mpytool-2.3.5/.github/workflows/tests.yml

@@ -0,0 +1,29 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: pip install .
+
+      - name: Run unit tests
+        run: python -m unittest discover -v tests/

mpytool-2.3.5/.gitignore

@@ -0,0 +1,12 @@
+__pycache__
+build
+dist
+.*
+!.gitignore
+!.github
+!.mpyproject
+*.egg-info
+_version.py
+*.md
+!README*.md
+scripts/

{mpytool-2.3.3/mpytool.egg-info → mpytool-2.3.5}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: mpytool
-Version: 2.3.3
+Version: 2.3.5
 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 -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
@@ -650,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
 ```
@@ -671,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
 ```
@@ -757,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.3/PKG-INFO → mpytool-2.3.5/README.md

@@ -1,17 +1,3 @@
-Metadata-Version: 2.4
-Name: mpytool
-Version: 2.3.3
-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 -- 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
@@ -650,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
 ```
@@ -671,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
 ```
@@ -757,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).