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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.dist-info}/LICENSE +30 -30
  2. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.dist-info}/METADATA +1 -1
  3. micropython_stubber-1.23.0.dist-info/RECORD +159 -0
  4. mpflash/README.md +184 -184
  5. mpflash/libusb_flash.ipynb +203 -203
  6. mpflash/mpflash/add_firmware.py +98 -98
  7. mpflash/mpflash/ask_input.py +236 -236
  8. mpflash/mpflash/bootloader/__init__.py +37 -36
  9. mpflash/mpflash/bootloader/manual.py +102 -102
  10. mpflash/mpflash/bootloader/micropython.py +10 -10
  11. mpflash/mpflash/bootloader/touch1200.py +45 -45
  12. mpflash/mpflash/cli_download.py +129 -129
  13. mpflash/mpflash/cli_flash.py +219 -219
  14. mpflash/mpflash/cli_group.py +98 -98
  15. mpflash/mpflash/cli_list.py +81 -81
  16. mpflash/mpflash/cli_main.py +41 -41
  17. mpflash/mpflash/common.py +164 -164
  18. mpflash/mpflash/config.py +43 -47
  19. mpflash/mpflash/connected.py +74 -74
  20. mpflash/mpflash/download.py +360 -360
  21. mpflash/mpflash/downloaded.py +130 -129
  22. mpflash/mpflash/errors.py +9 -9
  23. mpflash/mpflash/flash.py +55 -52
  24. mpflash/mpflash/flash_esp.py +59 -59
  25. mpflash/mpflash/flash_stm32.py +18 -24
  26. mpflash/mpflash/flash_stm32_cube.py +111 -111
  27. mpflash/mpflash/flash_stm32_dfu.py +104 -101
  28. mpflash/mpflash/flash_uf2.py +89 -67
  29. mpflash/mpflash/flash_uf2_boardid.py +15 -15
  30. mpflash/mpflash/flash_uf2_linux.py +129 -123
  31. mpflash/mpflash/flash_uf2_macos.py +37 -34
  32. mpflash/mpflash/flash_uf2_windows.py +38 -34
  33. mpflash/mpflash/list.py +89 -89
  34. mpflash/mpflash/logger.py +41 -41
  35. mpflash/mpflash/mpboard_id/__init__.py +93 -93
  36. mpflash/mpflash/mpboard_id/add_boards.py +255 -255
  37. mpflash/mpflash/mpboard_id/board.py +37 -37
  38. mpflash/mpflash/mpboard_id/board_id.py +86 -86
  39. mpflash/mpflash/mpboard_id/store.py +43 -43
  40. mpflash/mpflash/mpremoteboard/__init__.py +226 -221
  41. mpflash/mpflash/mpremoteboard/mpy_fw_info.py +141 -141
  42. mpflash/mpflash/mpremoteboard/runner.py +140 -140
  43. mpflash/mpflash/uf2disk.py +12 -12
  44. mpflash/mpflash/vendor/basicgit.py +288 -288
  45. mpflash/mpflash/vendor/click_aliases.py +91 -91
  46. mpflash/mpflash/vendor/dfu.py +165 -165
  47. mpflash/mpflash/vendor/pydfu.py +605 -605
  48. mpflash/mpflash/vendor/readme.md +2 -2
  49. mpflash/mpflash/vendor/versions.py +119 -117
  50. mpflash/mpflash/worklist.py +171 -170
  51. mpflash/poetry.lock +1588 -1588
  52. mpflash/pyproject.toml +64 -60
  53. mpflash/stm32_udev_rules.md +62 -62
  54. stubber/__init__.py +3 -3
  55. stubber/basicgit.py +294 -288
  56. stubber/board/board_info.csv +193 -193
  57. stubber/board/boot.py +34 -34
  58. stubber/board/createstubs.py +986 -986
  59. stubber/board/createstubs_db.py +825 -825
  60. stubber/board/createstubs_db_min.py +331 -331
  61. stubber/board/createstubs_db_mpy.mpy +0 -0
  62. stubber/board/createstubs_lvgl.py +741 -741
  63. stubber/board/createstubs_lvgl_min.py +741 -741
  64. stubber/board/createstubs_mem.py +766 -766
  65. stubber/board/createstubs_mem_min.py +306 -306
  66. stubber/board/createstubs_mem_mpy.mpy +0 -0
  67. stubber/board/createstubs_min.py +294 -294
  68. stubber/board/createstubs_mpy.mpy +0 -0
  69. stubber/board/fw_info.py +141 -141
  70. stubber/board/info.py +183 -183
  71. stubber/board/main.py +19 -19
  72. stubber/board/modulelist.txt +247 -247
  73. stubber/board/pyrightconfig.json +34 -34
  74. stubber/bulk/mcu_stubber.py +454 -454
  75. stubber/codemod/_partials/__init__.py +48 -48
  76. stubber/codemod/_partials/db_main.py +147 -147
  77. stubber/codemod/_partials/lvgl_main.py +77 -77
  78. stubber/codemod/_partials/modules_reader.py +80 -80
  79. stubber/codemod/add_comment.py +53 -53
  80. stubber/codemod/add_method.py +65 -65
  81. stubber/codemod/board.py +317 -317
  82. stubber/codemod/enrich.py +145 -145
  83. stubber/codemod/merge_docstub.py +284 -284
  84. stubber/codemod/modify_list.py +54 -54
  85. stubber/codemod/utils.py +57 -57
  86. stubber/commands/build_cmd.py +94 -94
  87. stubber/commands/cli.py +55 -51
  88. stubber/commands/clone_cmd.py +77 -66
  89. stubber/commands/config_cmd.py +29 -29
  90. stubber/commands/enrich_folder_cmd.py +71 -70
  91. stubber/commands/get_core_cmd.py +71 -69
  92. stubber/commands/get_docstubs_cmd.py +89 -87
  93. stubber/commands/get_frozen_cmd.py +114 -112
  94. stubber/commands/get_mcu_cmd.py +61 -56
  95. stubber/commands/merge_cmd.py +67 -66
  96. stubber/commands/publish_cmd.py +119 -119
  97. stubber/commands/stub_cmd.py +31 -30
  98. stubber/commands/switch_cmd.py +62 -54
  99. stubber/commands/variants_cmd.py +49 -48
  100. stubber/cst_transformer.py +178 -178
  101. stubber/data/board_info.csv +193 -193
  102. stubber/data/board_info.json +1729 -1729
  103. stubber/data/micropython_tags.csv +15 -15
  104. stubber/data/requirements-core-micropython.txt +38 -38
  105. stubber/data/requirements-core-pycopy.txt +39 -39
  106. stubber/downloader.py +36 -36
  107. stubber/freeze/common.py +68 -68
  108. stubber/freeze/freeze_folder.py +69 -69
  109. stubber/freeze/freeze_manifest_2.py +113 -113
  110. stubber/freeze/get_frozen.py +127 -127
  111. stubber/get_cpython.py +101 -101
  112. stubber/get_lobo.py +59 -59
  113. stubber/minify.py +418 -418
  114. stubber/publish/bump.py +86 -86
  115. stubber/publish/candidates.py +262 -262
  116. stubber/publish/database.py +18 -18
  117. stubber/publish/defaults.py +45 -45
  118. stubber/publish/enums.py +24 -24
  119. stubber/publish/helpers.py +29 -29
  120. stubber/publish/merge_docstubs.py +130 -130
  121. stubber/publish/missing_class_methods.py +49 -49
  122. stubber/publish/package.py +146 -146
  123. stubber/publish/pathnames.py +51 -51
  124. stubber/publish/publish.py +120 -120
  125. stubber/publish/pypi.py +38 -38
  126. stubber/publish/stubpackage.py +1029 -1029
  127. stubber/rst/__init__.py +9 -9
  128. stubber/rst/classsort.py +77 -77
  129. stubber/rst/lookup.py +530 -530
  130. stubber/rst/output_dict.py +401 -401
  131. stubber/rst/reader.py +822 -822
  132. stubber/rst/report_return.py +69 -69
  133. stubber/rst/rst_utils.py +540 -540
  134. stubber/stubber.py +38 -38
  135. stubber/stubs_from_docs.py +90 -90
  136. stubber/tools/manifestfile.py +655 -610
  137. stubber/tools/readme.md +7 -6
  138. stubber/update_fallback.py +117 -117
  139. stubber/update_module_list.py +123 -123
  140. stubber/utils/__init__.py +5 -5
  141. stubber/utils/config.py +127 -127
  142. stubber/utils/makeversionhdr.py +54 -54
  143. stubber/utils/manifest.py +92 -92
  144. stubber/utils/post.py +79 -79
  145. stubber/utils/repos.py +157 -154
  146. stubber/utils/stubmaker.py +139 -139
  147. stubber/utils/typed_config_toml.py +77 -77
  148. stubber/utils/versions.py +128 -120
  149. stubber/variants.py +106 -106
  150. micropython_stubber-1.20.5.dist-info/RECORD +0 -159
  151. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.dist-info}/WHEEL +0 -0
  152. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.dist-info}/entry_points.txt +0 -0
