micropython-stubber 1.20.2__py3-none-any.whl → 1.20.5__py3-none-any.whl

stubber/board/createstubs_mem.py

@@ -9,7 +9,7 @@
     - cross compilation, using mpy-cross, 
       to avoid the compilation step on the micropython device 
 
-This variant was generated from createstubs.py by micropython-stubber v1.20.2
+This variant was generated from createstubs.py by micropython-stubber v1.20.5
 """
 
 # Copyright (c) 2019-2024 Jos Verlinde
@@ -34,7 +34,7 @@ try:
 except ImportError:
     from ucollections import OrderedDict  # type: ignore
 
-__version__ = "v1.20.2"
+__version__ = "v1.20.5"
 ENOENT = 2
 _MAX_CLASS_LEVEL = 2  # Max class nesting
 LIBS = ["lib", "/lib", "/sd/lib", "/flash/lib", "."]
@@ -237,7 +237,6 @@ class Stubber:
         # Start a new file
         ensure_folder(file_name)
         with open(file_name, "w") as fp:
-            # todo: improve header
             info_ = str(self.info).replace("OrderedDict(", "").replace("})", "}")
             s = '"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(module_name, self._fwid, info_, __version__)
             fp.write(s)
@@ -598,10 +597,10 @@ 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.2 do not have a micro .0
+            and info["version"] >= "1.10.0"  # versions from 1.10.0 to 1.20.5 do not have a micro .0
             and info["version"] <= "1.19.9"
         ):
-            # versions from 1.10.0 to 1.20.2 do not have a micro .0
+            # versions from 1.10.0 to 1.20.5 do not have a micro .0
             info["version"] = info["version"][:-2]
 
     # spell-checker: disable

stubber/board/createstubs_mem_min.py

@@ -47,7 +47,7 @@ try:from machine import reset
 except N:pass
 try:from collections import OrderedDict as g
 except N:from ucollections import OrderedDict as g
-__version__='v1.20.2'
+__version__='v1.20.5'
 y=2
 z=2
 A0=['lib','/lib','/sd/lib','/flash/lib',J]

stubber/board/createstubs_min.py

@@ -50,7 +50,7 @@ try:from machine import reset
 except N:pass
 try:from collections import OrderedDict as h
 except N:from ucollections import OrderedDict as h
-__version__='v1.20.2'
+__version__='v1.20.5'
 A0=2
 A1=2
 A5=['lib','/lib','/sd/lib','/flash/lib',J]
@@ -287,7 +287,7 @@ def read_path():
 def j():
 	try:A=bytes('abc',encoding='utf8');B=j.__module__;return H
 	except(k,I):return U
-def main():stubber=Stubber(path=read_path());stubber.clean();stubber.modules=['WM8960','_OTA','_asyncio','_boot_fat','_coap','_espnow','_flash_control_OTA','_main_pybytes','_mqtt','_mqtt_core','_msg_handl','_onewire','_periodical_pin','_pybytes','_pybytes_ca','_pybytes_config','_pybytes_config_reader','_pybytes_connection','_pybytes_constants','_pybytes_debug','_pybytes_library','_pybytes_machine_learning','_pybytes_main','_pybytes_protocol','_pybytes_pyconfig','_pybytes_pymesh_config','_rp2','_terminal','_thread','_uasyncio','_urequest','adcfft','aioble/__init__','aioble/central','aioble/client','aioble/core','aioble/device','aioble/l2cap','aioble/peripheral','aioble/security','aioble/server','aioespnow','ak8963','apa102','apa106','argparse','array','asyncio/__init__','asyncio/core','asyncio/event','asyncio/funcs','asyncio/lock','asyncio/stream','binascii','bluetooth','breakout_as7262','breakout_bh1745','breakout_bme280','breakout_bme68x','breakout_bmp280','breakout_dotmatrix','breakout_encoder','breakout_icp10125','breakout_ioexpander','breakout_ltr559','breakout_matrix11x7','breakout_mics6814','breakout_msa301','breakout_paa5100','breakout_pmw3901','breakout_potentiometer','breakout_rgbmatrix5x5','breakout_rtc','breakout_scd41','breakout_sgp30','breakout_trackball','breakout_vl53l5cx','btree','cmath','collections','crypto','cryptolib','curl','deflate','dht','display','display_driver_utils','ds18x20','encoder','errno','esp','esp32','espidf','espnow','ffi','flashbdev','framebuf','freesans20','fs_driver','functools','galactic','gc','gfx_pack','gsm','hashlib','heapq','hub75','ili9341','ili9XXX','imagetools','inisetup','interstate75','io','jpegdec','json','lcd160cr','lodepng',w,'lsm6dsox','lv_colors','lv_utils','lvgl','lwip','machine','math','microWebSocket','microWebSrv','microWebTemplate',b,'mip','mip/__init__','mip/__main__','motor','mpu6500','mpu9250','neopixel','network','ntptime','onewire','os','pcf85063a','picoexplorer','picographics','picokeypad','picoscroll','picounicorn','picowireless','pimoroni','pimoroni_bus','pimoroni_i2c','plasma','platform','pyb',g,'pye','qrcode','queue','random','requests','requests/__init__','rp2','rtch','samd','select','servo','socket','ssd1306','ssh','ssl','stm','struct',v,'termios','time','tls','tpcalib','uarray','uasyncio/__init__','uasyncio/core','uasyncio/event','uasyncio/funcs','uasyncio/lock','uasyncio/stream','uasyncio/tasks','ubinascii','ubluetooth','ucollections','ucrypto','ucryptolib','uctypes','uerrno','uftpd','uhashlib','uheapq','uio','ujson','ulab','ulab/approx','ulab/compare','ulab/fft','ulab/filter','ulab/linalg','ulab/numerical','ulab/poly','ulab/user','ulab/vector','umachine','umqtt/__init__','umqtt/robust','umqtt/simple','uos','uplatform','uqueue','urandom','ure','urequests','urllib/urequest','uselect','usocket','ussl','ustruct','usys','utelnetserver','utime','utimeq','uwebsocket','uzlib',C,'vfs','websocket','websocket_helper','wipy','writer','xpt2046','ymodem','zephyr','zlib'];F.collect();stubber.create_all_stubs()
+def main():stubber=Stubber(path=read_path());stubber.clean();stubber.modules=['WM8960','_OTA','_asyncio','_boot_fat','_coap','_espnow','_flash_control_OTA','_main_pybytes','_mqtt','_mqtt_core','_msg_handl','_onewire','_periodical_pin','_pybytes','_pybytes_ca','_pybytes_config','_pybytes_config_reader','_pybytes_connection','_pybytes_constants','_pybytes_debug','_pybytes_library','_pybytes_machine_learning','_pybytes_main','_pybytes_protocol','_pybytes_pyconfig','_pybytes_pymesh_config','_rp2','_terminal','_thread','_uasyncio','_urequest','adcfft','aioble/__init__','aioble/central','aioble/client','aioble/core','aioble/device','aioble/l2cap','aioble/peripheral','aioble/security','aioble/server','aioespnow','ak8963','apa102','apa106','argparse','array','asyncio/__init__','asyncio/core','asyncio/event','asyncio/funcs','asyncio/lock','asyncio/stream','binascii','bluetooth','breakout_as7262','breakout_bh1745','breakout_bme280','breakout_bme68x','breakout_bmp280','breakout_dotmatrix','breakout_encoder','breakout_icp10125','breakout_ioexpander','breakout_ltr559','breakout_matrix11x7','breakout_mics6814','breakout_msa301','breakout_paa5100','breakout_pmw3901','breakout_potentiometer','breakout_rgbmatrix5x5','breakout_rtc','breakout_scd41','breakout_sgp30','breakout_trackball','breakout_vl53l5cx','btree','cmath','collections','crypto','cryptolib','curl','deflate','dht','display','display_driver_utils','ds18x20','encoder','errno','esp','esp32','espidf','espnow','ffi','flashbdev','framebuf','freesans20','fs_driver','functools','galactic','gc','gfx_pack','gsm','hashlib','heapq','hub75','ili9341','ili9XXX','imagetools','inisetup','interstate75','io','jpegdec','js','jsffi','json','lcd160cr','lodepng',w,'lsm6dsox','lv_colors','lv_utils','lvgl','lwip','machine','math','microWebSocket','microWebSrv','microWebTemplate',b,'mip','mip/__init__','mip/__main__','motor','mpu6500','mpu9250','neopixel','network','ntptime','onewire','openamp','os','pcf85063a','picoexplorer','picographics','picokeypad','picoscroll','picounicorn','picowireless','pimoroni','pimoroni_bus','pimoroni_i2c','plasma','platform','pyb',g,'pye','qrcode','queue','random','requests','requests/__init__','rp2','rtch','samd','select','servo','socket','ssd1306','ssh','ssl','stm','struct',v,'termios','time','tls','tpcalib','uarray','uasyncio/__init__','uasyncio/core','uasyncio/event','uasyncio/funcs','uasyncio/lock','uasyncio/stream','uasyncio/tasks','ubinascii','ubluetooth','ucollections','ucrypto','ucryptolib','uctypes','uerrno','uftpd','uhashlib','uheapq','uio','ujson','ulab','ulab/approx','ulab/compare','ulab/fft','ulab/filter','ulab/linalg','ulab/numerical','ulab/poly','ulab/user','ulab/vector','umachine','umqtt/__init__','umqtt/robust','umqtt/simple','uos','uplatform','uqueue','urandom','ure','urequests','urllib/urequest','usb/device','usb/device/cdc','usb/device/hid','usb/device/keyboard','usb/device/midi','usb/device/mouse','uselect','usocket','ussl','ustruct','usys','utelnetserver','utime','utimeq','uwebsocket','uzlib',C,'vfs','websocket','websocket_helper','wipy','writer','xpt2046','ymodem','zephyr','zlib'];F.collect();stubber.create_all_stubs()
 if __name__=='__main__'or j():
 	if not A4('no_auto_stubber.txt'):
 		try:F.threshold(4*1024);F.enable()

stubber/board/modulelist.txt

@@ -113,6 +113,8 @@ inisetup
 interstate75
 io
 jpegdec
+js
+jsffi
 json
 lcd160cr
 lodepng
@@ -138,6 +140,7 @@ neopixel
 network
 ntptime
 onewire
+openamp
 os
 pcf85063a
 picoexplorer
@@ -216,6 +219,12 @@ urandom
 ure
 urequests
 urllib/urequest
+usb/device
+usb/device/cdc
+usb/device/hid
+usb/device/keyboard
+usb/device/midi
+usb/device/mouse
 uselect
 usocket
 ussl

stubber/bulk/mcu_stubber.py

@@ -23,7 +23,6 @@ from stubber.publish.pathnames import board_folder_name
 from stubber.publish.publish import build_multiple
 from stubber.utils.config import CONFIG
 
-# TODO : make this a bit nicer
 HERE = Path(__file__).parent
 ###############################################################################################
 # TODO: promote to cmdline params

stubber/codemod/_partials/__init__.py

@@ -3,7 +3,6 @@ from enum import Enum
 from pathlib import Path
 from typing import Iterator, cast
 
-# TODO: this way of accessing the partials is not very robust
 PARTIALS_DIR = Path(__file__).parent.absolute()
 
 PARTIAL_START = "###PARTIAL###"
@@ -18,7 +17,6 @@ def _read_partial(path: Path) -> Iterator[str]:
     lines = deque(path.read_text(encoding="utf-8").splitlines(keepends=True))
     _start = False
     _end = False
-    # todo: allow processing of files that do not have the markers
     while True:
         try:
             if not _start and (line := lines.popleft()):

stubber/publish/candidates.py

@@ -20,7 +20,8 @@ from packaging.version import parse
 import stubber.basicgit as git
 from stubber import utils
 from stubber.publish.defaults import GENERIC, GENERIC_L, GENERIC_U
-from stubber.publish.enums import COMBO_STUBS, DOC_STUBS, FIRMWARE_STUBS
+
+# 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
 
@@ -139,7 +140,7 @@ def frozen_candidates(
                     "version": version,
                     "port": port,
                     "board": GENERIC_L,
-                    "pkg_type": COMBO_STUBS,
+                    # "pkg_type": COMBO_STUBS,
                 }
             # if not auto_board:
             #     for board in boards:
@@ -177,7 +178,7 @@ def frozen_candidates(
                         "version": version,
                         "port": port,
                         "board": board,
-                        "pkg_type": COMBO_STUBS,
+                        # "pkg_type": COMBO_STUBS,
                     }
 
 
@@ -189,33 +190,11 @@ def is_auto(thing: Union[None, str, List[str]]):
         return any(i in ["auto", "all"] for i in thing)
 
 
-def docstub_candidates(
-    family: str = "micropython",
-    versions: Union[str, List[str]] = V_PREVIEW,
-    path: Path = CONFIG.stub_path,
-):
-    """
-    Generate a list of possible documentation stub candidates for the given family and version.
-
-    Note that the folders do not need to exist, with the exception of auto which will scan the stubs folder for versions of docstubs
-    """
-    if isinstance(versions, str):
-        if is_auto(versions):  # auto with vprefix ...
-            versions = list(version_candidates(suffix="docstubs", prefix=family, path=path))
-        else:
-            versions = [versions]
-    versions = [clean_version(v, flat=True) for v in versions]
-
-    for version in versions:
-        yield {"family": family, "version": version, "pkg_type": DOC_STUBS}
-
-
 def board_candidates(
     family: str = "micropython",
     versions: Union[str, List[str]] = V_PREVIEW,
     *,
     mpy_path: Path = CONFIG.mpy_path,
-    pt: str = FIRMWARE_STUBS,
 ):
     """
     generate a list of possible board stub candidates for the given family and version.
