micropython-stubber 1.23.1.post1__py3-none-any.whl → 1.23.2__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.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/LICENSE +30 -30
  2. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/METADATA +4 -4
  3. micropython_stubber-1.23.2.dist-info/RECORD +158 -0
  4. mpflash/README.md +220 -220
  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/basicgit.py +284 -284
  9. mpflash/mpflash/bootloader/__init__.py +2 -2
  10. mpflash/mpflash/bootloader/activate.py +60 -60
  11. mpflash/mpflash/bootloader/detect.py +82 -82
  12. mpflash/mpflash/bootloader/manual.py +101 -101
  13. mpflash/mpflash/bootloader/micropython.py +12 -12
  14. mpflash/mpflash/bootloader/touch1200.py +36 -36
  15. mpflash/mpflash/cli_download.py +129 -129
  16. mpflash/mpflash/cli_flash.py +224 -216
  17. mpflash/mpflash/cli_group.py +111 -111
  18. mpflash/mpflash/cli_list.py +87 -87
  19. mpflash/mpflash/cli_main.py +39 -39
  20. mpflash/mpflash/common.py +210 -166
  21. mpflash/mpflash/config.py +44 -44
  22. mpflash/mpflash/connected.py +96 -77
  23. mpflash/mpflash/download.py +364 -364
  24. mpflash/mpflash/downloaded.py +130 -130
  25. mpflash/mpflash/errors.py +9 -9
  26. mpflash/mpflash/flash/__init__.py +55 -55
  27. mpflash/mpflash/flash/esp.py +59 -59
  28. mpflash/mpflash/flash/stm32.py +19 -19
  29. mpflash/mpflash/flash/stm32_dfu.py +104 -104
  30. mpflash/mpflash/flash/uf2/__init__.py +88 -88
  31. mpflash/mpflash/flash/uf2/boardid.py +15 -15
  32. mpflash/mpflash/flash/uf2/linux.py +136 -130
  33. mpflash/mpflash/flash/uf2/macos.py +42 -42
  34. mpflash/mpflash/flash/uf2/uf2disk.py +12 -12
  35. mpflash/mpflash/flash/uf2/windows.py +43 -43
  36. mpflash/mpflash/flash/worklist.py +170 -170
  37. mpflash/mpflash/list.py +106 -106
  38. mpflash/mpflash/logger.py +41 -41
  39. mpflash/mpflash/mpboard_id/__init__.py +93 -93
  40. mpflash/mpflash/mpboard_id/add_boards.py +251 -251
  41. mpflash/mpflash/mpboard_id/board.py +37 -37
  42. mpflash/mpflash/mpboard_id/board_id.py +86 -86
  43. mpflash/mpflash/mpboard_id/store.py +43 -43
  44. mpflash/mpflash/mpremoteboard/__init__.py +266 -266
  45. mpflash/mpflash/mpremoteboard/mpy_fw_info.py +141 -141
  46. mpflash/mpflash/mpremoteboard/runner.py +140 -140
  47. mpflash/mpflash/vendor/click_aliases.py +91 -91
  48. mpflash/mpflash/vendor/dfu.py +165 -165
  49. mpflash/mpflash/vendor/pydfu.py +605 -605
  50. mpflash/mpflash/vendor/readme.md +2 -2
  51. mpflash/mpflash/versions.py +135 -135
  52. mpflash/poetry.lock +1599 -1599
  53. mpflash/pyproject.toml +65 -65
  54. mpflash/stm32_udev_rules.md +62 -62
  55. stubber/__init__.py +3 -3
  56. stubber/board/board_info.csv +193 -193
  57. stubber/board/boot.py +34 -34
  58. stubber/board/createstubs.py +1004 -986
  59. stubber/board/createstubs_db.py +826 -825
  60. stubber/board/createstubs_db_min.py +332 -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 +767 -766
  65. stubber/board/createstubs_mem_min.py +307 -306
  66. stubber/board/createstubs_mem_mpy.mpy +0 -0
  67. stubber/board/createstubs_min.py +295 -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 +437 -437
  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 +151 -145
  83. stubber/codemod/merge_docstub.py +284 -284
  84. stubber/codemod/modify_list.py +54 -54
  85. stubber/codemod/utils.py +56 -56
  86. stubber/commands/build_cmd.py +94 -94
  87. stubber/commands/cli.py +49 -49
  88. stubber/commands/clone_cmd.py +78 -78
  89. stubber/commands/config_cmd.py +29 -29
  90. stubber/commands/enrich_folder_cmd.py +71 -71
  91. stubber/commands/get_core_cmd.py +71 -71
  92. stubber/commands/get_docstubs_cmd.py +92 -92
  93. stubber/commands/get_frozen_cmd.py +117 -117
  94. stubber/commands/get_mcu_cmd.py +102 -102
  95. stubber/commands/merge_cmd.py +66 -66
  96. stubber/commands/publish_cmd.py +118 -118
  97. stubber/commands/stub_cmd.py +31 -31
  98. stubber/commands/switch_cmd.py +62 -62
  99. stubber/commands/variants_cmd.py +48 -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 +37 -37
  107. stubber/freeze/common.py +72 -72
  108. stubber/freeze/freeze_folder.py +69 -69
  109. stubber/freeze/freeze_manifest_2.py +126 -126
  110. stubber/freeze/get_frozen.py +131 -131
  111. stubber/get_cpython.py +112 -112
  112. stubber/get_lobo.py +59 -59
  113. stubber/minify.py +423 -423
  114. stubber/publish/bump.py +86 -86
  115. stubber/publish/candidates.py +275 -275
  116. stubber/publish/database.py +18 -18
  117. stubber/publish/defaults.py +40 -40
  118. stubber/publish/enums.py +24 -24
  119. stubber/publish/helpers.py +29 -29
  120. stubber/publish/merge_docstubs.py +136 -132
  121. stubber/publish/missing_class_methods.py +51 -51
  122. stubber/publish/package.py +150 -150
  123. stubber/publish/pathnames.py +51 -51
  124. stubber/publish/publish.py +120 -120
  125. stubber/publish/pypi.py +42 -42
  126. stubber/publish/stubpackage.py +1055 -1051
  127. stubber/rst/__init__.py +9 -9
  128. stubber/rst/classsort.py +78 -78
  129. stubber/rst/lookup.py +533 -531
  130. stubber/rst/output_dict.py +401 -401
  131. stubber/rst/reader.py +814 -814
  132. stubber/rst/report_return.py +77 -77
  133. stubber/rst/rst_utils.py +541 -541
  134. stubber/stubber.py +38 -38
  135. stubber/stubs_from_docs.py +90 -90
  136. stubber/tools/manifestfile.py +654 -654
  137. stubber/tools/readme.md +6 -6
  138. stubber/update_fallback.py +117 -117
  139. stubber/update_module_list.py +123 -123
  140. stubber/utils/__init__.py +6 -6
  141. stubber/utils/config.py +137 -137
  142. stubber/utils/makeversionhdr.py +54 -54
  143. stubber/utils/manifest.py +90 -90
  144. stubber/utils/post.py +80 -80
  145. stubber/utils/repos.py +156 -156
  146. stubber/utils/stubmaker.py +139 -139
  147. stubber/utils/typed_config_toml.py +80 -80
  148. stubber/variants.py +106 -106
  149. micropython_stubber-1.23.1.post1.dist-info/RECORD +0 -159
  150. mpflash/basicgit.py +0 -288
  151. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/WHEEL +0 -0
  152. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/entry_points.txt +0 -0
