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

stubber/freeze/common.py

@@ -5,7 +5,7 @@ import shutil
 from pathlib import Path
 from typing import Tuple
 
-from loguru import logger as log
+from mpflash.logger import log
 
 from stubber.publish.defaults import GENERIC_U
 
@@ -17,7 +17,9 @@ def get_portboard(manifest_path: Path):
     raises an ValueError if neither a port or board can be found
     """
     # https://regex101.com/r/tv7JX4/1
-    re_pb = r".*micropython[\/\\]ports[\/\\](?P<port>[\w_-]*)([\/\\]boards[\/\\](?P<board>\w*))?[\/\\]"
+    re_pb = (
+        r".*micropython[\/\\]ports[\/\\](?P<port>[\w_-]*)([\/\\]boards[\/\\](?P<board>\w*))?[\/\\]"
+    )
     mpy_port = mpy_board = ""
     if matches := re.search(re_pb, manifest_path.absolute().as_posix()):
         # port and board
@@ -50,7 +52,9 @@ def apply_frozen_module_fixes(freeze_path: Path, mpy_path: Path):
     apply common fixes to the fozen modules to improve stub generation
     """
     # NOTE: FIX 1 add __init__.py to umqtt
-    if (freeze_path / "umqtt/robust.py").exists():  # and not (freeze_path / "umqtt" / "__init__.py").exists():
+    if (
+        freeze_path / "umqtt/robust.py"
+    ).exists():  # and not (freeze_path / "umqtt" / "__init__.py").exists():
         log.debug("add missing : umqtt/__init__.py")
         with open(freeze_path / "umqtt" / "__init__.py", "a") as f:
             f.write("")

stubber/freeze/freeze_folder.py

@@ -6,7 +6,7 @@ import shutil
 import warnings
 from pathlib import Path  # start moving from os & glob to pathlib
 
-from loguru import logger as log
+from mpflash.logger import log
 from stubber.utils.repos import match_lib_with_mpy
 
 from .. import utils
