micropython-stubber 1.23.1__py3-none-any.whl → 1.23.1.post1__py3-none-any.whl

stubber/freeze/get_frozen.py

@@ -22,7 +22,7 @@ import shutil  # start moving from os & glob to pathlib
 from pathlib import Path
 from typing import List, Optional
 
-from loguru import logger as log
+from mpflash.logger import log
 from packaging.version import Version
 
 from mpflash.versions import SET_PREVIEW, V_PREVIEW
@@ -83,7 +83,9 @@ def freeze_any(
         frozen_stub_path = get_fsp(version, stub_folder)
         log.debug("MicroPython v1.11, older or other")
         # others
-        modules = freeze_folders(frozen_stub_path.as_posix(), mpy_path.as_posix(), mpy_lib_path.as_posix(), version)
+        modules = freeze_folders(
+            frozen_stub_path.as_posix(), mpy_path.as_posix(), mpy_lib_path.as_posix(), version
+        )
         count = len(modules)
     else:
         # get the current checked out version
@@ -120,7 +122,9 @@ def freeze_any(
 
 def get_fsp(version: str, stub_folder: Optional[Path] = None) -> Path:
     if not stub_folder:
-        frozen_stub_path = CONFIG.stub_path / f"{FAMILY}-{utils.clean_version(version, flat=True)}-frozen"
+        frozen_stub_path = (
+            CONFIG.stub_path / f"{FAMILY}-{utils.clean_version(version, flat=True)}-frozen"
+        )
         frozen_stub_path = frozen_stub_path.absolute()
     else:
         frozen_stub_path: Path = Path(stub_folder).absolute()

stubber/get_cpython.py

@@ -2,6 +2,7 @@
 Download or update the MicroPython compatibility modules from pycopy and stores them in the all_stubs folder
 The all_stubs folder should be mapped/symlinked to the micropython_stubs/stubs repo/folder
 """
+
 # pragma: no cover
 import json
 import os
@@ -12,7 +13,7 @@ import tempfile
 from pathlib import Path
 from typing import Optional, Union
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from . import __version__
 
@@ -22,7 +23,9 @@ from .utils.config import CONFIG
 # # log = logging.getLogger(__name__)
 
 
-def get_core(requirements: str, stub_path: Optional[Union[str, Path]] = None, family: str = "core"):
+def get_core(
+    requirements: str, stub_path: Optional[Union[str, Path]] = None, family: str = "core"
+):
     "Download MicroPython compatibility modules"
     if not stub_path:
         stub_path = CONFIG.stub_path / "cpython-core"  # pragma: no cover
@@ -71,7 +74,9 @@ def get_core(requirements: str, stub_path: Optional[Union[str, Path]] = None, fa
 
         except OSError as err:  # pragma: no cover
             log.error(
-                "An error occurred while trying to run pip to download the MicroPython compatibility modules from PyPi: {}".format(err)
+                "An error occurred while trying to run pip to download the MicroPython compatibility modules from PyPi: {}".format(
+                    err
+                )
             )
 
         # copy *.py files in build folder to stub_path
@@ -86,7 +91,13 @@ def get_core(requirements: str, stub_path: Optional[Union[str, Path]] = None, fa
                 log.exception(err)
 
     # build modules.json
-    mod_manifest = utils.manifest(family="cpython-core", port=family, version=__version__, stubtype="core", platform="cpython")
+    mod_manifest = utils.manifest(
+        family="cpython-core",
+        port=family,
+        version=__version__,
+        stubtype="core",
+        platform="cpython",
+    )
     mod_manifest["modules"] += modlist
 
     if mod_manifest and len(modlist):

stubber/minify.py

@@ -16,7 +16,7 @@ try:
 except ImportError:
     python_minifier = None
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from mpflash.versions import SET_PREVIEW, V_PREVIEW
 
@@ -205,7 +205,9 @@ def minify_script(source_script: StubSource, keep_report: bool = True, diff: boo
     elif isinstance(source_script, str):  # type: ignore
         source_content = source_script
     else:
-        raise TypeError(f"source_script must be str, Path, or file-like object, not {type(source_script)}")
+        raise TypeError(
+            f"source_script must be str, Path, or file-like object, not {type(source_script)}"
+        )
 
     if not source_content:
         raise ValueError("No source content")
@@ -400,7 +402,9 @@ def pipx_mpy_cross(version: str, source_file, _target):
     # Add params
     cmd += ["-O2", str(source_file), "-o", str(_target), "-s", "createstubs.py"]
     log.trace(" ".join(cmd))
-    result = subprocess.run(cmd, capture_output=True, text=True, encoding="utf-8")  # Specify the encoding
+    result = subprocess.run(
+        cmd, capture_output=True, text=True, encoding="utf-8"
+    )  # Specify the encoding
     return result
 
 

stubber/publish/candidates.py

@@ -14,11 +14,17 @@ import re
 from pathlib import Path
 from typing import Any, Dict, Generator, List, Optional, Union
 
-from loguru import logger as log
+from mpflash.logger import log
 from packaging.version import parse
 
 import mpflash.basicgit as git
-from mpflash.versions import OLDEST_VERSION, SET_PREVIEW, V_PREVIEW, clean_version, micropython_versions
+from mpflash.versions import (
+    OLDEST_VERSION,
+    SET_PREVIEW,
+    V_PREVIEW,
+    clean_version,
+    micropython_versions,
+)
 from stubber import utils
 from stubber.publish.defaults import GENERIC, GENERIC_L, GENERIC_U
 
@@ -108,7 +114,9 @@ def frozen_candidates(
     auto_port = is_auto(ports)
     auto_board = is_auto(boards)
     if is_auto(versions):
-        versions = list(version_candidates(suffix="frozen", prefix=family, path=path)) + [V_PREVIEW]
+        versions = list(version_candidates(suffix="frozen", prefix=family, path=path)) + [
+            V_PREVIEW
+        ]
     else:
         versions = [versions] if isinstance(versions, str) else versions
 
@@ -126,7 +134,9 @@ def frozen_candidates(
                 # lookup the (frozen) micropython ports
                 ports = list_frozen_ports(family, version, path=path)
             else:
-                raise NotImplementedError(f"auto ports not implemented for family {family}")  # pragma: no cover
+                raise NotImplementedError(
+                    f"auto ports not implemented for family {family}"
+                )  # pragma: no cover
             # elif family == "pycom":
             #     ports = ["esp32"]
             # elif family == "lobo":
@@ -159,7 +169,9 @@ def frozen_candidates(
 
                 else:
                     # raise NotImplementedError(f"auto boards not implemented for family {family}")  # pragma: no cover
-                    raise NotImplementedError(f"auto boards not implemented for family {family}")  # pragma: no cover
+                    raise NotImplementedError(
+                        f"auto boards not implemented for family {family}"
+                    )  # pragma: no cover
                 # elif family == "pycom":
                 #     boards = ["wipy", "lopy", "gpy", "fipy"]
             # ---------------------------------------------------------------------------
@@ -215,7 +227,9 @@ def board_candidates(
         else:
             r = git.checkout_tag(repo=mpy_path, tag=version)
         if not r:
-            log.warning(f"Incorrect version: {version} or did you forget to run `stubber clone` to get the micropython repo?")
+            log.warning(
+                f"Incorrect version: {version} or did you forget to run `stubber clone` to get the micropython repo?"
+            )
             return []
         ports = list_micropython_ports(family=family, mpy_path=mpy_path)
         for port in ports:
@@ -252,5 +266,10 @@ def filter_list(
         worklist = [i for i in worklist if i["port"].lower() in ports_]
     if boards and not is_auto(boards):
         boards_ = [i.lower() for i in boards]
-        worklist = [i for i in worklist if i["board"].lower() in boards_ or i["board"].lower().replace("generic_", "") in boards_]
+        worklist = [
+            i
+            for i in worklist
+            if i["board"].lower() in boards_
+            or i["board"].lower().replace("generic_", "") in boards_
+        ]
     return worklist

stubber/publish/merge_docstubs.py

@@ -6,7 +6,7 @@ import shutil
 from pathlib import Path
 from typing import List, Optional, Union
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from stubber.codemod.enrich import enrich_folder
 from stubber.publish.candidates import board_candidates, filter_list
@@ -49,7 +49,9 @@ def merge_all_docstubs(
     for candidate in candidates:
         # use the default board for the port
         if candidate["board"] in GENERIC:
-            candidate["board"] = default_board(port=candidate["port"], version=candidate["version"])
+            candidate["board"] = default_board(
+                port=candidate["port"], version=candidate["version"]
+            )
         # check if we have MCU stubs of this version and port
         doc_path = CONFIG.stub_path / f"{get_base(candidate)}-docstubs"
         # src and dest paths

stubber/publish/missing_class_methods.py

@@ -6,7 +6,7 @@ Add missing methods to classes in the stubs that are documented in the docstubs
 from pathlib import Path
 
 import libcst as cst
-from loguru import logger as log
+from mpflash.logger import log
 
 from mpflash.versions import clean_version
 from stubber.codemod.add_method import CallAdder, CallFinder
@@ -23,7 +23,9 @@ def add_machine_pin_call(merged_path: Path, version: str):
     # and to avoid having to parse the file twice
 
     # first find the __call__ method in the default stubs
-    mod_path = CONFIG.stub_path / f"micropython-{clean_version(version, flat=True)}-docstubs/machine.pyi"
+    mod_path = (
+        CONFIG.stub_path / f"micropython-{clean_version(version, flat=True)}-docstubs/machine.pyi"
+    )
     if not mod_path.exists():
         log.error(f"no docstubs found for {version}")
         return False

stubber/publish/package.py

@@ -7,7 +7,7 @@ import sys
 from pathlib import Path
 from typing import Dict, Union
 
-from loguru import logger as log
+from mpflash.logger import log
 from packaging.version import parse
 from pysondb import PysonDB
 
@@ -62,7 +62,9 @@ def get_package(
     )
 
 
-def get_package_info(db: PysonDB, pub_path: Path, *, pkg_name: str, mpy_version: str) -> Union[Dict, None]:
+def get_package_info(
+    db: PysonDB, pub_path: Path, *, pkg_name: str, mpy_version: str
+) -> Union[Dict, None]:
     """
     get a package's record from the json db if it can be found
     matches om the package name and version
@@ -70,7 +72,9 @@ def get_package_info(db: PysonDB, pub_path: Path, *, pkg_name: str, mpy_version:
         mpy_version: micropython/firmware version (1.18)
     """
     # find in the database
-    recs = db.get_by_query(query=lambda x: x["mpy_version"] == mpy_version and x["name"] == pkg_name)
+    recs = db.get_by_query(
+        query=lambda x: x["mpy_version"] == mpy_version and x["name"] == pkg_name
+    )
     # dict to list
     recs = [{"id": key, "data": recs[key]} for key in recs]
     # sort

stubber/publish/pathnames.py

@@ -6,7 +6,7 @@ Helper functions to deal with path names and filenames for the folders in the st
 from pathlib import Path
 from typing import Dict, Optional
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from mpflash.versions import V_PREVIEW, clean_version
 from stubber.publish.defaults import default_board

stubber/publish/publish.py

@@ -6,7 +6,7 @@ prepare a set of stub files for publishing to PyPi
 
 from typing import Any, Dict, List, Optional, Union
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from mpflash.versions import V_PREVIEW
 from stubber.publish.candidates import board_candidates, filter_list

stubber/publish/pypi.py

@@ -7,7 +7,7 @@ from typing import Optional
 
 from packaging.version import Version, parse
 from pypi_simple import PyPISimple, NoSuchProjectError
-from loguru import logger as log
+from mpflash.logger import log
 
 
 def get_pypi_versions(package_name: str, base: Optional[Version] = None, production: bool = True):
@@ -28,7 +28,11 @@ def get_pypi_versions(package_name: str, base: Optional[Version] = None, product
     if not package_info:
         return []
 
-    versions = [parse(pkg.version) for pkg in package_info.packages if pkg.package_type == "wheel" and pkg.version]
+    versions = [
+        parse(pkg.version)
+        for pkg in package_info.packages
+        if pkg.package_type == "wheel" and pkg.version
+    ]
     # print(versions)
 
     if base:

stubber/publish/stubpackage.py

@@ -5,6 +5,7 @@ import json
 import shutil
 import subprocess
 from pathlib import Path
+import sys
 from typing import Any, Dict, List, Optional, Tuple, Union
 
 import tenacity
@@ -12,15 +13,15 @@ import tenacity
 from mpflash.basicgit import get_git_describe
 from stubber.publish.helpers import get_module_docstring
 
-try:
-    import tomllib  # type: ignore
-except ModuleNotFoundError:
-    import tomli as tomllib  # type: ignore
+if sys.version_info >= (3, 11):
+    import tomllib # type: ignore
+else:
+    import tomli as tomllib # type: ignore
 
 from typing import NewType
 
 import tomli_w
-from loguru import logger as log
+from mpflash.logger import log
 from packaging.version import Version, parse
 from pysondb import PysonDB
 
@@ -125,9 +126,15 @@ class VersionedPackage(object):
         parts = describe.split("-", 3)
         ver = parts[0]
         if len(parts) > 1:
-            rc = parts[1] if parts[1].isdigit() else parts[2] if len(parts) > 2 and parts[2].isdigit() else 1
+            rc = (
+                parts[1]
+                if parts[1].isdigit()
+                else parts[2] if len(parts) > 2 and parts[2].isdigit() else 1
+            )
         rc = int(rc)
-        base = bump_version(Version(ver), minor_bump=True) if parts[1] != V_PREVIEW else Version(ver)
+        base = (
+            bump_version(Version(ver), minor_bump=True) if parts[1] != V_PREVIEW else Version(ver)
+        )
         return str(bump_version(base, rc=rc))
         # raise ValueError("cannot determine next version number micropython")
 
@@ -304,7 +311,9 @@ class Builder(VersionedPackage):
             # Check if all stub source folders exist
             for stub_type, src_path in self.stub_sources:
                 if not (CONFIG.stub_path / src_path).exists():
-                    raise FileNotFoundError(f"Could not find stub source folder {CONFIG.stub_path / src_path}")
+                    raise FileNotFoundError(
+                        f"Could not find stub source folder {CONFIG.stub_path / src_path}"
+                    )
 
             # 1 - Copy  the stubs to the package, directly in the package folder (no folders)
             # for stub_type, fw_path in [s for s in self.stub_sources]:
@@ -315,7 +324,9 @@ class Builder(VersionedPackage):
                     self.copy_folder(stub_type, src_path)
                 except OSError as e:
                     if stub_type != StubSource.FROZEN:
-                        raise FileNotFoundError(f"Could not find stub source folder {src_path}") from e
+                        raise FileNotFoundError(
+                            f"Could not find stub source folder {src_path}"
+                        ) from e
                     else:
                         log.debug(f"Error copying stubs from : {CONFIG.stub_path / src_path}, {e}")
         finally:
@@ -707,7 +718,8 @@ class PoetryBuilder(Builder):
         _pyproject = self.pyproject
         assert _pyproject is not None, "No pyproject.toml file found"
         _pyproject["tool"]["poetry"]["packages"] = [
-            {"include": p.relative_to(self.package_path).as_posix()} for p in sorted((self.package_path).rglob("*.pyi"))
+            {"include": p.relative_to(self.package_path).as_posix()}
+            for p in sorted((self.package_path).rglob("*.pyi"))
         ]
         # write out the pyproject.toml file
         self.pyproject = _pyproject
@@ -851,7 +863,9 @@ class StubPackage(PoetryBuilder):
         # check if the sources exist
         ok = self.are_package_sources_available()
         if not ok:
-            log.debug(f"{self.package_name}: skipping as one or more source stub folders are missing")
+            log.debug(
+                f"{self.package_name}: skipping as one or more source stub folders are missing"
+            )
             self.status["error"] = "Skipped, stub folder(s) missing"
             shutil.rmtree(self.package_path.as_posix())
             self._publish = False  # type: ignore
@@ -873,7 +887,9 @@ class StubPackage(PoetryBuilder):
         self,
         production: bool,  # PyPI or Test-PyPi - USED TO FIND THE NEXT VERSION NUMBER
         force=False,  # BUILD even if no changes
-    ) -> bool:  # sourcery skip: default-mutable-arg, extract-duplicate-method, require-parameter-annotation
+    ) -> (
+        bool
+    ):  # sourcery skip: default-mutable-arg, extract-duplicate-method, require-parameter-annotation
         """
         Build a package
         look up the previous package version in the dabase
@@ -899,14 +915,18 @@ class StubPackage(PoetryBuilder):
             if force:
                 log.info(f"Force build: {self.package_name} {self.pkg_version} ")
             else:
-                log.info(f"Found changes to package sources: {self.package_name} {self.pkg_version} ")
+                log.info(
+                    f"Found changes to package sources: {self.package_name} {self.pkg_version} "
+                )
                 log.trace(f"Old hash {self.hash} != New hash {self.calculate_hash()}")
             #  Build the distribution files
             old_ver = self.pkg_version
             self.pkg_version = self.next_package_version(production)
             self.status["version"] = self.pkg_version
             # to get the next version
-            log.debug(f"{self.package_name}: bump version for {old_ver} to {self.pkg_version } {'production' if production else 'test'}")
+            log.debug(
+                f"{self.package_name}: bump version for {old_ver} to {self.pkg_version } {'production' if production else 'test'}"
+            )
             self.write_package_json()
             log.trace(f"New hash: {self.package_name} {self.pkg_version} {self.hash}")
             if self.poetry_build():
@@ -959,7 +979,9 @@ class StubPackage(PoetryBuilder):
         # Publish the package to PyPi, Test-PyPi or Github
         if self.is_changed():
             if self.mpy_version in SET_PREVIEW and production and not force:
-                log.warning("version: `latest` package will only be available on Github, and not published to PyPi.")
+                log.warning(
+                    "version: `latest` package will only be available on Github, and not published to PyPi."
+                )
                 self.status["result"] = "Published to GitHub"
             else:
                 return self.publish_distribution(dry_run, production, db)
@@ -988,7 +1010,9 @@ class StubPackage(PoetryBuilder):
         if not dry_run:
             pub_ok = self.poetry_publish(production=production)
         else:
-            log.warning(f"{self.package_name}: Dry run, not publishing to {'' if production else 'Test-'}PyPi")
+            log.warning(
+                f"{self.package_name}: Dry run, not publishing to {'' if production else 'Test-'}PyPi"
+            )
             pub_ok = True
         if not pub_ok:
             log.warning(f"{self.package_name}: Publish failed for {self.pkg_version}")

stubber/rst/classsort.py

@@ -4,10 +4,11 @@ note that this does not take multiple inheritance into account
 ref : https://stackoverflow.com/questions/34964878/python-generate-a-dictionarytree-from-a-list-of-tuples/35049729#35049729
 with modification 
 """
+
 import re
 from typing import List
 
-from loguru import logger as log
+from mpflash.logger import log
 
 __all__ = ["sort_classes"]
 RE_CLASS = re.compile(r"class\s+(?P<class>\w+)(\((?P<parent>\w*)\))?")

stubber/rst/lookup.py

@@ -247,6 +247,7 @@ MODULE_GLUE = {
     #
     # "builtins": ["from stdlib.builtins import *"],  # integrate STDLIB
     # "machine": ["from network import AbstractNIC"],  # NIC is an abstract class, although not defined or used as such
+    "espnow": ["from _espnow import ESPNowBase"],  # ESPNowBase is an undocumented base class
 }
 
 

stubber/rst/reader.py

@@ -67,8 +67,7 @@ import re
 from pathlib import Path
 from typing import List, Optional, Tuple
 
-from loguru import logger as log
-
+from mpflash.logger import log
 from mpflash.versions import V_PREVIEW
 from stubber.rst import (
     CHILD_PARENT_CLASS,
@@ -679,15 +678,16 @@ class RSTParser(RSTReader):
 
             parent_class += method
 
-    def lstrip_self(self, params):
+    def lstrip_self(self, params: str):
         """
         To avoid duplicate selfs,
         Remove `self,` from the start of the parameters
         """
-        if params.startswith("self,"):
-            params = params[6:]
-        elif params.startswith("self ,"):
-            params = params[7:]
+        params = params.lstrip()
+
+        for start in ["self,", "self ,", "self ", "self"]:
+            if params.startswith(start):
+                params = params[len(start) :]
         return params
 
     def parse_exception(self):

stubber/rst/report_return.py

@@ -15,7 +15,7 @@ from pathlib import Path
 from typing import List, Tuple
 
 import stubber.utils as utils
-from loguru import logger as log
+from mpflash.logger import log
 
 
 def process(folder: Path, pattern: str):
@@ -34,7 +34,9 @@ def process(folder: Path, pattern: str):
                     signature = str(item[3]).split("::")[-1].strip()
                     docstring = item[4]
 
-                    r = utils._type_from_context(docstring=docstring, signature=signature, module=module_name)
+                    r = utils._type_from_context(
+                        docstring=docstring, signature=signature, module=module_name
+                    )
                     report.append(
                         {
                             "signature": signature,
@@ -49,11 +51,17 @@ def process(folder: Path, pattern: str):
                         }
                     )
                     # isGood = r["confidence"] >= 0.5 and r["confidence"] <= 0.8 and item[2] != ""
-                    isBad = float(r["confidence"]) <= 0.5 and float(r["confidence"]) <= 0.8 and item[2] != ""
+                    isBad = (
+                        float(r["confidence"]) <= 0.5
+                        and float(r["confidence"]) <= 0.8
+                        and item[2] != ""
+                    )
                     if isBad:
                         context = item[3] + ".".join((item[0], item[1], item[2]))
                         try:
-                            log.debug(f"{context:40} {r['type']:<15} - {r['confidence']} {r['match'].groups('return')}")
+                            log.debug(
+                                f"{context:40} {r['type']:<15} - {r['confidence']} {r['match'].groups('return')}"
+                            )
                         except Exception:
                             log.debug(f"{context:40} {r['type']:<15} - {r['confidence']} ")
 

stubber/rst/rst_utils.py

@@ -32,13 +32,14 @@ to do:
         https://docs.microsoft.com/en-us/azure/machine-learning/quickstart-create-resources
     - 
 """
+
 # ref: https://regex101.com/codegen?language=python
 # https://regex101.com/r/Ni8g2z/2
 
 import re
 from typing import Dict, List, Optional, Union
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from .lookup import LOOKUP_LIST, NONE_VERBS, TYPING_IMPORT
 

stubber/stubs_from_docs.py

@@ -7,7 +7,7 @@ import os
 from pathlib import Path
 from typing import List, Optional
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from stubber import utils
 from stubber.rst import DOCSTUB_SKIP, U_MODULES

stubber/tools/manifestfile.py

@@ -400,7 +400,7 @@ class ManifestFile:
                 self._metadata.pop()
 
     def _require_from_path(self, library_path, name, version, extra_kwargs):
-        for root, dirnames, filenames in os.walk(library_path):
+        for root, dirnames, filenames in os.walk(library_path): # type: ignore
             if os.path.basename(root) == name and "manifest.py" in filenames:
                 self.include(root, is_require=True, **extra_kwargs)
                 return True

stubber/update_fallback.py

@@ -7,7 +7,7 @@
 # from pathlib import Path
 # from typing import List, Optional, Tuple
 
-# from loguru import logger as log
+# from mpflash.logger import log
 
 # from mpflash.versions import V_PREVIEW
 

stubber/update_module_list.py

@@ -15,7 +15,7 @@ for this :
 from pathlib import Path
 from typing import List, Optional, Set
 
-from loguru import logger as log
+from mpflash.logger import log
 
 
 def read_modules(path: Optional[Path] = None) -> Set[str]:

stubber/utils/config.py

@@ -3,7 +3,7 @@
 from pathlib import Path
 from typing import List
 
-from loguru import logger as log
+from mpflash.logger import log
 from typedconfig.config import Config, key, section
 from typedconfig.source import EnvironmentConfigSource
 
@@ -17,7 +17,9 @@ from .typed_config_toml import TomlConfigSource
 class StubberConfig(Config):
     "stubber configuration class"
     # relative to stubs folder
-    fallback_path: Path = key(key_name="fallback-path", cast=Path, required=False, default=Path("typings/fallback"))
+    fallback_path: Path = key(
+        key_name="fallback-path", cast=Path, required=False, default=Path("typings/fallback")
+    )
     "a Path to the fallback stubs directory"
 
     # ------------------------------------------------------------------------------------------
@@ -25,16 +27,24 @@ class StubberConfig(Config):
     repo_path: Path = key(key_name="repo-path", cast=Path, required=False, default=Path("./repos"))
     "a Path to the repo directory"
 
-    mpy_path: Path = key(key_name="mpy-path", cast=Path, required=False, default=Path("micropython"))
+    mpy_path: Path = key(
+        key_name="mpy-path", cast=Path, required=False, default=Path("micropython")
+    )
     "a Path to the micropython folder in the repos directory"
 
-    mpy_lib_path: Path = key(key_name="mpy-lib-path", cast=Path, required=False, default=Path("micropython-lib"))
+    mpy_lib_path: Path = key(
+        key_name="mpy-lib-path", cast=Path, required=False, default=Path("micropython-lib")
+    )
     "a Path to the micropython-lib folder in the repos directory"
 
-    mpy_stubs_path: Path = key(key_name="mpy-stubs-path", cast=Path, required=False, default=Path("micropython-stubs"))
+    mpy_stubs_path: Path = key(
+        key_name="mpy-stubs-path", cast=Path, required=False, default=Path("micropython-stubs")
+    )
     "a Path to the micropython-stubs folder in the repos directory (or current directory)"
 
-    stable_version: str = key(key_name="stable-version", cast=str, required=False, default="1.20.0")
+    stable_version: str = key(
+        key_name="stable-version", cast=str, required=False, default="1.20.0"
+    )
 
     "last published stable"
 
@@ -113,7 +123,9 @@ def readconfig(filename: str = "pyproject.toml", prefix: str = "tool.", must_exi
     # add provider sources to the config
     config.add_source(EnvironmentConfigSource())
     if use_toml:
-        config.add_source(TomlConfigSource(filename, prefix=prefix, must_exist=must_exist))  # ,"tools.micropython-stubber"))
+        config.add_source(
+            TomlConfigSource(filename, prefix=prefix, must_exist=must_exist)
+        )  # ,"tools.micropython-stubber"))
     config.read()
     return config