mpytool 2.0.0__py3-none-any.whl → 2.1.0__py3-none-any.whl

mpytool-2.0.0.dist-info/METADATA

@@ -1,233 +0,0 @@
-Metadata-Version: 2.4
-Name: mpytool
-Version: 2.0.0
-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
-
-It is an alternative to [ampy](https://github.com/scientifichackers/ampy)
-
-Target of this project is to make more clean code, faster, better verbose output...
-
-## Installation
-
-```
-pip3 install mpytool
-```
-
-## Examples:
-
-help:
-```
-$ mpytool --help
-```
-
-list files:
-```
-$ mpytool -p /dev/ttyACM0 ls
-$ mpytool -p /dev/ttyACM0 ls lib
-```
-
-tree files:
-```
-$ mpytool -p /dev/ttyACM0 tree
-```
-
-copy files (: prefix = device path):
-```
-$ mpytool cp main.py :/             # upload file to device root
-$ mpytool cp main.py lib.py :/lib/  # upload multiple files to directory
-$ mpytool cp myapp/ :/              # upload directory (creates /myapp/)
-$ mpytool cp myapp/ :/lib/          # upload directory into /lib/
-$ mpytool cp :/main.py ./           # download file to current directory
-$ mpytool cp :/ ./backup/           # download entire device to backup/
-$ mpytool cp :/old.py :/new.py      # copy file on device
-$ mpytool cp -f main.py :/          # force upload even if unchanged
-```
-
-Unchanged files are automatically skipped (compares size and SHA256 hash).
-Use `-f` or `--force` to upload all files regardless.
-
-move/rename on device:
-```
-$ mpytool mv :/old.py :/new.py      # rename file
-$ mpytool mv :/file.py :/lib/       # move file to directory
-$ mpytool mv :/a.py :/b.py :/lib/   # move multiple files to directory
-```
-
-legacy upload/download (still available):
-```
-$ mpytool put boot.py /
-$ mpytool get boot.py >> boot.py
-```
-
-make directory, delete files:
-```
-$ mpytool mkdir a/b/c/d xyz/abc   # create directories
-$ mpytool rm mydir                # delete directory and contents
-$ mpytool rm mydir/               # delete contents only, keep directory
-$ mpytool rm /                    # delete everything on device
-```
-
-reset only, reset and follow output, REPL mode:
-```
-$ mpytool -p /dev/ttyACM0 reset
-$ mpytool -p /dev/ttyACM0 reset follow
-$ mpytool -p /dev/ttyACM0 repl
-```
-
-execute Python code on device:
-```
-$ mpytool exec "print('Hello!')"
-$ mpytool exec "import sys; print(sys.version)"
-```
-
-show device information:
-```
-$ mpytool info
-Platform:    rp2
-Version:     3.4.0; MicroPython v1.27.0 on 2025-12-09
-Impl:        micropython
-Machine:     Raspberry Pi Pico with RP2040
-Memory:      36.4 KB / 240 KB (15.15%)
-Flash:       120 KB / 1.38 MB (8.52%)
-```
-
-multiple commands separated by `--`:
-```
-$ mpytool -p /dev/ttyACM0 put main.py / -- reset -- follow
-$ mpytool -p /dev/ttyACM0 delete old.py -- put new.py / -- reset
-```
-
-auto-detect serial port (if only one device is connected):
-```
-$ mpytool ls
-Using /dev/ttyACM0
-       215 boot.py
-      2938 net.py
-```
-
-connect over network (TCP, default port 23):
-```
-$ mpytool -a 192.168.1.100 ls
-$ mpytool -a 192.168.1.100:8266 tree
-```
-
-set baudrate (default 115200):
-```
-$ mpytool -p /dev/ttyACM0 -b 9600 ls
-```
-
-show version:
-```
-$ mpytool -V
-```
-
-command aliases:
-- `dir` = `ls`
-- `cat` = `get`
-- `del`, `rm` = `delete`
-
-## Examples using API from Python
-
-```
->>> import mpytool
->>> conn = mpytool.ConnSerial(port='/dev/ttyACM0', baudrate=115200)
->>> mpy = mpytool.Mpy(conn)
->>> mpy.ls()
-[('ehome', None), ('boot.py', 215), ('net.py', 2938), ('project.json', 6404)]
->>> mpy.mkdir('a/b/c')
->>> mpy.ls()
-[('a', None),
- ('ehome', None),
- ('boot.py', 215),
- ('net.py', 2938),
- ('project.json', 6404)]
->>> mpy.get('boot.py')
-b"import time\nimport net\n\nwlan = net.Wlan()\nwlan.refresh_network()\n\nwhile wlan.ifconfig()[0] == '0.0.0.0':\n    time.sleep(.1)\n\nprint('IP: ' + wlan.ifconfig()[0])\n\nimport ehome.ehome\n\nehome.ehome.start('project.json')\n"
->>> mpy.delete('a/b')
-```
-
-## Progress and verbose output
-
-Progress is shown by default during file transfers:
-```
-$ mpytool cp main.py lib.py :/lib/
-[1/2] 100%   1.2KB main.py -> :/lib/main.py
-[2/2] 100%   3.4KB lib.py  -> :/lib/lib.py
-```
-
-use `-v` or `--verbose` to also show commands being executed:
-```
-$ mpytool -v rm /old.py
-delete: /old.py
-```
-
-use `-q` or `--quiet` to disable all output:
-```
-$ mpytool -q cp main.py :/
-```
-
-## Debug output
-
-- `-d` print warnings (yellow)
-- `-dd` print info messages (purple)
-- `-ddd` print debug messages (blue)
-
-for reporting bugs, please provide in to issue also -ddd messages
-
-## MPYTOOL vs other tools
-
-Benchmark on RP2040 (Raspberry Pi Pico) over native USB, January 2025:
-
-| Test | mpytool | mpremote |
-|------|---------|----------|
-| 50 small files, 5 dirs (200KB) | **4.2s** | 9.4s |
-| 5 large files (260KB) | **8.0s** | 17.3s |
-| re-upload unchanged files | **1.3s** | 5.0s |
-
-mpytool is **2x faster** for uploads and **4x faster** for re-uploads (skips unchanged files).
-
-mpytool advantages:
-- Fastest file transfers (2x faster than mpremote)
-- Skip unchanged files (compares size + SHA256 hash)
-- Progress indicator with file counts (`[3/10] 50% file.py -> :/lib/`)
-- Single tool for all operations (no need to chain commands)
-- Clean verbose output (`-v`) for debugging
-
-## Requirements
-
-Working only with MicroPython boards, not with CircuitPython
-
-- python v3.10+
-- pyserial v3.0+
-
-### Running on:
-
-- Linux
-- MacOS
-- Windows (limited support - REPL mode is disabled)
-
-## Credits
-
-(c) 2022 by Pavel Revak
-
-### License
-
-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).