@@ -236,7 +215,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:
@@ -246,7 +227,6 @@ def board_candidates(
                 "version": version,
                 "port": port,
                 "board": GENERIC_U,
-                "pkg_type": pt,
             }
             for board in list_micropython_port_boards(family=family, mpy_path=mpy_path, port=port):
                 if board not in GENERIC:
@@ -255,7 +235,6 @@ def board_candidates(
                         "version": version,
                         "port": port,
                         "board": board,
-                        "pkg_type": pt,
                     }
 
 

stubber/publish/enums.py

@@ -22,9 +22,3 @@ class StubSource(str, Enum):
         # Always force string values
         return self.value
 
-
-ALL_TYPES = ["combo", "doc", "core", "firmware"]
-COMBO_STUBS = ALL_TYPES[0]
-DOC_STUBS = ALL_TYPES[1]
-CORE_STUBS = ALL_TYPES[2]
-FIRMWARE_STUBS = ALL_TYPES[3]

stubber/publish/package.py

@@ -2,6 +2,7 @@
 prepare a set of stub files for publishing to PyPi
 
 """
+
 import sys
 from pathlib import Path
 from typing import Dict, Union
@@ -11,7 +12,7 @@ from packaging.version import parse
 from pysondb import PysonDB
 
 from stubber.publish.defaults import GENERIC, GENERIC_L, default_board
-from stubber.publish.enums import COMBO_STUBS, CORE_STUBS, DOC_STUBS, StubSource
+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
@@ -21,27 +22,12 @@ log.remove()
 log.add(sys.stderr, level="INFO", backtrace=True, diagnose=True)
 
 
-def package_name(
-    pkg_type: str, *, port: str = "", board: str = "", family: str = "micropython", **kwargs
-) -> str:
+def package_name(*, port: str = "", board: str = "", family: str = "micropython", **kwargs) -> str:
     "generate a package name for the given package type"
-    if pkg_type == COMBO_STUBS:
-        # # {family}-{port}-{board}-stubs
-        name = f"{family}-{port}-{board}-stubs".lower()
-        name = name.replace("-generic-stubs", "-stubs")
-        # Use explicit generic_ names for the stubs
-        # name = name.replace("-generic_", "-")  # @GENERIC Prefix
-        return name
-    elif pkg_type == DOC_STUBS:
-        return f"{family}-doc-stubs".lower()
-    elif pkg_type == CORE_STUBS:
-        return f"{family}-core-stubs".lower()
-    # # {family}-{port}-{board}-{type}-stubs
-    name = f"{family}-{port}-{board}-{pkg_type}-stubs".lower()
+    # # {family}-{port}[-{board}[-{variant}]]-stubs
+    name = f"{family}-{port}-{board}-stubs".lower()
+    name = name.replace("-generic-stubs", "-stubs")
     # Use explicit generic_ names for the stubs
-    # # remove -generic- from the name
-    # name = name.replace(f"-generic-{pkg_type}-stubs", f"-{pkg_type}-stubs")
-    # # remove -genetic_ from the name
     # name = name.replace("-generic_", "-")  # @GENERIC Prefix
     return name
 
@@ -49,14 +35,13 @@ def package_name(
 def get_package(
     db: PysonDB,
     *,
-    pkg_type: str,
     version: str,
     port: str,
     board: str = GENERIC_L,
     family: str = "micropython",
 ) -> StubPackage:
     """Get the package from the database or create a new one if it does not exist."""
-    pkg_name = package_name(pkg_type, port=port, board=board, family=family)
+    pkg_name = package_name(port=port, board=board, family=family)
     version = clean_version(version, drop_v=True)
     if package_info := get_package_info(
         db,
@@ -74,13 +59,10 @@ def get_package(
         port=port,
         board=board,
         family=family,
-        pkg_type=pkg_type,
     )
 
 
-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
@@ -88,9 +70,7 @@ def get_package_info(
         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
@@ -108,32 +88,21 @@ def create_package(
     pkg_name: str,
     mpy_version: str,
     *,
-    port: str = "",
+    port: str,
     board: str = "",
     family: str = "micropython",
-    pkg_type: str = COMBO_STUBS,
+    # pkg_type: str = COMBO_STUBS,
 ) -> StubPackage:  # sourcery skip: merge-duplicate-blocks, remove-redundant-if
     """
     create and initialize a package with the correct sources
     """
     ver_flat = clean_version(mpy_version, flat=True)
     stubs: StubSources = []
-    if pkg_type == COMBO_STUBS:
-        assert port != "", "port must be specified for combo stubs"
-        stubs = combo_sources(family, port, board, ver_flat)
-    elif pkg_type == DOC_STUBS:
-        stubs = [
-            (
-                StubSource.DOC,
-                Path(f"{family}-{ver_flat}-docstubs"),
-            ),
-        ]
-    elif pkg_type == CORE_STUBS:
-        # TODO add core stubs
-        raise NotImplementedError(type)
-    else:
-        raise NotImplementedError(type)
+    # if pkg_type != COMBO_STUBS:
+    #     raise ValueError("Not Supported")
 
+    assert port != "", "port must be specified for combo stubs"
+    stubs = combo_sources(family, port, board, ver_flat)
     return StubPackage(pkg_name, port=port, board=board, version=mpy_version, stubs=stubs)
 
 

stubber/publish/publish.py

@@ -11,7 +11,6 @@ from loguru import logger as log
 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.enums import COMBO_STUBS
 from stubber.publish.package import get_package
 from stubber.utils.config import CONFIG
 from stubber.utils.versions import V_PREVIEW
@@ -110,7 +109,7 @@ def build_worklist(
     if family != "micropython":
         return []
     # get all the candidates
-    worklist = list(board_candidates(family=family, versions=versions, pt=COMBO_STUBS))
+    worklist = list(board_candidates(family=family, versions=versions))
     worklist = filter_list(worklist, ports, boards)
 
     for b in boards:

stubber/rst/lookup.py

@@ -254,7 +254,7 @@ PARAM_FIXES = [
     Fix("\\*", "*"),  # change weirdly written wildcards \* --> *
     Fix(r"\**", "*"),  # change weirdly written wildcards \* --> *
     Fix(r"/*", "*"),  # change weirdly written wildcards \* --> *
-    # ("**", "*"),  # change weirdly written wildcards \* --> *
+    Fix(r"/)", ")"),  # strange terminator in machine.USBDevice `USBDevice.active(self, [value] /)`
     Fix("'param'", "param"),  # loose notation in documentation
     # illegal keywords
     Fix(
@@ -484,17 +484,17 @@ PARAM_FIXES = [
 # List of classes and their parent classes that should be added to the class definition
 CHILD_PARENT_CLASS = {
     # machine
-    # SoftSPI is defined before SPI, so baseclass is not yet available - but in a .pyi that is OK 
-    "SoftSPI": "SPI",  
+    # SoftSPI is defined before SPI, so baseclass is not yet available - but in a .pyi that is OK
+    "SoftSPI": "SPI",
     "SoftI2C": "I2C",
     "Switch": "Pin",
     "Signal": "Pin",
     # uio # unclear regarding deprecation in python 3.12
     # "IOBase": "IO",  # DOCME  not in documentation
-    "TextIOWrapper": "IO", # "TextIOBase, TextIO",  # based on Stdlib
-    "FileIO": "IO", #  "RawIOBase, BinaryIO",  # based on Stdlib
-    "StringIO": "IO", #  "BufferedIOBase, BinaryIO",  # based on Stdlib
-    "BytesIO": "IO", # "BufferedIOBase, BinaryIO",  # based on Stdlib
+    "TextIOWrapper": "IO",  # "TextIOBase, TextIO",  # based on Stdlib
+    "FileIO": "IO",  #  "RawIOBase, BinaryIO",  # based on Stdlib
+    "StringIO": "IO",  #  "BufferedIOBase, BinaryIO",  # based on Stdlib
+    "BytesIO": "IO",  # "BufferedIOBase, BinaryIO",  # based on Stdlib
     "BufferedWriter": "IOBase",  # DOCME: not in documentation #   "BufferedWriter": "BufferedIOBase",  # based on Stdlib
     # uzlib
     # "DecompIO": "IO",  # https://docs.python.org/3/library/typing.html#other-concrete-types

stubber/rst/reader.py

@@ -63,7 +63,6 @@ Note: black on python 3.7 does not like some function defs
 
 """
 
