mpflash 1.24.7__py3-none-any.whl → 1.24.8__py3-none-any.whl

mpflash/mpboard_id/known.py

@@ -0,0 +1,94 @@
+"""
+KNOWN ports and boards are sourced from the micropython repo,
+this info is stored in the board_info.json file
+and is used to identify the board and port for flashing.
+This module provides access to the board info and the known ports and boards."""
+
+from functools import lru_cache
+from typing import List, Optional, Tuple
+
+from mpflash.errors import MPFlashError
+from mpflash.versions import clean_version
+
+from .board import Board
+from .store import read_known_boardinfo
+
+
+def get_known_ports() -> List[str]:
+    # TODO: Filter for Version
+    mp_boards = read_known_boardinfo()
+    # select the unique ports from info
+    ports = set({board.port for board in mp_boards if board.port})
+    return sorted(list(ports))
+
+
+def get_known_boards_for_port(port: Optional[str] = "", versions: Optional[List[str]] = None) -> List[Board]:
+    """
+    Returns a list of boards for the given port and version(s)
+
+    port: The Micropython port to filter for
+    versions:  Optional, The Micropython versions to filter for (actual versions required)
+    """
+    mp_boards = read_known_boardinfo()
+    if versions:
+        preview_or_stable = "preview" in versions or "stable" in versions
+    else:
+        preview_or_stable = False
+
+    # filter for 'preview' as they are not in the board_info.json
+    # instead use stable version
+    versions = versions or []
+    if "preview" in versions:
+        versions.remove("preview")
+        versions.append("stable")
+    if versions:
+        # make sure of the v prefix
+        versions = [clean_version(v) for v in versions]
+        # filter for the version(s)
+        mp_boards = [board for board in mp_boards if board.version in versions]
+        if not mp_boards and preview_or_stable:
+            # nothing found - perhaps there is a newer version for which we do not have the board info yet
+            # use the latest known version from the board info
+            mp_boards = read_known_boardinfo()
+            last_known_version = sorted({b.version for b in mp_boards})[-1]
+            mp_boards = [board for board in mp_boards if board.version == last_known_version]
+
+    # filter for the port
+    if port:
+        mp_boards = [board for board in mp_boards if board.port == port]
+    return mp_boards
+
+
+def known_stored_boards(port: str, versions: Optional[List[str]] = None) -> List[Tuple[str, str]]:
+    """
+    Returns a list of tuples with the description and board name for the given port and version
+
+    port : str : The Micropython port to filter for
+    versions : List[str] : The Micropython versions to filter for (actual versions required)
+    """
+    mp_boards = get_known_boards_for_port(port, versions)
+
+    boards = set({(f"{board.version} {board.description}", board.board_id) for board in mp_boards})
+    return sorted(list(boards))
+
+
+@lru_cache(maxsize=20)
+def find_known_board(board_id: str) -> Board:
+    """Find the board for the given BOARD_ID or 'board description' and return the board info as a Board object"""
+    # Some functional overlap with:
+    # mpboard_id\board_id.py _find_board_id_by_description
+    info = read_known_boardinfo()
+    for board_info in info:
+        if board_id in (
+            board_info.board_id,
+            board_info.description,
+        ) or board_info.description.startswith(board_id):
+            if not board_info.cpu:
+                # failsafe for older board_info.json files
+                print(f"Board {board_id} has no CPU info, using port as CPU")
+                if " with " in board_info.description:
+                    board_info.cpu = board_info.description.split(" with ")[-1]
+                else:
+                    board_info.cpu = board_info.port
+            return board_info
+    raise MPFlashError(f"Board {board_id} not found")

mpflash/mpboard_id/store.py

