Merge Carglglz/develop for upydev 0.3.8 release

Merge develop branch for upydev 0.3.8 release
Carglglz · Mar 4, 2022 · 9cf6c74 · 9cf6c74
2 parents a5b228d + bf1ea11
commit 9cf6c74
Show file tree

Hide file tree

Showing 178 changed files with 21,234 additions and 7,869 deletions.
diff --git a/.gitignore b/.gitignore
@@ -17,6 +17,10 @@
 .DS_Store
 
 SSL_CUSTOM_AUTH.py
+cryp_web_repl_dir/*
+dbg_wrepl_cmd_dir/*
+_DOCS/*
+__pycache__/*
 
 TODO.*
 .nosync
diff --git a/MANIFEST.in b/MANIFEST.in
@@ -5,7 +5,9 @@ include upydev/upyutils_dir/sync_tool.py
 include upydev/upyutils_dir/upylog.py
 include upydev/upyutils_dir/upynotify.py
 include upydev/upyutils_dir/upysecrets.py
-include upydev/upyutils_dir/ssl_repl.py
+include upydev/upyutils_dir/upysh.py
+include upydev/upyutils_dir/nanoglob.py
+include upydev/upyutils_dir/shasum.py
 include upydev/upyutils_dir/upysh2.py
 include upydev/upyutils_dir/uping.py
 include upydev/upyutils_dir/time_it.py

diff --git a/README.md b/README.md
@@ -6,19 +6,18 @@
 
 [![PyPI version](https://badge.fury.io/py/upydev.svg)](https://badge.fury.io/py/upydev)[![PyPI license](https://img.shields.io/pypi/l/ansicolortags.svg)](https://pypi.python.org/pypi/ansicolortags/)
 
-### Command line tool for wireless MicroPython devices
+### Command line tool for MicroPython devices
 
 **uPydev** is an acronym of '**MicroPy**thon **dev**ice', and it is intended to be a command line tool to make easier the development, prototyping and testing process of devices based on boards running MicroPython. It is intended to be cross-platform and
 connection agnostic (Serial, WiFi and Bluetooth Low Energy).
 
-⚠️ ***Keep in mind that this project is in ALPHA state, sometimes, some commands may not work/return anything*** ⚠️
-
 ### Features:
 
 * Tools to allow configuration, management, communication and control of MicroPython devices.
 * Command line Autocompletion
 * File IO operations (upload, download one or multiple files, recursively sync directories...)
 * SHELL-REPL modes: Serial, WiFi (SSL/WebREPL), BLE
+* OTA\* Firmware updates WiFi (TCP/SSL), BLE  (\* esp32 only)
 * Custom commands for debugging, testing and prototyping.
 * Group mode to operate with multiple devices
 ------
@@ -67,18 +66,18 @@ upydev will use local working directory configuration unless it does not find an
 ```
 
 
-  To check configuration
+  To check configuration ``upydev`` or ``upydev check``
 
 ```bash
-$ upydev check
+$ upydev
 Device: mycustomdevice
 Address: 192.168.1.40, Device Type: WebSocketDevice
 ```
 
   Or to get more information if the device is online
 
 ```bash
-$ upydev check -i
+$ upydev -i
 Device: mycustomdevice
 WebSocketDevice @ ws://192.168.1.40:8266, Type: esp32, Class: WebSocketDevice
 Firmware: MicroPython v1.13-221-gc8b055717 on 2020-12-05; ESP32 module with ESP32
@@ -101,6 +100,37 @@ $ upydev config -t 192.168.1.40 -p mypass -g
 $ upydev config -t 192.168.1.40 -p mypass -gg -@ mydevice
 ```
 
+- [Optional]
+Finally use `register` command to
+define a function in ``~/.bashrc`` or ``~/.profile``
+
+```bash
+$ upydev register -@ mydevice
+````
+
+```bash
+function mydevice() { upydev "$@" -@ mydevice; }
+function _argcomp_upydev() { _python_argcomplete upydev; }
+complete -o bashdefault -o default -o nospace -F _argcomp_upydev mydevice
+```
+
+Now ``mydevice`` will accept any args and pass them to upydev, as well as
+autocompletion of args, e.g.
+
+```bash
+$ mydevice
+Device: mydevice
+Address: 192.168.1.40, Device Type: WebSocketDevice
+```
+Or if the device is connected.
+
+```bash
+$ mydevice -i
+Device: mydevice
+WebSocketDevice @ ws://192.168.1.40:8266, Type: esp32, Class: WebSocketDevice
+Firmware: MicroPython v1.17-290-g802ef271b-dirty on 2022-01-04; ESP32 module with ESP32
+(MAC: 80:7d:3a:80:9b:30, RSSI: -48 dBm)
+```
 
 Once the device is configured see next section or read  [Usage documentation](https://upydev.readthedocs.io/en/latest/usage.html) to check which modes and tools are available.
 
@@ -138,4 +168,4 @@ Example: Raw commands
 `$ upydev "import my_lib;foo();my_var=2*3"`
 
 
-Too see documentation check [Upydev readthedocs](https://upydev.readthedocs.io/en/latest/)
+To see documentation check [Upydev readthedocs](https://upydev.readthedocs.io/en/latest/)
diff --git a/_DOCS/ABOUT.md → _legacy/_DOCS/ABOUT.md b/_DOCS/ABOUT.md → _legacy/_DOCS/ABOUT.md
diff --git a/_DOCS/CryptoWebREPL_demo.gif → _legacy/_DOCS/CryptoWebREPL_demo.gif b/_DOCS/CryptoWebREPL_demo.gif → _legacy/_DOCS/CryptoWebREPL_demo.gif
diff --git a/_DOCS/Documentation.md → _legacy/_DOCS/Documentation.md b/_DOCS/Documentation.md → _legacy/_DOCS/Documentation.md
@@ -2269,7 +2269,7 @@ SAMPLES PER PACKET : 1
 VARIABLES PER SAMPLE : 3; ['X', 'Y', 'Z']
 SIZE OF PACKETS: 12 bytes
 Period: 2 ms ; Fs:440.0 Hz, Data send rate: 437 packets/s of 1 samples
-DATA TRANSFER RATE: 5.12109375 KB/s
+DATA TRANSFER RATE: 5.12109375 kB/s
 ```
 
 

diff --git a/_DOCS/HOWTO.md → _legacy/_DOCS/HOWTO.md b/_DOCS/HOWTO.md → _legacy/_DOCS/HOWTO.md
diff --git a/_DOCS/SERIAL_SHELL_REPL_docs.md → _legacy/_DOCS/SERIAL_SHELL_REPL_docs.md b/_DOCS/SERIAL_SHELL_REPL_docs.md → _legacy/_DOCS/SERIAL_SHELL_REPL_docs.md
diff --git a/_DOCS/SSLWebREPL_demo.gif → _legacy/_DOCS/SSLWebREPL_demo.gif b/_DOCS/SSLWebREPL_demo.gif → _legacy/_DOCS/SSLWebREPL_demo.gif
diff --git a/_DOCS/SSLWebREPL_docs.md → _legacy/_DOCS/SSLWebREPL_docs.md b/_DOCS/SSLWebREPL_docs.md → _legacy/_DOCS/SSLWebREPL_docs.md
diff --git a/_DOCS/WHATSNEW.md → _legacy/_DOCS/WHATSNEW.md b/_DOCS/WHATSNEW.md → _legacy/_DOCS/WHATSNEW.md
diff --git a/_DOCS/cmd_gifs/ads_read.gif → _legacy/_DOCS/cmd_gifs/ads_read.gif b/_DOCS/cmd_gifs/ads_read.gif → _legacy/_DOCS/cmd_gifs/ads_read.gif
diff --git a/_DOCS/cmd_gifs/imuacc_cmd.gif → _legacy/_DOCS/cmd_gifs/imuacc_cmd.gif b/_DOCS/cmd_gifs/imuacc_cmd.gif → _legacy/_DOCS/cmd_gifs/imuacc_cmd.gif
diff --git a/_DOCS/crypto_wrepl_docs.md → _legacy/_DOCS/crypto_wrepl_docs.md b/_DOCS/crypto_wrepl_docs.md → _legacy/_DOCS/crypto_wrepl_docs.md
@@ -238,7 +238,7 @@ Flash          2.0 MB     512.0 KB     1.5 MB      25.3 %        /
 esp32@esp_room1:~ $ ls
 lib                          boot.py                      main.py
 wifi_.config                 ap_.config                   webrepl_cfg.py
-upy_pub_rsa30aea4233564.key  test_sync_dir
+upy_pv_rsa30aea4233564.key  test_sync_dir
 esp32@esp_room1:~ $ meminfo
 Memory         Size        Used       Avail        Use%
 RAM          116.188 KB  36.531 KB   79.656 KB     31.4 %

diff --git a/_DOCS/dac_sig_sin.png → _legacy/_DOCS/dac_sig_sin.png b/_DOCS/dac_sig_sin.png → _legacy/_DOCS/dac_sig_sin.png
diff --git a/_DOCS/dac_sig_sin_mod.png → _legacy/_DOCS/dac_sig_sin_mod.png b/_DOCS/dac_sig_sin_mod.png → _legacy/_DOCS/dac_sig_sin_mod.png
diff --git a/_DOCS/dac_write.png → _legacy/_DOCS/dac_write.png b/_DOCS/dac_write.png → _legacy/_DOCS/dac_write.png
diff --git a/_DOCS/ssl_git.gif → _legacy/_DOCS/ssl_git.gif b/_DOCS/ssl_git.gif → _legacy/_DOCS/ssl_git.gif
diff --git a/_DOCS/upylog.md → _legacy/_DOCS/upylog.md b/_DOCS/upylog.md → _legacy/_DOCS/upylog.md
diff --git a/_DOCS/upynotify.md → _legacy/_DOCS/upynotify.md b/_DOCS/upynotify.md → _legacy/_DOCS/upynotify.md
diff --git a/_DOCS/upyutils_docs.md → _legacy/_DOCS/upyutils_docs.md b/_DOCS/upyutils_docs.md → _legacy/_DOCS/upyutils_docs.md