-
 import re
 from pathlib import Path
 from typing import List, Optional, Tuple
@@ -150,11 +149,7 @@ class FileReadWriter:
         """
         append = 0
         newline = self.rst_text[self.line_no]
-        while (
-            not self.is_balanced(newline)
-            and self.line_no >= 0
-            and (self.line_no + append + 1) <= self.max_line
-        ):
+        while not self.is_balanced(newline) and self.line_no >= 0 and (self.line_no + append + 1) <= self.max_line:
             append += 1
             # concat the lines
             newline += self.rst_text[self.line_no + append]
@@ -225,9 +220,7 @@ class RSTReader(FileReadWriter):
         "stop at heading"
         u_line = self.rst_text[min(self.line_no + 1, self.max_line - 1)].rstrip()
         # Heading  ---, ==, ~~~
-        underlined = (
-            u_line.startswith("---") or u_line.startswith("===") or u_line.startswith("~~~")
-        )
+        underlined = u_line.startswith("---") or u_line.startswith("===") or u_line.startswith("~~~")
         if underlined and self.line_no > 0:
             # check if previous line is a heading
             line = self.rst_text[self.line_no].strip()
@@ -374,12 +367,8 @@ class RSTParser(RSTReader):
     target = ".py"  # py/pyi
     # TODO: Move to lookup.py
     PARAM_RE_FIXES = [
-        Fix(
-            r"\[angle, time=0\]", "[angle], time=0", is_re=True
-        ),  # fix: method:: Servo.angle([angle, time=0])
-        Fix(
-            r"\[speed, time=0\]", "[speed], time=0", is_re=True
-        ),  # fix: .. method:: Servo.speed([speed, time=0])
+        Fix(r"\[angle, time=0\]", "[angle], time=0", is_re=True),  # fix: method:: Servo.angle([angle, time=0])
+        Fix(r"\[speed, time=0\]", "[speed], time=0", is_re=True),  # fix: .. method:: Servo.speed([speed, time=0])
         Fix(
             r"\[service_id, key=None, \*, \.\.\.\]", "[service_id], [key], *, ...", is_re=True
         ),  # fix: network - AbstractNIC.connect
@@ -446,9 +435,7 @@ class RSTParser(RSTReader):
     def apply_fix(fix: Fix, params: str, name: str = ""):
         if fix.name and fix.name != name:
             return params
-        return (
-            re.sub(fix.from_, fix.to, params) if fix.is_re else params.replace(fix.from_, fix.to)
-        )
+        return re.sub(fix.from_, fix.to, params) if fix.is_re else params.replace(fix.from_, fix.to)
 
     def create_update_class(self, name: str, params: str, docstr: List[str]):
         # a bit of a hack: assume no classes in classes  or functions in function
@@ -509,12 +496,10 @@ class RSTParser(RSTReader):
             if "nightly" in self.source_tag:
                 version = V_PREVIEW
             else:
-                version = self.source_tag.replace(
-                    "_", "."
-                )  # TODO Use clean_version(self.source_tag)
-            docstr[
-                0
-            ] = f"{docstr[0]}.\n\nMicroPython module: https://docs.micropython.org/en/{version}/library/{module_name}.html"
+                version = self.source_tag.replace("_", ".")  # TODO Use clean_version(self.source_tag)
+            docstr[0] = (
+                f"{docstr[0]}.\n\nMicroPython module: https://docs.micropython.org/en/{version}/library/{module_name}.html"
+            )
 
         self.output_dict.name = module_name
         self.output_dict.add_comment(f"# source version: {self.source_tag}")
@@ -546,9 +531,7 @@ class RSTParser(RSTReader):
 
         for this_function in function_names:
             # Parse return type from docstring
-            ret_type = return_type_from_context(
-                docstring=docstr, signature=this_function, module=self.current_module
-            )
+            ret_type = return_type_from_context(docstring=docstr, signature=this_function, module=self.current_module)
 
             # defaults
             name = params = ""
@@ -663,6 +646,8 @@ class RSTParser(RSTReader):
             #   - staticmethod          (       <params>) -> <ret_type>:
             #   - all other methods     (self,  <params>) -> <ret_type>:
             if name == "__init__":
+                # avoid params starting with `self ,`
+                params = self.lstrip_self(params)
                 method = FunctionSourceDict(
                     name=f"def {name}",
                     indent=parent_class.indent + 4,
@@ -688,6 +673,8 @@ class RSTParser(RSTReader):
                     is_async=is_async,
                 )
             else:  # just plain method
+                # avoid params starting with `self ,`
+                params = self.lstrip_self(params)
                 method = FunctionSourceDict(
                     name=f"def {name}",
                     indent=parent_class.indent + 4,
@@ -695,8 +682,20 @@ class RSTParser(RSTReader):
                     docstr=docstr,
                     is_async=is_async,
                 )
+
             parent_class += method
 
+    def lstrip_self(self, params):
+        """
+        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:]
+        return params
+
     def parse_exception(self):
         log.trace(f"# {self.line.rstrip()}")
         name = self.line.split(SEPERATOR)[1].strip()

