mpytool
MPY tool - manage files on devices running MicroPython
It is an alternative to 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
upload file or whole directory:
$ mpytool -p /dev/ttyACM0 put boot.py
$ mpytool -vp /dev/ttyACM0 put app/lib
$ mpytool -vp /dev/ttyACM0 --exclude-dir build --exclude-dir dist put app/src light_control
view content of file or download:
$ mpytool -p /dev/ttyACM0 get boot.py
$ mpytool -p /dev/ttyACM0 get net.py >> net.py
make directory, erase dir or files:
$ mpytool -p /dev/ttyACM0 mkdir a/b/c/d xyz/abc
$ mpytool -p /dev/ttyACM0 delete a xyz
restart only, restart and follow output:
$ mpytool -p /dev/ttyACM0 restart
$ mpytool -p /dev/ttyACM0 restart follow
Examples using API from Python
>> mpy.delete('a/b')">
>>> 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')
Verbose and debug output
use -v or -vv to show verbose output (like currently processing file, ..)
- normally print only errors (red)
-dprint warnings (yellow)-ddprint info messages (purple)-dddprint debug messages (blue)
for reporting bugs, please provide in to issue also -ddd messages
MPYTOOL vs AMPY
for test used: ESP32S2 over USB 2MB RAM and 2MB FLASH: recursive put of 30 files in 4 folders, 70KB total:
- mpytool: 12.3s
- ampy: 79.3s
Requirements
Working only with MicroPython boards, not with CircuitPython
- python v3.6+
- pyserial v3.0+
Running on:
- Linux
- MacOS
- Windows
Credits
(c) 2022 by Pavel Revak
Support
- Basic support is free over GitHub issues.
- Professional support is available over email: Pavel Revak.
1 Jan 8, 2022
105 Jan 7, 2023
0 Nov 26, 2022
3 Apr 8, 2022
1 Jan 29, 2022
2 Feb 10, 2022
1 Dec 18, 2021
2 Jun 2, 2022
1 Dec 30, 2021
3 Nov 4, 2022
17 Nov 29, 2022
78 Sep 20, 2022
25 Dec 19, 2022
8 Oct 6, 2022
2 Dec 7, 2021
1 Nov 24, 2021
2 Dec 29, 2022
11 Nov 16, 2022
3 Aug 2, 2022