stubber/get_cpython.py CHANGED
@@ -1,101 +1,101 @@
1
- """
2
- Download or update the MicroPython compatibility modules from pycopy and stores them in the all_stubs folder
3
- The all_stubs folder should be mapped/symlinked to the micropython_stubs/stubs repo/folder
4
- """
5
- # pragma: no cover
6
- import json
7
- import os
8
- import pkgutil
9
- import shutil
10
- import subprocess
11
- import tempfile
12
- from pathlib import Path
13
- from typing import Optional, Union
14
-
15
- from loguru import logger as log
16
-
17
- from . import __version__
18
-
19
- from . import utils
20
- from .utils.config import CONFIG
21
-
22
- # # log = logging.getLogger(__name__)
23
-
24
-
25
- def get_core(requirements: str, stub_path: Optional[Union[str, Path]] = None, family: str = "core"):
26
- "Download MicroPython compatibility modules"
27
- if not stub_path:
28
- stub_path = CONFIG.stub_path / "cpython-core" # pragma: no cover
29
- stub_path = Path(stub_path)
30
-
31
- # use pip to download requirements file to build folder in one go
32
- # pip install --no-compile --no-cache-dir --target ./scratch/test --upgrade -r ./src/micropython.txt
33
-
34
- os.makedirs(stub_path, exist_ok=True)
35
- # get a temp dir and clean up afterwards
36
- with tempfile.TemporaryDirectory() as tmpdir:
37
- build_path = Path(tmpdir).absolute()
38
- # os.makedirs(build_path, exist_ok=True)
39
- mod_manifest = None
40
- modlist = []
41
-
42
- # within package/mymodule1.py, for example
43
-
44
- data = pkgutil.get_data(__name__, "data/" + requirements)
45
- if not data: # pragma: no cover
46
- raise FileNotFoundError("Resource Not found")
47
- temp_file = tempfile.NamedTemporaryFile(prefix="requirements", suffix=".txt", delete=False)
48
- with temp_file.file as fp:
49
- fp.write(data)
50
- fp.close
51
- #
52
- req_filename = temp_file.name
53
-
54
- try:
55
- subprocess.run(
56
- [
57
- "pip",
58
- "install",
59
- "--target",
60
- build_path.as_posix(),
61
- "-r",
62
- req_filename,
63
- "--no-cache-dir",
64
- "--no-compile",
65
- "--upgrade",
66
- "--no-binary=:all:",
67
- ],
68
- capture_output=False,
69
- check=True,
70
- )
71
-
72
- except OSError as err: # pragma: no cover
73
- log.error(
74
- "An error occurred while trying to run pip to download the MicroPython compatibility modules from PyPi: {}".format(err)
75
- )
76
-
77
- # copy *.py files in build folder to stub_path
78
- # sort by filename to reduce churn in the repo
79
- for filename in sorted(build_path.rglob("*.py")):
80
- log.debug("pipped : {}".format(filename.name))
81
- # f_name, f_ext = os.path.splitext(os.path.basename(filename)) # pylint: disable=unused-variable
82
- modlist.append({"file": filename.name, "module": filename.stem})
83
- try:
84
- shutil.copy2(filename, stub_path)
85
- except OSError as err: # pragma: no cover
86
- log.exception(err)
87
-
88
- # build modules.json
89
- mod_manifest = utils.manifest(family="cpython-core", port=family, version=__version__, stubtype="core", platform="cpython")
90
- mod_manifest["modules"] += modlist
91
-
92
- if mod_manifest and len(modlist):
93
- # write the the module manifest for the cpython core modules
94
- with open(stub_path / "modules.json", "w") as outfile:
95
- json.dump(mod_manifest, outfile, indent=4, sort_keys=True)
96
-
97
-
98
- if __name__ == "__main__":
99
- # just run a quick test
100
- # logging.basicConfig(format="%(levelname)-8s:%(message)s", level=logging.INFO)
101
- get_core(requirements="requirements-core-pycopy.txt", stub_path="./scratch/cpython_common")
1
+ """
2
+ Download or update the MicroPython compatibility modules from pycopy and stores them in the all_stubs folder
3
+ The all_stubs folder should be mapped/symlinked to the micropython_stubs/stubs repo/folder
4
+ """
5
+ # pragma: no cover
6
+ import json
7
+ import os
8
+ import pkgutil
9
+ import shutil
10
+ import subprocess
11
+ import tempfile
12
+ from pathlib import Path
13
+ from typing import Optional, Union
14
+
15
+ from loguru import logger as log
16
+
17
+ from . import __version__
18
+
19
+ from . import utils
20
+ from .utils.config import CONFIG
21
+
22
+ # # log = logging.getLogger(__name__)
23
+
24
+
25
+ def get_core(requirements: str, stub_path: Optional[Union[str, Path]] = None, family: str = "core"):
26
+ "Download MicroPython compatibility modules"
27
+ if not stub_path:
28
+ stub_path = CONFIG.stub_path / "cpython-core" # pragma: no cover
29
+ stub_path = Path(stub_path)
30
+
31
+ # use pip to download requirements file to build folder in one go
32
+ # pip install --no-compile --no-cache-dir --target ./scratch/test --upgrade -r ./src/micropython.txt
33
+
34
+ os.makedirs(stub_path, exist_ok=True)
35
+ # get a temp dir and clean up afterwards
36
+ with tempfile.TemporaryDirectory() as tmpdir:
37
+ build_path = Path(tmpdir).absolute()
38
+ # os.makedirs(build_path, exist_ok=True)
39
+ mod_manifest = None
40
+ modlist = []
41
+
42
+ # within package/mymodule1.py, for example
43
+
44
+ data = pkgutil.get_data(__name__, "data/" + requirements)
45
+ if not data: # pragma: no cover
46
+ raise FileNotFoundError("Resource Not found")
47
+ temp_file = tempfile.NamedTemporaryFile(prefix="requirements", suffix=".txt", delete=False)
48
+ with temp_file.file as fp:
49
+ fp.write(data)
50
+ fp.close
51
+ #
52
+ req_filename = temp_file.name
53
+
54
+ try:
55
+ subprocess.run(
56
+ [
57
+ "pip",
58
+ "install",
59
+ "--target",
60
+ build_path.as_posix(),
61
+ "-r",
62
+ req_filename,
63
+ "--no-cache-dir",
64
+ "--no-compile",
65
+ "--upgrade",
66
+ "--no-binary=:all:",
67
+ ],
68
+ capture_output=False,
69
+ check=True,
70
+ )
71
+
72
+ except OSError as err: # pragma: no cover
73
+ log.error(
74
+ "An error occurred while trying to run pip to download the MicroPython compatibility modules from PyPi: {}".format(err)
75
+ )
76
+
77
+ # copy *.py files in build folder to stub_path
78
+ # sort by filename to reduce churn in the repo
79
+ for filename in sorted(build_path.rglob("*.py")):
80
+ log.debug("pipped : {}".format(filename.name))
81
+ # f_name, f_ext = os.path.splitext(os.path.basename(filename)) # pylint: disable=unused-variable
82
+ modlist.append({"file": filename.name, "module": filename.stem})
83
+ try:
84
+ shutil.copy2(filename, stub_path)
85
+ except OSError as err: # pragma: no cover
86
+ log.exception(err)
87
+
88
+ # build modules.json
89
+ mod_manifest = utils.manifest(family="cpython-core", port=family, version=__version__, stubtype="core", platform="cpython")
90
+ mod_manifest["modules"] += modlist
91
+
92
+ if mod_manifest and len(modlist):
93
+ # write the the module manifest for the cpython core modules
94
+ with open(stub_path / "modules.json", "w") as outfile:
95
+ json.dump(mod_manifest, outfile, indent=4, sort_keys=True)
96
+
97
+
98
+ if __name__ == "__main__":
99
+ # just run a quick test
100
+ # logging.basicConfig(format="%(levelname)-8s:%(message)s", level=logging.INFO)
101
+ get_core(requirements="requirements-core-pycopy.txt", stub_path="./scratch/cpython_common")
stubber/get_lobo.py CHANGED
@@ -1,59 +1,59 @@
1
- #!/usr/bin/env python3
2
- """
3
- Collect modules and python stubs from the Loboris MicroPython source project and stores them in the all_stubs folder
4
- The all_stubs folder should be mapped/symlinked to the micropython_stubs/stubs repo/folder
5
- """
6
-
7
- # pylint: disable= line-too-long
8
- # Copyright (c) 2020 Jos Verlinde
9
- # MIT license
10
- from pathlib import Path
11
- from typing import Optional
12
-
13
- from . import downloader, utils
14
- from .utils.config import CONFIG
15
-
16
- FAMILY = "loboris"
17
- PORT = "esp32_lobo"
18
-
19
-
20
- def get_frozen(stub_path: Optional[Path] = None, *, repo: Optional[str] = None, version: str = "3.2.24"):
21
- "Download Loboris frozen modules direct from github repo"
22
- if stub_path is None:
23
- stub_path = CONFIG.stub_path / "{}-{}-frozen".format(FAMILY, utils.clean_version(version, flat=True))
24
- else:
25
- stub_path = Path(stub_path)
26
-
27
- if not repo:
28
- repo = "https://raw.githubusercontent.com/loboris/MicroPython_ESP32_psRAM_LoBo/master/MicroPython_BUILD/components/micropython/esp32/modules/{}"
29
-
30
- frozen_modules = [
31
- "README.md",
32
- "ak8963.py",
33
- "freesans20.py",
34
- "functools.py",
35
- "logging.py",
36
- "microWebSocket.py",
37
- "microWebSrv.py",
38
- "microWebTemplate.py",
39
- "mpu6500.py",
40
- "mpu9250.py",
41
- "pye.py",
42
- "ssd1306.py",
43
- "tpcalib.py",
44
- # "upip.py",
45
- # "upip_utarfile.py",
46
- # "upysh.py",
47
- "urequests.py",
48
- "writer.py",
49
- ]
50
- # download
51
- downloader.download_files(repo, frozen_modules, stub_path)
52
- # make a manifest
53
- utils.make_manifest(
54
- stub_path,
55
- FAMILY,
56
- port="esp32",
57
- version=version,
58
- stubtype="frozen",
59
- )
1
+ #!/usr/bin/env python3
2
+ """
3
+ Collect modules and python stubs from the Loboris MicroPython source project and stores them in the all_stubs folder
4
+ The all_stubs folder should be mapped/symlinked to the micropython_stubs/stubs repo/folder
5
+ """
6
+
7
+ # pylint: disable= line-too-long
8
+ # Copyright (c) 2020 Jos Verlinde
9
+ # MIT license
10
+ from pathlib import Path
11
+ from typing import Optional
12
+
13
+ from . import downloader, utils
14
+ from .utils.config import CONFIG
15
+
16
+ FAMILY = "loboris"
17
+ PORT = "esp32_lobo"
18
+
19
+
20
+ def get_frozen(stub_path: Optional[Path] = None, *, repo: Optional[str] = None, version: str = "3.2.24"):
21
+ "Download Loboris frozen modules direct from github repo"
22
+ if stub_path is None:
23
+ stub_path = CONFIG.stub_path / "{}-{}-frozen".format(FAMILY, utils.clean_version(version, flat=True))
24
+ else:
25
+ stub_path = Path(stub_path)
26
+
27
+ if not repo:
28
+ repo = "https://raw.githubusercontent.com/loboris/MicroPython_ESP32_psRAM_LoBo/master/MicroPython_BUILD/components/micropython/esp32/modules/{}"
29
+
30
+ frozen_modules = [
31
+ "README.md",
32
+ "ak8963.py",
33
+ "freesans20.py",
34
+ "functools.py",
35
+ "logging.py",
36
+ "microWebSocket.py",
37
+ "microWebSrv.py",
38
+ "microWebTemplate.py",
39
+ "mpu6500.py",
40
+ "mpu9250.py",
41
+ "pye.py",
42
+ "ssd1306.py",
43
+ "tpcalib.py",
44
+ # "upip.py",
45
+ # "upip_utarfile.py",
46
+ # "upysh.py",
47
+ "urequests.py",
48
+ "writer.py",
49
+ ]
50
+ # download
51
+ downloader.download_files(repo, frozen_modules, stub_path)
52
+ # make a manifest
53
+ utils.make_manifest(
54
+ stub_path,
55
+ FAMILY,
56
+ port="esp32",
57
+ version=version,
58
+ stubtype="frozen",
59
+ )