mpytool-2.0.0.dist-info/RECORD

@@ -1,16 +0,0 @@
-mpytool/__init__.py,sha256=4BRbfLRLpReWcDDbUA1A2UO1B8sNa6O5lgXRObbnP20,266
-mpytool/conn.py,sha256=2CU6nJSRKwKf1TOGt-uLj4__lOXFTMXxFc0E7-3jrtA,3042
-mpytool/conn_serial.py,sha256=DdX9a-SS_VtmuvjSXQdLKqcNUwanrPP5tqaiTsBsbSo,994
-mpytool/conn_socket.py,sha256=EZh6KGMwPgNoNgl0wK4l47N9KVtaSLd3DeCTIiZ4bRw,1531
-mpytool/logger.py,sha256=e9xaDf52nsMXU4T4Kv_pogzGq5hzP-643RxOMEDZjC0,2727
-mpytool/mpy.py,sha256=i-QdxJdfUflj0VHGjy42OZD7-GejMj9ak76pR5QHfKE,9946
-mpytool/mpy_comm.py,sha256=4LR2dqErVi1VtyR6wcR0Kg0iw_2ZaSKeJiyE4-6MIY0,4529
-mpytool/mpytool.py,sha256=MrC02v9RPrAuNiWOR9vur-jeuevXhh-YhJwFqL4hdoQ,37113
-mpytool/terminal.py,sha256=TKHIKBKa_prJ0E5CTHkqchGjJUZqvJhd6aOu50WN_nk,2320
-mpytool/utils.py,sha256=VYXs_EuXKCnx8Ipt2ne6X6DY1XeW6XzSfos26kBdgUc,1933
-mpytool-2.0.0.dist-info/licenses/LICENSE,sha256=wfMg5yKH2O86Digcowcm2g8Wh4zAo_gX-VqQXjmpf74,1078
-mpytool-2.0.0.dist-info/METADATA,sha256=hrzauXVatXOzQ9OQrN2khUEfX5E41tYojgda19pjPNg,5763
-mpytool-2.0.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-mpytool-2.0.0.dist-info/entry_points.txt,sha256=wmnyPWEKLEbPJFR98Cc2Ky0krbMxA2BcVsS5KCTGP8Q,49
-mpytool-2.0.0.dist-info/top_level.txt,sha256=4ZornVQbsgLIpB6d_5V1tOzX5bJvHxxDOuk8qFRjP2c,8
-mpytool-2.0.0.dist-info/RECORD,,