@@ -25,7 +25,7 @@ def freeze_folders(stub_folder: str, mpy_folder: str, lib_folder: str, version:
     - 'ports/<port>/modules/*.py'
     - 'ports/<port>/boards/<board>/modules/*.py'
     """
-    match_lib_with_mpy(version_tag=version, mpy_path=Path(mpy_folder),lib_path=Path(lib_folder))
+    match_lib_with_mpy(version_tag=version, mpy_path=Path(mpy_folder), lib_path=Path(lib_folder))
 
     targets = []
     scripts = glob.glob(mpy_folder + "/ports/**/modules/*.py", recursive=True)

stubber/freeze/freeze_manifest_2.py

@@ -9,7 +9,7 @@ import shutil
 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.tools.manifestfile import MODE_FREEZE, ManifestFile, ManifestFileError, ManifestOutput
@@ -51,7 +51,9 @@ def make_path_vars(
     }
 
 
-def freeze_one_manifest_2(manifest: Path, frozen_stub_path: Path, mpy_path: Path, mpy_lib_path: Path, version: str):
+def freeze_one_manifest_2(
+    manifest: Path, frozen_stub_path: Path, mpy_path: Path, mpy_lib_path: Path, version: str
+):
     # apparently there can be multiple manifest files to a board ?
     # save cwd for 'misbehaving' older esp8266 manifest files
     cwd = Path.cwd()
@@ -61,7 +63,9 @@ def freeze_one_manifest_2(manifest: Path, frozen_stub_path: Path, mpy_path: Path
 
     log.info("port-board: {}".format((port + "-" + board).rstrip("-")))
 
-    path_vars = make_path_vars(port=port, board=board, mpy_path=mpy_path, mpy_lib_path=mpy_lib_path)
+    path_vars = make_path_vars(
+        port=port, board=board, mpy_path=mpy_path, mpy_lib_path=mpy_lib_path
+    )
     upy_manifest = ManifestFile(MODE_FREEZE, path_vars)
     try:
         # assume manifestneeds to be run from the port's folder
@@ -75,11 +79,18 @@ def freeze_one_manifest_2(manifest: Path, frozen_stub_path: Path, mpy_path: Path
     # restore working directory
     os.chdir(cwd)
     # save the frozen files to the stubs
-    copy_frozen_to_stubs(frozen_stub_path, port, board, upy_manifest.files(), version, mpy_path=mpy_path)
+    copy_frozen_to_stubs(
+        frozen_stub_path, port, board, upy_manifest.files(), version, mpy_path=mpy_path
+    )
 
 
 def copy_frozen_to_stubs(
-    stub_path: Path, port: str, board: str, files: List[ManifestOutput], version: str, mpy_path: Path
+    stub_path: Path,
+    port: str,
+    board: str,
+    files: List[ManifestOutput],
+    version: str,
+    mpy_path: Path,
 ):
     """
     copy the frozen files from the manifest to the stubs folder
@@ -110,4 +121,6 @@ def copy_frozen_to_stubs(
 
     # make a module manifest
     FAMILY = "micropython"
-    utils.make_manifest(freeze_path, FAMILY, port=port, board=board, version=version, stubtype="frozen")
+    utils.make_manifest(
+        freeze_path, FAMILY, port=port, board=board, version=version, stubtype="frozen"
+    )

stubber/freeze/get_frozen.py

@@ -22,14 +22,14 @@ 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
 from stubber import utils
 from stubber.freeze.freeze_folder import freeze_folders  # Micropython < v1.12
 from stubber.freeze.freeze_manifest_2 import freeze_one_manifest_2
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import SET_PREVIEW, V_PREVIEW
 
 FAMILY = "micropython"
 
@@ -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

@@ -2,6 +2,7 @@
 Processing for createstubs.py
 Minimizes and cross-compiles a MicroPyton file.
 """
+
 import itertools
 import subprocess
 import tempfile
@@ -10,14 +11,14 @@ from io import BytesIO, IOBase, StringIO, TextIOWrapper
 from pathlib import Path
 from typing import List, Tuple, Union
 
-try: 
+try:
     import python_minifier
 except ImportError:
     python_minifier = None
 
-from loguru import logger as log
+from mpflash.logger import log
 
-from stubber.utils.versions import SET_PREVIEW, V_PREVIEW
+from mpflash.versions import SET_PREVIEW, V_PREVIEW
 
 # Type Aliases for minify
 StubSource = Union[Path, str, StringIO, TextIOWrapper]
@@ -204,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")
@@ -243,7 +246,7 @@ def minify_script(source_script: StubSource, keep_report: bool = True, diff: boo
             ],
             # remove_pass=True,  # no dead code
             # convert_posargs_to_args=True, # Does not save any space
-    )
+        )
     len_3 = len(min_source)
     if 1:
         # write to temp file for debugging
@@ -399,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,16 +14,22 @@ 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 stubber.basicgit as git
+import mpflash.basicgit as git
+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
 
 # from stubber.publish.enums import COMBO_STUBS
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import OLDEST_VERSION, SET_PREVIEW, V_PREVIEW, clean_version, micropython_versions
 
 
 def subfolder_names(path: Path):
@@ -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"]
             # ---------------------------------------------------------------------------
@@ -257,6 +269,7 @@ def filter_list(
         worklist = [
             i
             for i in worklist
-            if i["board"].lower() in boards_ or i["board"].lower().replace("generic_", "") in boards_
+            if i["board"].lower() in boards_
+            or i["board"].lower().replace("generic_", "") in boards_
         ]
     return worklist

stubber/publish/defaults.py

@@ -1,8 +1,9 @@
 """Build and packaging defaults for stubber"""
+
 from typing import Dict, List
 
+from mpflash.versions import V_PREVIEW, clean_version
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import V_PREVIEW, clean_version
 
 # The default board for the ports modules documented with base name only
 # as the MicroPython BOARD naming convention has changed over time there are different options to try
@@ -29,15 +30,9 @@ def default_board(port: str, version=V_PREVIEW) -> str:  # sourcery skip: assign
     ver_flat = clean_version(version, flat=True)
     if port in DEFAULT_BOARDS:
         for board in DEFAULT_BOARDS[port]:
-            base = (
-                f"micropython-{ver_flat}-{port}-{board}"
-                if board
-                else f"micropython-{ver_flat}-{port}"
-            )
+            base = f"micropython-{ver_flat}-{port}-{board}" if board else f"micropython-{ver_flat}-{port}"
             # check if we have a (merged)stub for this version and port
-            if (CONFIG.stub_path / f"{base}-merged").exists() or (
-                CONFIG.stub_path / base
-            ).exists():
+            if (CONFIG.stub_path / f"{base}-merged").exists() or (CONFIG.stub_path / base).exists():
                 return board
         # fallback to first listed board
         return DEFAULT_BOARDS[port][0]

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,12 +6,12 @@ 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
 from stubber.utils.config import CONFIG
 from stubber.utils.post import run_black
-from stubber.utils.versions import clean_version
 
 
 def add_machine_pin_call(merged_path: Path, version: str):
@@ -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,15 +7,15 @@ 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
 
+from mpflash.versions import clean_version
 from stubber.publish.defaults import GENERIC, GENERIC_L, default_board
 from stubber.publish.enums import StubSource
 from stubber.publish.stubpackage import StubPackage, StubSources
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import clean_version
 
 # replace std log handler with a custom one capped on INFO level
 log.remove()
@@ -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,12 +6,12 @@ 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
 from stubber.publish.package import GENERIC
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import V_PREVIEW, clean_version
 
 
 ## Helper functions

stubber/publish/publish.py

@@ -6,14 +6,14 @@ 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
 from stubber.publish.database import get_database
 from stubber.publish.defaults import GENERIC_U
 from stubber.publish.package import get_package
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import V_PREVIEW
 
 
 def build_multiple(

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,31 +5,32 @@ import json
 import shutil
 import subprocess
 from pathlib import Path
+import sys
 from typing import Any, Dict, List, Optional, Tuple, Union
 
 import tenacity
 
-from stubber.basicgit import get_git_describe
+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
 
+from mpflash.versions import SET_PREVIEW, V_PREVIEW, clean_version
 from stubber.publish.bump import bump_version
 from stubber.publish.defaults import GENERIC_U, default_board
 from stubber.publish.enums import StubSource
 from stubber.publish.pypi import Version, get_pypi_versions
 from stubber.utils.config import CONFIG
-from stubber.utils.versions import SET_PREVIEW, V_PREVIEW, clean_version
 
 Status = NewType("Status", Dict[str, Union[str, None]])
 StubSources = List[Tuple[StubSource, Path]]
@@ -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,7 +915,9 @@ 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
@@ -961,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)
@@ -990,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
 }