micropython-stubber 1.20.0__tar.gz → 1.20.1__tar.gz

{micropython_stubber-1.20.0 → micropython_stubber-1.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: micropython-stubber
-Version: 1.20.0
+Version: 1.20.1
 Summary: Tooling to create and maintain stubs for MicroPython
 Home-page: https://github.com/Josverl/micropython-stubber#readme
 License: MIT
@@ -18,16 +18,16 @@ Classifier: Programming Language :: Python :: Implementation :: MicroPython
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
 Requires-Dist: autoflake (>=1.7,<3.0)
-Requires-Dist: black (>=22.10,<23.0)
+Requires-Dist: black (>=22.10,<25.0)
 Requires-Dist: cachetools (>=5.3.0,<6.0.0)
 Requires-Dist: click (>=8.1.3,<9.0.0)
 Requires-Dist: executing (>=2.0.1,<3.0.0)
 Requires-Dist: importlib-metadata (>=1.0,<2.0) ; python_version < "3.8"
 Requires-Dist: libcst (>=1.1.0,<2.0.0)
 Requires-Dist: loguru (>=0.6,<0.8)
-Requires-Dist: mpflash (>=0.6.0)
+Requires-Dist: mpflash (>=0.7.4,<0.8.0)
 Requires-Dist: mpremote (>=1.22.0,<2.0.0)
-Requires-Dist: mypy (==1.7.0)
+Requires-Dist: mypy (==1.9.0)
 Requires-Dist: mypy-gitlab-code-quality (>=1.1.0,<2.0.0)
 Requires-Dist: packaging (>=21.3,<24.0)
 Requires-Dist: pipx (>=1.1.0,<2.0.0)

{micropython_stubber-1.20.0 → micropython_stubber-1.20.1}/pyproject.toml

@@ -8,7 +8,7 @@ repo-path = "./repos"
 
 [tool.poetry]
 name = "micropython-stubber"
-version = "1.20.0"
+version = "1.20.1"
 description = "Tooling to create and maintain stubs for MicroPython"
 authors = ["Jos Verlinde <jos_verlinde@hotmail.com>"]
 license = "MIT"
@@ -46,18 +46,20 @@ stubber = "stubber.stubber:stubber_cli"
 
 [tool.poetry.dependencies]
 python = ">=3.9,<4.0"
-mpflash = ">=0.6.0"
+python-minifier = { version = "^2.7.0", python = "<3.12" } # no support for 3.12 yet
+requests = "^2.28.0"
+mypy = "1.9.0"
+mpflash = "^0.7.4"
 mpremote = "^1.22.0"
 # others
 autoflake = ">=1.7,<3.0"
-black = ">=22.10,<23.0"
+black = ">=22.10,<25.0"
+libcst = "^1.1.0"
 cachetools = "^5.3.0"
 click = "^8.1.3"
 executing = "^2.0.1"
 importlib-metadata = { version = "^1.0", python = "<3.8" }
-libcst = "^1.1.0"
 loguru = ">=0.6,<0.8"
-mypy = "1.7.0"
 mypy-gitlab-code-quality = "^1.1.0"
 packaging = ">=21.3,<24.0"
 pipx = "^1.1.0"
@@ -66,8 +68,6 @@ pyright = "^1.1.341"
 pyserial = "^3.5"
 pysondb-v2 = "^2.1.0"
 pypi-simple = "^1.0.0"
-python-minifier = { version = "^2.7.0", python = "<3.12" } # no support for 3.12 yet
-requests = "^2.28.0"
 rich-click = "^1.7.3"
 tabulate = "^0.9.0"
 tenacity = "^8.2.2"

{micropython_stubber-1.20.0 → micropython_stubber-1.20.1}/src/mpflash/README.md

@@ -1,15 +1,16 @@
-# mpflash
-mpflash is a command-line tool for working with MicroPython firmware. It provides various features to help you develop, build, and manage your MicroPython projects.
+# MPFLASH
 
-This tool was created to be used in a CI/CD pipeline to automate the process of downloading and flashing MicroPython firmware to multiple boards, but it can also be used for manual flashing and development.
+`mpflash` is a command-line tool for working with MicroPython firmware. It provides features to help you flash and update Micropython on one or more .
 
-mpflash has been tested on Windows x64, Linux X64 and ARM64, but not (yet) macOS.
+This tool was initially created to be used in a CI/CD pipeline to automate the process of downloading and flashing MicroPython firmware to multiple boards, but it has been extend with a TUI to me be used for manual downloadig, flashing and development.
+
+`mpflash` has been tested on Windows x64, Linux X64, but not (yet) macOS.
+Tested ports: `rp2`, `samd`, `esp32`, `esp32s3`, `esp32c3`, `esp8266` and `stm32`
 
 ## Features
  1. List the connected boards including their firmware details, in a tabular or json format
- 2. Download MicroPython firmware for specific boards and versions.
- 3. Flash one or all connected MicroPython boards with a specific firmware or version.
-    Tested ports: rp2, samd, esp32, esp32s3, esp8266 and stm32
+ 2. Download MicroPython firmware for versions, and matching a specified board or matches your current attached board.
+ 3. Flash one or all connected MicroPython boards with a specific firmware or version.  
  
 ## Installation
 To install mpflash, you can use pip: `pip install mpflash`
@@ -30,40 +31,40 @@ On Windows this will not be an issue, but on Linux you can use  udev rules to gi
 [See the stm32_permissions documentation](./stm32_udev_rules.md) for more information.
 
 
-## Advanced use
+## Detailed usage
 You can list the connected boards using the following command:
 ```bash
 $ mpflash list
 D:\MyPython\micropython-stubber> mpflash list
-Getting board info ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 0:00:02
-                                       Connected boards
-┏━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━┓
-┃ Serial ┃ Family      ┃ Port    ┃ Board              ┃ CPU         ┃ Version        ┃ build ┃
-┡━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━┩
-│ COM11  │ micropython │ rp2     │ RPI_PICO_W         │ RP2040      │ 1.20.0         │       │
-│ COM12  │ micropython │ esp8266 │ ESP8266_GENERIC    │ ESP8266     │ 1.22.2         │       │
-│ COM18  │ micropython │ rp2     │ RPI_PICO_W         │ RP2040      │ 1.23.0-preview │ 155   │
-│ COM3   │ micropython │ samd    │ SEEED_WIO_TERMINAL │ SAMD51P19A  │ 1.23.0-preview │ 155   │
-│ COM5   │ micropython │ stm32   │ PYBV11             │ STM32F405RG │ 1.23.0-preview │ 166   │
-│ COM8   │ micropython │ esp32   │ ESP32_GENERIC_S3   │ ESP32S3     │ 1.23.0-preview │ 155   │
-└────────┴─────────────┴─────────┴────────────────────┴─────────────┴────────────────┴───────┘
+                                               Connected boards
+┏━━━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━━━┳━━━━━━┓
+┃ Serial  ┃Family       ┃Port  ┃Board                                      ┃CPU     ┃Version          ┃build ┃
+┡━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━┩
+│ COM21   │micropython  │rp2   │RPI_PICO                                   │RP2040  │v1.23.0-preview  │  236 │
+│         │             │      │Raspberry Pi Pico with RP2040              │        │                 │      │
+│ COM23   │micropython  │rp2   │RPI_PICO_W                                 │RP2040  │v1.23.0-preview  │  176 │
+│         │             │      │Raspberry Pi Pico W with RP2040            │        │                 │      │
+│ COM9    │micropython  │rp2   │ARDUINO_NANO_RP2040_CONNECT                │RP2040  │v1.23.0-preview  │  341 │
+│         │             │      │Arduino Nano RP2040 Connect with RP2040    │        │                 │      │
+└─────────┴─────────────┴──────┴───────────────────────────────────────────┴────────┴─────────────────┴──────┘
 ```
+## Download the firmware
 
-Suppose you want to download the MicroPython firmware for some boards, you can use the following command: 
+To download the MicroPython firmware for some boards, use the following command: 
+ - `mpflash download` download the latest stable firmware for all connected boards
+ - `mpflash download --version preview` download the current preview for all connected boards
+ - `mpflash download --board ESP8266_GENERIC --board SEEED_WIO_TERMINAL` download these specific boards
+ - `mpflash download --version ? --board ?` prompt to select a specific version and board to download
 
-```bash
-# download the firmware
-$ mpflash download --board ESP8266_GENERIC --board SEEED_WIO_TERMINAL
-```	
-This will download the latest stable version of the MicroPython firmware for the boards and save it in the `firmware` directory.
+These will try to download the prebuilt MicroPython firmware for the boards from https://micropython.org/download/ and save it in your downloads folder in the  `firmware` directory.
 The stable version (default) is determined based on the most recent published release,
-other optionse are `--version preview` and `--version x.y.z` to download the latest preview or version x.y.z respectively.
+other versions are `--version preview` and `--version x.y.z` to download the latest preview or version x.y.z respectively.
 
-by default the firmware will be downloaded to  Downloads  in a `firmware` folder in your, but you can specify a different directory using the `--dir` option.
+By default the firmware will be downloaded to your OS's preferred `Downloads/firmware` folder, but you can speciy a different directory using the `--dir` option.
 
-```bash
 The directory structure will be something like this:
-```
+
+``` text
 Downloads/firmware
 |   firmware.jsonl
 +---esp8266
@@ -74,9 +75,16 @@ Downloads/firmware
 \---samd
         SEEED_WIO_TERMINAL-v1.22.2.uf2
 ```
-You can then flash the firmware to the board using the following command: `mpflash flash`
+
+## Flashing the firmware
+After you have downloaded a firmware you can  flash the firmware to a board using the following command: `mpflash flash`
 This will (try to) autodetect the connected boards, and determine the correct firmware to flash to each board.
 
+- `mpflash flash` will flash the latest stable firmware to all connected boards.
+- `mpflash flash --serial ? --board ?` will prompt to select a specific serial port and board to flash. (the firmware must be dowloaded earlier)
+
+
+### Flashing all connected boards with the latest stable firmware
 ```bash
 > mpflash flash
 22:15:55 | ℹ️  - Using latest stable version: v1.22.2
@@ -158,8 +166,8 @@ Note that if no matching firmware can be found for a board, it will be skipped.
 (For example, the PYBV11 and ESP32_GENERIC_S3 boards in the example above.)
 
 ## Issues and bug reports
-mpflash is currently co-located in the [micropython-stubber](https://github.com/Josverl/micropython-stubber) repository.
-Please report any issues or bugs in the [issue tracker](https://github.com/Josverl/micropython-stubber/issues) with '[mpflash]' in the subject.
+mpflash is currently co-located in the [micropython-stubber](https://github.com/Josverl/micropython-stubber) repository.  
+Please report any issues or bugs in the [issue tracker](https://github.com/Josverl/micropython-stubber/issues) using the MPflash feedback template.
 
 ## License
 mpflash is licensed under the MIT license. See the LICENSE file for more details.

{micropython_stubber-1.20.0 → micropython_stubber-1.20.1}/src/mpflash/libusb_flash.ipynb

@@ -1,203 +1,203 @@
-{
- "cells": [
-  {
-   "cell_type": "code",
-   "execution_count": 3,
-   "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "[<DEVICE ID 0a05:7211 on Bus 002 Address 054>,\n",
-       " <DEVICE ID 0a05:7211 on Bus 002 Address 032>,\n",
-       " <DEVICE ID 045e:0c1e on Bus 002 Address 002>,\n",
-       " <DEVICE ID 045e:07b2 on Bus 002 Address 028>,\n",
-       " <DEVICE ID 045e:0904 on Bus 002 Address 015>,\n",
-       " <DEVICE ID 043e:9a39 on Bus 002 Address 057>,\n",
-       " <DEVICE ID 045e:0901 on Bus 002 Address 006>,\n",
-       " <DEVICE ID 05e3:0610 on Bus 002 Address 010>,\n",
-       " <DEVICE ID 2109:0817 on Bus 001 Address 001>,\n",
-       " <DEVICE ID 045e:0902 on Bus 002 Address 008>,\n",
-       " <DEVICE ID 1000:2000 on Bus 002 Address 016>,\n",
-       " <DEVICE ID 1189:8890 on Bus 002 Address 027>,\n",
-       " <DEVICE ID 2109:0817 on Bus 001 Address 002>,\n",
-       " <DEVICE ID 2109:2812 on Bus 002 Address 025>,\n",
-       " <DEVICE ID 046d:085e on Bus 002 Address 017>,\n",
-       " <DEVICE ID 045e:07c6 on Bus 002 Address 056>,\n",
-       " <DEVICE ID 0bda:5401 on Bus 002 Address 009>,\n",
-       " <DEVICE ID 10c4:ea60 on Bus 002 Address 055>,\n",
-       " <DEVICE ID 2109:2817 on Bus 002 Address 004>,\n",
-       " <DEVICE ID 0bda:5411 on Bus 002 Address 005>,\n",
-       " <DEVICE ID 045e:0900 on Bus 002 Address 003>,\n",
-       " <DEVICE ID 04e8:61f5 on Bus 002 Address 023>,\n",
-       " <DEVICE ID 045e:0903 on Bus 002 Address 020>,\n",
-       " <DEVICE ID 2109:2812 on Bus 002 Address 026>,\n",
-       " <DEVICE ID 8086:a0ed on Bus 002 Address 000>,\n",
-       " <DEVICE ID 2109:2817 on Bus 002 Address 013>,\n",
-       " <DEVICE ID 8087:0029 on Bus 002 Address 001>,\n",
-       " <DEVICE ID 8086:9a13 on Bus 001 Address 000>]"
-      ]
-     },
-     "execution_count": 3,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
-   "source": [
-    "import usb.core\n",
-    "import usb.util\n",
-    "import usb.backend.libusb1 as libusb1\n",
-    "from usb.core import USBError, Device\n",
-    "\n",
-    "from pathlib import Path\n",
-    "import platform\n",
-    "\n",
-    "if platform.system() == \"Windows\":\n",
-    "    # on windows you need to use the libusb1 backend\n",
-    "    import libusb\n",
-    "\n",
-    "    arch = \"x64\" if platform.architecture()[0] == \"64bit\" else \"x86\"\n",
-    "    libusb1_dll = Path(libusb.__file__).parent / f\"_platform\\\\_windows\\\\{arch}\\\\libusb-1.0.dll\"\n",
-    "\n",
-    "    backend = libusb1.get_backend(find_library=lambda x: libusb1_dll.as_posix())\n",
-    "usb_devices = usb.core.find(backend=backend, find_all=True)\n",
-    "\n",
-    "list(usb_devices)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "for d in usb.core.find(backend=backend, find_all=True):\n",
-    "    print(f\"Device {d.idVendor:04x}:{d.idProduct:04x}\")\n",
-    "    print(f\"{d.iManufacturer=}\")\n",
-    "    print(f\"{d.iProduct=}\")\n",
-    "    print(f\"{d.bDeviceClass=}\")\n",
-    "    print(f\"{d.bDescriptorType=}\")\n",
-    "    print(f\"{d.bcdDevice=}\")\n",
-    "    print(f\"{d.bcdUSB=}\")\n",
-    "    # print(dir(d))\n",
-    "    # print(f\"  Manufacturer: {usb.util.get_string(dev, dev.iManufacturer)}\")\n",
-    "\n",
-    "    print()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "import serial.tools.list_ports\n",
-    "\n",
-    "ports = serial.tools.list_ports.comports()\n",
-    "\n",
-    "for port in ports:\n",
-    "    print(f\"Port: {port.device}\")\n",
-    "    print(f\"Description: {port.description}\")\n",
-    "    print(f\"Hardware ID: {port.hwid}\")\n",
-    "    print()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "from mpflash.vendor import pydfu as pydfu\n",
-    "\n",
-    "try:\n",
-    "    pydfu.list_dfu_devices()\n",
-    "except SystemExit:\n",
-    "    print(\"No DFU devices found\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "pydfu.init()"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "dfu_file = Path(\"C:\\\\Users\\\\josverl\\\\Downloads\\\\firmware\\\\stm32\\\\PYBV11-THREAD-v1.23.0-preview.203.dfu\")\n",
-    "\n",
-    "print(\"Read DFU file...\")\n",
-    "elements = pydfu.read_dfu_file(dfu_file)\n",
-    "if not elements:\n",
-    "    print(\"No data in dfu file\")"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": 1,
-   "metadata": {},
-   "outputs": [
-    {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "Writing memory...\n"
-     ]
-    },
-    {
-     "ename": "NameError",
-     "evalue": "name 'pydfu' is not defined",
-     "output_type": "error",
-     "traceback": [
-      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
-      "\u001b[1;31mNameError\u001b[0m                                 Traceback (most recent call last)",
-      "Cell \u001b[1;32mIn[1], line 2\u001b[0m\n\u001b[0;32m      1\u001b[0m \u001b[38;5;28mprint\u001b[39m(\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mWriting memory...\u001b[39m\u001b[38;5;124m\"\u001b[39m)\n\u001b[1;32m----> 2\u001b[0m \u001b[43mpydfu\u001b[49m\u001b[38;5;241m.\u001b[39mwrite_elements(elements, \u001b[38;5;28;01mFalse\u001b[39;00m, progress\u001b[38;5;241m=\u001b[39mpydfu\u001b[38;5;241m.\u001b[39mcli_progress)\n",
-      "\u001b[1;31mNameError\u001b[0m: name 'pydfu' is not defined"
-     ]
-    }
-   ],
-   "source": [
-    "print(\"Writing memory...\")\n",
-    "pydfu.write_elements(elements, False, progress=pydfu.cli_progress)"
-   ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "print(\"Exiting DFU...\")\n",
-    "pydfu.exit_dfu()"
-   ]
-  }
- ],
- "metadata": {
-  "kernelspec": {
-   "display_name": ".venv",
-   "language": "python",
-   "name": "python3"
-  },
-  "language_info": {
-   "codemirror_mode": {
-    "name": "ipython",
-    "version": 3
-   },
-   "file_extension": ".py",
-   "mimetype": "text/x-python",
-   "name": "python",
-   "nbconvert_exporter": "python",
-   "pygments_lexer": "ipython3",
-   "version": "3.11.7"
-  }
- },
- "nbformat": 4,
- "nbformat_minor": 2
-}
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 3,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[<DEVICE ID 0a05:7211 on Bus 002 Address 054>,\n",
+       " <DEVICE ID 0a05:7211 on Bus 002 Address 032>,\n",
+       " <DEVICE ID 045e:0c1e on Bus 002 Address 002>,\n",
+       " <DEVICE ID 045e:07b2 on Bus 002 Address 028>,\n",
+       " <DEVICE ID 045e:0904 on Bus 002 Address 015>,\n",
+       " <DEVICE ID 043e:9a39 on Bus 002 Address 057>,\n",
+       " <DEVICE ID 045e:0901 on Bus 002 Address 006>,\n",
+       " <DEVICE ID 05e3:0610 on Bus 002 Address 010>,\n",
+       " <DEVICE ID 2109:0817 on Bus 001 Address 001>,\n",
+       " <DEVICE ID 045e:0902 on Bus 002 Address 008>,\n",
+       " <DEVICE ID 1000:2000 on Bus 002 Address 016>,\n",
+       " <DEVICE ID 1189:8890 on Bus 002 Address 027>,\n",
+       " <DEVICE ID 2109:0817 on Bus 001 Address 002>,\n",
+       " <DEVICE ID 2109:2812 on Bus 002 Address 025>,\n",
+       " <DEVICE ID 046d:085e on Bus 002 Address 017>,\n",
+       " <DEVICE ID 045e:07c6 on Bus 002 Address 056>,\n",
+       " <DEVICE ID 0bda:5401 on Bus 002 Address 009>,\n",
+       " <DEVICE ID 10c4:ea60 on Bus 002 Address 055>,\n",
+       " <DEVICE ID 2109:2817 on Bus 002 Address 004>,\n",
+       " <DEVICE ID 0bda:5411 on Bus 002 Address 005>,\n",
+       " <DEVICE ID 045e:0900 on Bus 002 Address 003>,\n",
+       " <DEVICE ID 04e8:61f5 on Bus 002 Address 023>,\n",
+       " <DEVICE ID 045e:0903 on Bus 002 Address 020>,\n",
+       " <DEVICE ID 2109:2812 on Bus 002 Address 026>,\n",
+       " <DEVICE ID 8086:a0ed on Bus 002 Address 000>,\n",
+       " <DEVICE ID 2109:2817 on Bus 002 Address 013>,\n",
+       " <DEVICE ID 8087:0029 on Bus 002 Address 001>,\n",
+       " <DEVICE ID 8086:9a13 on Bus 001 Address 000>]"
+      ]
+     },
+     "execution_count": 3,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "import usb.core\n",
+    "import usb.util\n",
+    "import usb.backend.libusb1 as libusb1\n",
+    "from usb.core import USBError, Device\n",
+    "\n",
+    "from pathlib import Path\n",
+    "import platform\n",
+    "\n",
+    "if platform.system() == \"Windows\":\n",
+    "    # on windows you need to use the libusb1 backend\n",
+    "    import libusb\n",
+    "\n",
+    "    arch = \"x64\" if platform.architecture()[0] == \"64bit\" else \"x86\"\n",
+    "    libusb1_dll = Path(libusb.__file__).parent / f\"_platform\\\\_windows\\\\{arch}\\\\libusb-1.0.dll\"\n",
+    "\n",
+    "    backend = libusb1.get_backend(find_library=lambda x: libusb1_dll.as_posix())\n",
+    "usb_devices = usb.core.find(backend=backend, find_all=True)\n",
+    "\n",
+    "list(usb_devices)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "for d in usb.core.find(backend=backend, find_all=True):\n",
+    "    print(f\"Device {d.idVendor:04x}:{d.idProduct:04x}\")\n",
+    "    print(f\"{d.iManufacturer=}\")\n",
+    "    print(f\"{d.iProduct=}\")\n",
+    "    print(f\"{d.bDeviceClass=}\")\n",
+    "    print(f\"{d.bDescriptorType=}\")\n",
+    "    print(f\"{d.bcdDevice=}\")\n",
+    "    print(f\"{d.bcdUSB=}\")\n",
+    "    # print(dir(d))\n",
+    "    # print(f\"  Manufacturer: {usb.util.get_string(dev, dev.iManufacturer)}\")\n",
+    "\n",
+    "    print()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import serial.tools.list_ports\n",
+    "\n",
+    "ports = serial.tools.list_ports.comports()\n",
+    "\n",
+    "for port in ports:\n",
+    "    print(f\"Port: {port.device}\")\n",
+    "    print(f\"Description: {port.description}\")\n",
+    "    print(f\"Hardware ID: {port.hwid}\")\n",
+    "    print()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "from mpflash.vendor import pydfu as pydfu\n",
+    "\n",
+    "try:\n",
+    "    pydfu.list_dfu_devices()\n",
+    "except SystemExit:\n",
+    "    print(\"No DFU devices found\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "pydfu.init()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "dfu_file = Path(\"C:\\\\Users\\\\josverl\\\\Downloads\\\\firmware\\\\stm32\\\\PYBV11-THREAD-v1.23.0-preview.203.dfu\")\n",
+    "\n",
+    "print(\"Read DFU file...\")\n",
+    "elements = pydfu.read_dfu_file(dfu_file)\n",
+    "if not elements:\n",
+    "    print(\"No data in dfu file\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 1,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Writing memory...\n"
+     ]
+    },
+    {
+     "ename": "NameError",
+     "evalue": "name 'pydfu' is not defined",
+     "output_type": "error",
+     "traceback": [
+      "\u001b[1;31m---------------------------------------------------------------------------\u001b[0m",
+      "\u001b[1;31mNameError\u001b[0m                                 Traceback (most recent call last)",
+      "Cell \u001b[1;32mIn[1], line 2\u001b[0m\n\u001b[0;32m      1\u001b[0m \u001b[38;5;28mprint\u001b[39m(\u001b[38;5;124m\"\u001b[39m\u001b[38;5;124mWriting memory...\u001b[39m\u001b[38;5;124m\"\u001b[39m)\n\u001b[1;32m----> 2\u001b[0m \u001b[43mpydfu\u001b[49m\u001b[38;5;241m.\u001b[39mwrite_elements(elements, \u001b[38;5;28;01mFalse\u001b[39;00m, progress\u001b[38;5;241m=\u001b[39mpydfu\u001b[38;5;241m.\u001b[39mcli_progress)\n",
+      "\u001b[1;31mNameError\u001b[0m: name 'pydfu' is not defined"
+     ]
+    }
+   ],
+   "source": [
+    "print(\"Writing memory...\")\n",
+    "pydfu.write_elements(elements, False, progress=pydfu.cli_progress)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(\"Exiting DFU...\")\n",
+    "pydfu.exit_dfu()"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": ".venv",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.7"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

{micropython_stubber-1.20.0 → micropython_stubber-1.20.1}/src/mpflash/mpflash/ask_input.py

@@ -12,7 +12,7 @@ from typing import Dict, List, Sequence, Tuple, Union
 from loguru import logger as log
 
 from mpflash.config import config
-from mpflash.mpboard_id import known_stored_boards, local_mp_ports
+from mpflash.mpboard_id import get_stored_boards_for_port, known_stored_boards, local_mp_ports
 from mpflash.mpremoteboard import MPRemoteBoard
 from mpflash.vendor.versions import micropython_versions
 
@@ -131,7 +131,7 @@ def filter_matching_boards(answers: dict) -> Sequence[Tuple[str, str]]:
         # Get the values of the dictionary, which are the unique items from the original list
         some_boards = list(unique_dict.values())
     else:
-        some_boards = [("No boards found", "")]
+        some_boards = [(f"No {answers['port']} boards found for version(s) {_versions}", "")]
     return some_boards
 
 
@@ -186,12 +186,27 @@ def ask_versions(questions: list, *, action: str):
     """
     # import only when needed to reduce load time
     import inquirer
+    import inquirer.errors
 
     input_ux = inquirer.Checkbox if action == "download" else inquirer.List
     mp_versions: List[str] = micropython_versions()
     mp_versions = [v for v in mp_versions if "preview" not in v]
+
+    # remove the versions for which there are no known boards in the board_info.json
+    # todo: this may be a little slow
+    mp_versions = [v for v in mp_versions if get_stored_boards_for_port("stm32", [v])]
+
     mp_versions.append("preview")
     mp_versions.reverse()  # newest first
+
+    def at_least_one_validation(answers, current) -> bool:
+        if not current:
+            raise inquirer.errors.ValidationError("", reason="Please select at least one version")
+        if isinstance(current, list):
+            if not any(current):
+                raise inquirer.errors.ValidationError("", reason="Please select at least one version")
+        return True
+
     questions.append(
         input_ux(
             # inquirer.List(
@@ -201,7 +216,7 @@ def ask_versions(questions: list, *, action: str):
             # hints=["Use space to select multiple options"],
             choices=mp_versions,
             autocomplete=True,
-            validate=lambda _, x: True if x else "Please select at least one version",  # type: ignore
+            validate=at_least_one_validation,
         )
     )