@@ -19,7 +19,6 @@ def write_boardinfo_json(board_list: List[Board], *, folder: Optional[Path] = No
         board_list (List[Board]): The list of Board objects.
         folder (Path): The folder where the compressed JSON file will be saved.
     """
-    import zipfile
 
     if not folder:
         folder = HERE
@@ -34,7 +33,6 @@ def write_boardinfo_json(board_list: List[Board], *, folder: Optional[Path] = No
 def read_known_boardinfo(board_info: Optional[Path] = None) -> List[Board]:
     """Reads the board information from a JSON file in a zip file."""
 
-    import zipfile
 
     if not board_info:
         board_info = HERE / "board_info.zip"

mpflash/mpremoteboard/__init__.py

@@ -2,6 +2,8 @@
 Module to run mpremote commands, and retry on failure or timeout
 """
 
+
+import contextlib
 import sys
 import time
 from pathlib import Path
@@ -51,6 +53,7 @@ class MPRemoteBoard:
         self.version = ""
         self.port = ""
         self.board = ""
+        self.variant= ""
         self.cpu = ""
         self.arch = ""
         self.mpy = ""
@@ -65,9 +68,9 @@ class MPRemoteBoard:
         Return a string representation of the MPRemoteBoard object.
 
         Returns:
-        - str: The string representation of the object.
+        - str: A human readable representation of the MCU.
         """
-        return f"MPRemoteBoard({self.serialport}, {self.family} {self.port}, {self.board}, {self.version})"
+        return f"MPRemoteBoard({self.serialport}, {self.family} {self.port}, {self.board}{f'-{self.variant}' if self.variant else ''}, {self.version})"
 
     @staticmethod
     def connected_boards(bluetooth: bool = False, description: bool = False) -> List[str]:
@@ -137,9 +140,12 @@ class MPRemoteBoard:
             self.description = descr = info["board"]
             pos = descr.rfind(" with")
             short_descr = descr[:pos].strip() if pos != -1 else ""
-            if board_name := find_board_id_by_description(
-                descr, short_descr, version=self.version
-            ):
+            if info["_build"]: 
+                self.board = info["_build"].split('-')[0]
+                self.variant = info["_build"].split('-')[1] if '-' in info["_build"] else ""
+            elif board_name := find_board_id_by_description(
+                    descr, short_descr, version=self.version
+                ):
                 self.board = board_name
             else:
                 self.board = "UNKNOWN_BOARD"
@@ -168,7 +174,7 @@ class MPRemoteBoard:
                 log_errors=False,
             )
         except Exception as e:
-            raise ConnectionError(f"Failed to get board_info.toml for {self.serialport}: {e}")
+            raise ConnectionError(f"Failed to get board_info.toml for {self.serialport}:") from e
         # this is optional - so only parse if we got the file
         self.toml = {}
         if rc in [OK]:  # sometimes we get an -9 ???
@@ -264,8 +270,6 @@ class MPRemoteBoard:
             total=timeout,
         ):
             time.sleep(1)
-            try:
+            with contextlib.suppress(ConnectionError, MPFlashError):
                 self.get_mcu_info()
                 break
-            except (ConnectionError, MPFlashError):
-                pass

mpflash/mpremoteboard/mpy_fw_info.py

@@ -1,4 +1,4 @@
-# %%micropython
+# pragma: no cover
 import os
 import sys
 
@@ -11,11 +11,11 @@ def _build(s):
         return ""
     s = s.split(" on ", 1)[0] if " on " in s else s
     if s.startswith("v"):
-        if not "-" in s:
+        if "-" not in s:
             return ""
         b = s.split("-")[1]
         return b
-    if not "-preview" in s:
+    if "-preview" not in s:
         return ""
     b = s.split("-preview")[1].split(".")[1]
     return b
@@ -36,10 +36,9 @@ def _info():  # type:() -> dict[str, str]
             "version": "",
             "build": "",
             "ver": "",
-            "port": (
-                "stm32" if sys.platform.startswith("pyb") else sys.platform
-            ),  # port: esp32 / win32 / linux / stm32
+            "port": ("stm32" if sys.platform.startswith("pyb") else sys.platform),  # port: esp32 / win32 / linux / stm32
             "board": "GENERIC",
+            "_build": "",
             "cpu": "",
             "mpy": "",
             "arch": "",
@@ -50,17 +49,16 @@ def _info():  # type:() -> dict[str, str]
     except AttributeError:
         pass
     try:
-        machine = (
-            sys.implementation._machine
-            if "_machine" in dir(sys.implementation)
-            else os.uname().machine
-        )
+        machine = sys.implementation._machine if "_machine" in dir(sys.implementation) else os.uname().machine  # type: ignore
         info["board"] = machine.strip()
+        info["_build"] = sys.implementation._build if "_build" in dir(sys.implementation) else ""
         info["cpu"] = machine.split("with")[-1].strip() if "with" in machine else ""
         info["mpy"] = (
             sys.implementation._mpy
             if "_mpy" in dir(sys.implementation)
-            else sys.implementation.mpy if "mpy" in dir(sys.implementation) else ""
+            else sys.implementation.mpy
+            if "mpy" in dir(sys.implementation)
+            else ""
         )
     except (AttributeError, IndexError):
         pass
@@ -69,10 +67,10 @@ def _info():  # type:() -> dict[str, str]
         if hasattr(sys, "version"):
             info["build"] = _build(sys.version)
         elif hasattr(os, "uname"):
-            info["build"] = _build(os.uname()[3])
+            info["build"] = _build(os.uname()[3])  # type: ignore
             if not info["build"]:
                 # extract build from uname().release if available
-                info["build"] = _build(os.uname()[2])
+                info["build"] = _build(os.uname()[2])  # type: ignore
     except (AttributeError, IndexError):
         pass
     # avoid  build hashes
@@ -81,7 +79,7 @@ def _info():  # type:() -> dict[str, str]
 
     if info["version"] == "" and sys.platform not in ("unix", "win32"):
         try:
-            u = os.uname()
+            u = os.uname()  # type: ignore
             info["version"] = u.release
         except (IndexError, AttributeError, TypeError):
             pass
@@ -106,8 +104,7 @@ def _info():  # type:() -> dict[str, str]
         if (
             info["version"]
             and info["version"].endswith(".0")
-            and info["version"]
-            >= "1.10.0"  # versions from 1.10.0 to 1.20.0 do not have a micro .0
+            and info["version"] >= "1.10.0"  # versions from 1.10.0 to 1.20.0 do not have a micro .0
             and info["version"] <= "1.19.9"
         ):
             # drop the .0 for newer releases

mpflash/vendor/click_aliases.py

@@ -10,6 +10,7 @@
 # The above copyright notice and this permission notice shall be included in all
 # copies or substantial portions of the Software.
 # ------------------------------------------------------------------------------------
+# Jos Verlinde - 2024
 # modified to avoid conflcts with rich_click
 
 # sourcery skip: assign-if-exp, use-named-expression
@@ -20,12 +21,36 @@ _click7 = click.__version__[0] >= "7"
 
 
 class ClickAliasedGroup(click.RichGroup):
+    """
+    A subclass of click.RichGroup that adds support for command aliases.
+
+    This class allows defining aliases for commands and groups, enabling users
+    to invoke commands using alternative names.
+    """
+
     def __init__(self, *args, **kwargs):
+        """
+        Initialize the ClickAliasedGroup instance.
+
+        Args:
+            *args: Positional arguments passed to the superclass.
+            **kwargs: Keyword arguments passed to the superclass.
+        """
         super().__init__(*args, **kwargs)
         self._commands = {}
         self._aliases = {}
 
     def add_command(self, *args, **kwargs):
+        """
+        Add a command to the group, optionally with aliases.
+
+        Args:
+            *args: Positional arguments, typically the command instance and optionally its name.
+            **kwargs: Keyword arguments, may include 'aliases' as a list of alternative names.
+
+        Raises:
+            TypeError: If the command has no name.
+        """
         aliases = kwargs.pop("aliases", [])
         super().add_command(*args, **kwargs)
         if aliases:
@@ -40,6 +65,16 @@ class ClickAliasedGroup(click.RichGroup):
                 self._aliases[alias] = cmd.name
 
     def command(self, *args, **kwargs):
+        """
+        Decorator to define a new command with optional aliases.
+
+        Args:
+            *args: Positional arguments passed to the superclass decorator.
+            **kwargs: Keyword arguments, may include 'aliases' as a list of alternative names.
+
+        Returns:
+            Callable: A decorator function that registers the command and its aliases.
+        """
         aliases = kwargs.pop("aliases", [])
         decorator = super().command(*args, **kwargs)
         if not aliases:
@@ -56,6 +91,16 @@ class ClickAliasedGroup(click.RichGroup):
         return _decorator
 
     def group(self, *args, **kwargs):
+        """
+        Decorator to define a new command group with optional aliases.
+
+        Args:
+            *args: Positional arguments passed to the superclass decorator.
+            **kwargs: Keyword arguments, may include 'aliases' as a list of alternative names.
+
+        Returns:
+            Callable: A decorator function that registers the group and its aliases.
+        """
         aliases = kwargs.pop("aliases", [])
         decorator = super().group(*args, **kwargs)
         if not aliases:
@@ -72,11 +117,30 @@ class ClickAliasedGroup(click.RichGroup):
         return _decorator
 
     def resolve_alias(self, cmd_name):
+        """
+        Resolve a command alias to its original command name.
+
+        Args:
+            cmd_name (str): The command name or alias to resolve.
+
+        Returns:
+            str: The original command name if an alias is provided; otherwise, the input name.
+        """
         if cmd_name in self._aliases:
             return self._aliases[cmd_name]
         return cmd_name
 
     def get_command(self, ctx, cmd_name):
+        """
+        Retrieve a command by name or alias.
+
+        Args:
+            ctx (click.Context): The Click context object.
+            cmd_name (str): The command name or alias to retrieve.
+
+        Returns:
+            click.Command or None: The command object if found; otherwise, None.
+        """
         cmd_name = self.resolve_alias(cmd_name)
         command = super().get_command(ctx, cmd_name)
         if command:

mpflash/vendor/dfu.py

@@ -46,10 +46,7 @@ def parse(file, dump_images=False):
             tprefix["name"] = cstring(tprefix["name"])
         else:
             tprefix["name"] = ""
-        print(
-            '%(signature)s %(num)d, alt setting: %(altsetting)s, name: "%(name)s", size: %(size)d, elements: %(elements)d'
-            % tprefix
-        )
+        print('%(signature)s %(num)d, alt setting: %(altsetting)s, name: "%(name)s", size: %(size)d, elements: %(elements)d' % tprefix)
         tsize = tprefix["size"]
         target, data = data[:tsize], data[tsize:]
         for e in range(tprefix["elements"]):
@@ -65,10 +62,7 @@ def parse(file, dump_images=False):
         if len(target):
             print("target %d: PARSE ERROR" % t)
     suffix = named(struct.unpack("<4H3sBI", data[:16]), "device product vendor dfu ufd len crc")
-    print(
-        "usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x"
-        % suffix
-    )
+    print("usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x" % suffix)
     if crc != suffix["crc"]:
         print("CRC ERROR: computed crc32 is 0x%08x" % crc)
     data = data[16:]

mpflash/vendor/pydfu.py

@@ -395,10 +395,7 @@ def read_dfu_file(filename):
     #   B   uint8_t     len         16
     #   I   uint32_t    crc32       Checksum
     dfu_suffix = named(struct.unpack("<4H3sBI", data[:16]), "device product vendor dfu ufd len crc")
-    print(
-        "    usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, "
-        "dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x" % dfu_suffix
-    )
+    print("    usb: %(vendor)04x:%(product)04x, device: 0x%(device)04x, " "dfu: 0x%(dfu)04x, %(ufd)s, %(len)d, 0x%(crc)08x" % dfu_suffix)
     if crc != dfu_suffix["crc"]:
         print("CRC ERROR: computed crc32 is 0x%08x" % crc)
         return
@@ -477,19 +474,11 @@ def list_dfu_devices(*args, **kwargs):
     if not devices:
         raise SystemExit("No DFU capable devices found")
     for device in devices:
-        print(
-            "Bus {} Device {:03d}: ID {:04x}:{:04x}".format(
-                device.bus, device.address, device.idVendor, device.idProduct
-            )
-        )
+        print("Bus {} Device {:03d}: ID {:04x}:{:04x}".format(device.bus, device.address, device.idVendor, device.idProduct))
         layout = get_memory_layout(device)
         print("Memory Layout")
         for entry in layout:
-            print(
-                "    0x{:x} {:2d} pages of {:3d}K bytes".format(
-                    entry["addr"], entry["num_pages"], entry["page_size"] // 1024
-                )
-            )
+            print("    0x{:x} {:2d} pages of {:3d}K bytes".format(entry["addr"], entry["num_pages"], entry["page_size"] // 1024))
 
 
 def write_elements(elements, mass_erase_used, progress=None):

mpflash/versions.py

@@ -6,10 +6,8 @@ from pathlib import Path
 
 from cache_to_disk import NoCacheCondition, cache_to_disk
 from loguru import logger as log
-from packaging.version import Version, parse
 
-import mpflash.basicgit as git
-from mpflash.common import GH_CLIENT
+from mpflash.config import config
 
 OLDEST_VERSION = "1.16"
 "This is the oldest MicroPython version to build the stubs on"
@@ -71,15 +69,18 @@ def clean_version(
 
 def is_version(version: str):
     """Check if the version is a valid version string"""
+    # Just in time import
+    from packaging.version import Version
     return Version._regex.search(version) is not None
 
 
 @cache_to_disk(n_days_to_cache=1)
 def micropython_versions(minver: str = "v1.20", reverse: bool = False, cache_it=True):
     """Get the list of micropython versions from github tags"""
-
+    # Just in time import
+    from packaging.version import parse
     try:
-        gh_client = GH_CLIENT
+        gh_client = config.gh_client
         repo = gh_client.get_repo("micropython/micropython")
         tags = [tag.name for tag in repo.get_tags() if parse(tag.name) >= parse(minver)]
         versions = [v for v in tags if not v.endswith(V_PREVIEW)]
@@ -90,7 +91,7 @@ def micropython_versions(minver: str = "v1.20", reverse: bool = False, cache_it=
         log.error(e)
         versions = []
         # returns - but does not cache
-        raise NoCacheCondition(function_value=versions)
+        raise NoCacheCondition(function_value=versions) from e
     # remove any duplicates and sort
     versions = sorted(list(set(versions)), reverse=reverse, key=lambda s: (not is_version(s), s))
     if cache_it:
@@ -116,6 +117,8 @@ def get_preview_mp_version(cache_it=True) -> str:
 # Do not cache , same path will have different versions checked out
 def checkedout_version(path: Path, flat: bool = False) -> str:
     """Get the checked-out version of the repo"""
+    # Just in time import
+    import mpflash.basicgit as git
     version = git.get_local_tag(path.as_posix())
     if not version:
         raise ValueError("No valid Tag found")

{mpflash-1.24.7.dist-info → mpflash-1.24.8.dist-info}/METADATA

@@ -1,17 +1,15 @@
 Metadata-Version: 2.3
 Name: mpflash
-Version: 1.24.7
+Version: 1.24.8
 Summary: Flash and download tool for MicroPython firmwares
 License: MIT
 Keywords: MicroPython,firmware,flash,download,UF2,esptool
 Author: Jos Verlinde
 Author-email: jos_verlinde@hotmail.com
-Requires-Python: >=3.9,<4.0
+Requires-Python: >=3.9, !=2.7.*, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*, !=3.6.*, !=3.7.*, !=3.8.*
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: Implementation :: CPython
@@ -32,14 +30,15 @@ Requires-Dist: mpremote (>=1.22.0,<2.0.0)
 Requires-Dist: packaging (>=24.2,<25.0)
 Requires-Dist: platformdirs (>=4.2.0,<5.0.0)
 Requires-Dist: poetry (>=2.0.1,<3.0.0)
-Requires-Dist: psutil (>=5.9.8,<6.0.0)
+Requires-Dist: psutil (>=5.9.8,<8.0.0)
 Requires-Dist: pygithub (>=2.1.1,<3.0.0)
 Requires-Dist: pyusb (>=1.2.1,<2.0.0)
+Requires-Dist: pywin32 (>=310,<311) ; sys_platform == "win32"
 Requires-Dist: requests (>=2.31.0,<3.0.0)
 Requires-Dist: rich-click (>=1.8.1,<2.0.0)
-Requires-Dist: tenacity (==8.2.3)
-Project-URL: Homepage, https://github.com/Josverl/micropython-stubber/blob/main/src/mpflash/README.md
-Project-URL: Repository, https://github.com/Josverl/micropython-stubber
+Requires-Dist: tenacity (==9.0.0)
+Project-URL: Homepage, https://github.com/Josverl/mpflash/blob/main/README.md
+Project-URL: Repository, https://github.com/Josverl/mpflash
 Description-Content-Type: text/markdown
 
 # MPFLASH
@@ -48,7 +47,7 @@ Description-Content-Type: text/markdown
 [![Downloads](https://static.pepy.tech/badge/mpflash)](https://pepy.tech/project/mpflash)
 
 
-`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` is a command-line tool for working with MicroPython firmware. It provides features to help you flash and update Micropython on one or more attached microcontrollers.
 
 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 be used for manual downloadig, flashing and development.
 
@@ -69,7 +68,10 @@ Not yet implemented: `nrf`, `cc3200`, `mimxrt`, `renesas`
  3. Flash one or all connected MicroPython boards with a specific firmware or version.  
  
 ## Installation
-To install mpflash, you can use: `pipx install mpflash` or `pip install mpflash`
+To install mpflash, you can use either of the following commands: 
+- `uv tool install mpflash`
+- `pipx install mpflash`
+- `pip install mpflash`
 
 ## Basic usage
 You can use mpflash to perform various operations on your MicroPython boards. Here is an example of basic usage:
@@ -102,6 +104,7 @@ description = "Blue Norwegian actuator"
 
 If you want the board to be ignored by mpflash, you can add the following to the board_info.toml file:
 ```toml
+description = "Blue Norwegian feeder"
 [mpflash]
 ignore = true
 ```
@@ -110,8 +113,13 @@ ignore = true
 ## Linux permissions to access usb devices 
 In order to flash the firmware to the board, you need to have the correct permissions to access the USB devices.
 On Windows this will not be an issue, but on Linux you can use  udev rules to give non-root users access to the USB devices.
-[See the stm32_permissions documentation](./stm32_udev_rules.md) for more information.
+[See the stm32_permissions documentation](docs/stm32_udev_rules.md) for more information.
 
+## Use MPFlash in your own project
+
+MPFlash can be used as a library in your own project. mpflash is used in [micropython-stubber]() to download and flash the firmware to the connected boards.
+
+The interface is not well documented other than the code itself, but you can use the following example to get started:  - docs/mpflash_api_example.ipynb
 
 ## Detailed usage
 You can list the connected boards using the following command:
@@ -257,9 +265,59 @@ 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) using the MPflash feedback template.
+Please report any issues or bugs in the [issue tracker](https://github.com/Josverl/mpflash/issues).
 
 ## License
 mpflash is licensed under the MIT license. See the LICENSE file for more details.
 
+# Contributions
+<!-- spell-checker: disable -->
+<!-- 
+To add via the cli run the following command:
+npx all-contributors-cli add user things
+
+ - bug
+ - tool
+ - stubs
+ - test
+ - doc
+ - code
+ - research
+ - ideas
+ - content
+ - mpflash
+ -->
+
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/Josverl"><img src="https://avatars2.githubusercontent.com/u/981654?v=4?s=100" width="100px;" alt="Jos Verlinde"/><br /><sub><b>Jos Verlinde</b></sub></a><br /><a href="https://github.com/Josverl/mpflash/commits?author=josverl" title="Code">💻</a> <a href="#research-josverl" title="Research">🔬</a> <a href="#ideas-josverl" title="Ideas, Planning, & Feedback">🤔</a> <a href="#content-josverl" title="Content">🖋</a> <a href="#test-josverl" title="Test">✅</a> <a href="#mpflash-josverl" title="mpflash">💥</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/shariltumin"><img src="https://avatars.githubusercontent.com/u/186120?v=4?s=100" width="100px;" alt="shariltumin"/><br /><sub><b>shariltumin</b></sub></a><br /><a href="#mpflash-shariltumin" title="mpflash">💥</a> <a href="#test-shariltumin" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/mattytrentini"><img src="https://avatars.githubusercontent.com/u/194201?v=4?s=100" width="100px;" alt="Matt Trentini"/><br /><sub><b>Matt Trentini</b></sub></a><br /><a href="#mpflash-mattytrentini" title="mpflash">💥</a> <a href="#test-mattytrentini" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://scruss.com/blog/"><img src="https://avatars.githubusercontent.com/u/425706?v=4?s=100" width="100px;" alt="Stewart Russell"/><br /><sub><b>Stewart Russell</b></sub></a><br /><a href="#mpflash-scruss" title="mpflash">💥</a> <a href="#test-scruss" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://www.gitlab.com/alelec"><img src="https://avatars.githubusercontent.com/u/3318786?v=4?s=100" width="100px;" alt="Andrew Leech"/><br /><sub><b>Andrew Leech</b></sub></a><br /><a href="#mpflash-andrewleech" title="mpflash">💥</a> <a href="#test-andrewleech" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/wovo"><img src="https://avatars.githubusercontent.com/u/9039468?v=4?s=100" width="100px;" alt="Wouter van Ooijen"/><br /><sub><b>Wouter van Ooijen</b></sub></a><br /><a href="#mpflash-wovo" title="mpflash">💥</a> <a href="#test-wovo" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/shaneapowell"><img src="https://avatars.githubusercontent.com/u/12113620?v=4?s=100" width="100px;" alt="Shane Powell"/><br /><sub><b>Shane Powell</b></sub></a><br /><a href="#mpflash-shaneapowell" title="mpflash">💥</a> <a href="#test-shaneapowell" title="Test">✅</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/robert-hh"><img src="https://avatars.githubusercontent.com/u/12476868?v=4?s=100" width="100px;" alt="Robert Hammelrath"/><br /><sub><b>Robert Hammelrath</b></sub></a><br /><a href="#mpflash-robert-hh" title="mpflash">💥</a> <a href="#test-robert-hh" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/beetlegigg"><img src="https://avatars.githubusercontent.com/u/34552737?v=4?s=100" width="100px;" alt="Bg"/><br /><sub><b>Bg</b></sub></a><br /><a href="#mpflash-beetlegigg" title="mpflash">💥</a> <a href="#test-beetlegigg" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/rkompass"><img src="https://avatars.githubusercontent.com/u/90282516?v=4?s=100" width="100px;" alt="Raul Kompaß"/><br /><sub><b>Raul Kompaß</b></sub></a><br /><a href="#mpflash-rkompass" title="mpflash">💥</a> <a href="#test-rkompass" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/garryp4"><img src="https://avatars.githubusercontent.com/u/96994876?v=4?s=100" width="100px;" alt="garryp4"/><br /><sub><b>garryp4</b></sub></a><br /><a href="#mpflash-garryp4" title="mpflash">💥</a> <a href="#test-garryp4" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/shanepowell-ast"><img src="https://avatars.githubusercontent.com/u/102747617?v=4?s=100" width="100px;" alt="Shane Powell"/><br /><sub><b>Shane Powell</b></sub></a><br /><a href="#mpflash-shanepowell-ast" title="mpflash">💥</a> <a href="#test-shanepowell-ast" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://andypiper.org/"><img src="https://avatars.githubusercontent.com/u/552452?v=4?s=100" width="100px;" alt="Andy Piper"/><br /><sub><b>Andy Piper</b></sub></a><br /><a href="#mpflash-andypiper" title="mpflash">💥</a> <a href="#test-andypiper" title="Test">✅</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/DavesCodeMusings"><img src="https://avatars.githubusercontent.com/u/61114342?v=4?s=100" width="100px;" alt="David Horton"/><br /><sub><b>David Horton</b></sub></a><br /><a href="#mpflash-DavesCodeMusings" title="mpflash">💥</a> <a href="#test-DavesCodeMusings" title="Test">✅</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
+