@@ -1,129 +1,129 @@
1
- """CLI to Download MicroPython firmware for specific ports, boards and versions."""
2
-
3
- from pathlib import Path
4
-
5
- import rich_click as click
6
- from loguru import logger as log
7
-
8
- from mpflash.connected import connected_ports_boards
9
- from mpflash.errors import MPFlashError
10
- from mpflash.mpboard_id import find_known_board
11
- from mpflash.versions import clean_version
12
-
13
- from .ask_input import ask_missing_params
14
- from .cli_group import cli
15
- from .common import DownloadParams
16
- from .config import config
17
- from .download import download
18
-
19
-
20
- @cli.command(
21
- "download",
22
- help="Download MicroPython firmware for specific ports, boards and versions.",
23
- )
24
- @click.option(
25
- "--destination",
26
- "-d",
27
- "fw_folder",
28
- type=click.Path(file_okay=False, dir_okay=True, path_type=Path),
29
- default=config.firmware_folder,
30
- show_default=True,
31
- help="The folder to download the firmware to.",
32
- )
33
- @click.option(
34
- "--version",
35
- "-v",
36
- "versions",
37
- default=["stable"],
38
- multiple=True,
39
- show_default=True,
40
- help="The version of MicroPython to to download.",
41
- metavar="SEMVER, 'stable', 'preview' or '?'",
42
- )
43
- @click.option(
44
- "--board",
45
- "-b",
46
- "boards",
47
- multiple=True,
48
- default=[],
49
- show_default=True,
50
- help="The board(s) to download the firmware for.",
51
- metavar="BOARD_ID or ?",
52
- )
53
- @click.option(
54
- "--serial",
55
- "--serial-port",
56
- "-s",
57
- "serial",
58
- default=["*"],
59
- show_default=True,
60
- multiple=True,
61
- help="Which serial port(s) (or globs) to flash",
62
- metavar="SERIALPORT",
63
- )
64
- @click.option(
65
- "--ignore",
66
- "-i",
67
- is_eager=True,
68
- help="Serial port(s) to ignore. Defaults to MPFLASH_IGNORE.",
69
- multiple=True,
70
- default=[],
71
- envvar="MPFLASH_IGNORE",
72
- show_default=True,
73
- metavar="SERIALPORT",
74
- )
75
- @click.option(
76
- "--clean/--no-clean",
77
- default=True,
78
- show_default=True,
79
- help="""Remove dates and hashes from the downloaded firmware filenames.""",
80
- )
81
- @click.option(
82
- "--force",
83
- "-f",
84
- default=False,
85
- is_flag=True,
86
- show_default=True,
87
- help="""Force download of firmware even if it already exists.""",
88
- )
89
- def cli_download(**kwargs) -> int:
90
- params = DownloadParams(**kwargs)
91
- params.versions = list(params.versions)
92
- params.boards = list(params.boards)
93
- params.serial = list(params.serial)
94
- params.ignore = list(params.ignore)
95
-
96
- # all_boards: List[MPRemoteBoard] = []
97
- if params.boards:
98
- if not params.ports:
99
- # no ports specified - resolve ports from specified boards by resolving board IDs
100
- for board in params.boards:
101
- if board != "?":
102
- try:
103
- board_ = find_known_board(board)
104
- params.ports.append(board_.port)
105
- except MPFlashError as e:
106
- log.error(f"{e}")
107
- else:
108
- # no boards specified - detect connected ports and boards
109
- params.ports, params.boards, _ = connected_ports_boards(include=params.serial, ignore=params.ignore)
110
-
111
- params = ask_missing_params(params)
112
- if not params: # Cancelled by user
113
- return 2
114
- params.versions = [clean_version(v, drop_v=True) for v in params.versions]
115
- assert isinstance(params, DownloadParams)
116
-
117
- try:
118
- download(
119
- params.fw_folder,
120
- params.ports,
121
- params.boards,
122
- params.versions,
123
- params.force,
124
- params.clean,
125
- )
126
- return 0
127
- except MPFlashError as e:
128
- log.error(f"{e}")
129
- return 1
1
+ """CLI to Download MicroPython firmware for specific ports, boards and versions."""
2
+
3
+ from pathlib import Path
4
+
5
+ import rich_click as click
6
+ from loguru import logger as log
7
+
8
+ from mpflash.connected import connected_ports_boards
9
+ from mpflash.errors import MPFlashError
10
+ from mpflash.mpboard_id import find_known_board
11
+ from mpflash.versions import clean_version
12
+
13
+ from .ask_input import ask_missing_params
14
+ from .cli_group import cli
15
+ from .common import DownloadParams
16
+ from .config import config
17
+ from .download import download
18
+
19
+
20
+ @cli.command(
21
+ "download",
22
+ help="Download MicroPython firmware for specific ports, boards and versions.",
23
+ )
24
+ @click.option(
25
+ "--destination",
26
+ "-d",
27
+ "fw_folder",
28
+ type=click.Path(file_okay=False, dir_okay=True, path_type=Path),
29
+ default=config.firmware_folder,
30
+ show_default=True,
31
+ help="The folder to download the firmware to.",
32
+ )
33
+ @click.option(
34
+ "--version",
35
+ "-v",
36
+ "versions",
37
+ default=["stable"],
38
+ multiple=True,
39
+ show_default=True,
40
+ help="The version of MicroPython to to download.",
41
+ metavar="SEMVER, 'stable', 'preview' or '?'",
42
+ )
43
+ @click.option(
44
+ "--board",
45
+ "-b",
46
+ "boards",
47
+ multiple=True,
48
+ default=[],
49
+ show_default=True,
50
+ help="The board(s) to download the firmware for.",
51
+ metavar="BOARD_ID or ?",
52
+ )
53
+ @click.option(
54
+ "--serial",
55
+ "--serial-port",
56
+ "-s",
57
+ "serial",
58
+ default=["*"],
59
+ show_default=True,
60
+ multiple=True,
61
+ help="Which serial port(s) (or globs) to flash",
62
+ metavar="SERIALPORT",
63
+ )
64
+ @click.option(
65
+ "--ignore",
66
+ "-i",
67
+ is_eager=True,
68
+ help="Serial port(s) to ignore. Defaults to MPFLASH_IGNORE.",
69
+ multiple=True,
70
+ default=[],
71
+ envvar="MPFLASH_IGNORE",
72
+ show_default=True,
73
+ metavar="SERIALPORT",
74
+ )
75
+ @click.option(
76
+ "--clean/--no-clean",
77
+ default=True,
78
+ show_default=True,
79
+ help="""Remove dates and hashes from the downloaded firmware filenames.""",
80
+ )
81
+ @click.option(
82
+ "--force",
83
+ "-f",
84
+ default=False,
85
+ is_flag=True,
86
+ show_default=True,
87
+ help="""Force download of firmware even if it already exists.""",
88
+ )
89
+ def cli_download(**kwargs) -> int:
90
+ params = DownloadParams(**kwargs)
91
+ params.versions = list(params.versions)
92
+ params.boards = list(params.boards)
93
+ params.serial = list(params.serial)
94
+ params.ignore = list(params.ignore)
95
+
96
+ # all_boards: List[MPRemoteBoard] = []
97
+ if params.boards:
98
+ if not params.ports:
99
+ # no ports specified - resolve ports from specified boards by resolving board IDs
100
+ for board in params.boards:
101
+ if board != "?":
102
+ try:
103
+ board_ = find_known_board(board)
104
+ params.ports.append(board_.port)
105
+ except MPFlashError as e:
106
+ log.error(f"{e}")
107
+ else:
108
+ # no boards specified - detect connected ports and boards
109
+ params.ports, params.boards, _ = connected_ports_boards(include=params.serial, ignore=params.ignore)
110
+
111
+ params = ask_missing_params(params)
112
+ if not params: # Cancelled by user
113
+ return 2
114
+ params.versions = [clean_version(v, drop_v=True) for v in params.versions]
115
+ assert isinstance(params, DownloadParams)
116
+
117
+ try:
118
+ download(
119
+ params.fw_folder,
120
+ params.ports,
121
+ params.boards,
122
+ params.versions,
123
+ params.force,
124
+ params.clean,
125
+ )
126
+ return 0
127
+ except MPFlashError as e:
128
+ log.error(f"{e}")
129
+ return 1