stubber/update_module_list.py

@@ -10,10 +10,6 @@ for this :
 - write updates to:
     - board/modulelist.txt
     - board/createstubs.py 
-
-- TODO: remove the frozen modules from this list
-- TODO: bump patch number if there are actual changes
-
 """
 
 from pathlib import Path
@@ -32,7 +28,7 @@ def read_modules(path: Optional[Path] = None) -> Set[str]:
     """
     path = Path(path or "./data")
     assert path
-    all_modules = set()
+    all_modules: Set[str] = set()
     for file in path.glob("*.txt"):
         log.debug(f"processing: {file.name}")
         with file.open("r") as f:
@@ -45,27 +41,7 @@ def read_modules(path: Optional[Path] = None) -> Set[str]:
                     file_mods = [m for m in file_mods if not m.endswith("_test")]
                     all_modules = set(all_modules | set(file_mods))
     log.trace(">" * 40)
-
-    return all_modules
-
-
-# def wrapped(modules: Union[Set, List]) -> str:
-#     "wrap code line at spaces"
-#     long_line = str(modules)
-#     _wrapped = "        self.modules = "
-#     IDENT = len(_wrapped)
-#     MAX_WIDTH = 135
-
-#     # find seperator
-#     while len(long_line) > MAX_WIDTH:
-#         p1 = long_line.find("', ", MAX_WIDTH)
-#         # drop space
-#         p1 += 3
-#         short = long_line[0 : p1 - 1]
-#         _wrapped += short + "\n" + " " * IDENT
-#         long_line = long_line[p1 - 1 :]
-#     _wrapped += long_line
-#     return _wrapped
+    return {m.replace(".", "/") for m in all_modules}
 
 
 def update_module_list():