micropython-stubber 1.23.1.post1__py3-none-any.whl → 1.23.3__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 (149) hide show
  1. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.3.dist-info}/LICENSE +30 -30
  2. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.3.dist-info}/METADATA +5 -5
  3. micropython_stubber-1.23.3.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 +304 -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 +207 -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 +48 -43
  44. mpflash/mpflash/mpremoteboard/__init__.py +266 -266
  45. mpflash/mpflash/mpremoteboard/mpy_fw_info.py +152 -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 +1687 -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 +986 -986
  59. stubber/board/createstubs_db.py +825 -825
  60. stubber/board/createstubs_db_min.py +331 -331
  61. stubber/board/createstubs_lvgl.py +741 -741
  62. stubber/board/createstubs_lvgl_min.py +741 -741
  63. stubber/board/createstubs_mem.py +766 -766
  64. stubber/board/createstubs_mem_min.py +306 -306
  65. stubber/board/createstubs_min.py +294 -294
  66. stubber/board/fw_info.py +141 -141
  67. stubber/board/info.py +183 -183
  68. stubber/board/main.py +19 -19
  69. stubber/board/modulelist.txt +247 -247
  70. stubber/board/pyrightconfig.json +34 -34
  71. stubber/bulk/mcu_stubber.py +437 -437
  72. stubber/codemod/_partials/__init__.py +48 -48
  73. stubber/codemod/_partials/db_main.py +147 -147
  74. stubber/codemod/_partials/lvgl_main.py +77 -77
  75. stubber/codemod/_partials/modules_reader.py +80 -80
  76. stubber/codemod/add_comment.py +53 -53
  77. stubber/codemod/add_method.py +65 -65
  78. stubber/codemod/board.py +317 -317
  79. stubber/codemod/enrich.py +145 -145
  80. stubber/codemod/merge_docstub.py +284 -284
  81. stubber/codemod/modify_list.py +54 -54
  82. stubber/codemod/utils.py +56 -56
  83. stubber/commands/build_cmd.py +94 -94
  84. stubber/commands/cli.py +49 -49
  85. stubber/commands/clone_cmd.py +78 -78
  86. stubber/commands/config_cmd.py +29 -29
  87. stubber/commands/enrich_folder_cmd.py +71 -71
  88. stubber/commands/get_core_cmd.py +71 -71
  89. stubber/commands/get_docstubs_cmd.py +92 -92
  90. stubber/commands/get_frozen_cmd.py +117 -117
  91. stubber/commands/get_mcu_cmd.py +102 -102
  92. stubber/commands/merge_cmd.py +66 -66
  93. stubber/commands/publish_cmd.py +118 -118
  94. stubber/commands/stub_cmd.py +31 -31
  95. stubber/commands/switch_cmd.py +62 -62
  96. stubber/commands/variants_cmd.py +48 -48
  97. stubber/cst_transformer.py +178 -178
  98. stubber/data/board_info.csv +193 -193
  99. stubber/data/board_info.json +1729 -1729
  100. stubber/data/micropython_tags.csv +15 -15
  101. stubber/data/requirements-core-micropython.txt +38 -38
  102. stubber/data/requirements-core-pycopy.txt +39 -39
  103. stubber/downloader.py +37 -37
  104. stubber/freeze/common.py +72 -72
  105. stubber/freeze/freeze_folder.py +69 -69
  106. stubber/freeze/freeze_manifest_2.py +126 -126
  107. stubber/freeze/get_frozen.py +131 -131
  108. stubber/get_cpython.py +112 -112
  109. stubber/get_lobo.py +59 -59
  110. stubber/minify.py +423 -423
  111. stubber/publish/bump.py +86 -86
  112. stubber/publish/candidates.py +275 -275
  113. stubber/publish/database.py +18 -18
  114. stubber/publish/defaults.py +40 -40
  115. stubber/publish/enums.py +24 -24
  116. stubber/publish/helpers.py +29 -29
  117. stubber/publish/merge_docstubs.py +132 -132
  118. stubber/publish/missing_class_methods.py +51 -51
  119. stubber/publish/package.py +150 -150
  120. stubber/publish/pathnames.py +51 -51
  121. stubber/publish/publish.py +120 -120
  122. stubber/publish/pypi.py +42 -42
  123. stubber/publish/stubpackage.py +1051 -1051
  124. stubber/rst/__init__.py +9 -9
  125. stubber/rst/classsort.py +78 -78
  126. stubber/rst/lookup.py +531 -531
  127. stubber/rst/output_dict.py +401 -401
  128. stubber/rst/reader.py +814 -814
  129. stubber/rst/report_return.py +77 -77
  130. stubber/rst/rst_utils.py +541 -541
  131. stubber/stubber.py +38 -38
  132. stubber/stubs_from_docs.py +90 -90
  133. stubber/tools/manifestfile.py +654 -654
  134. stubber/tools/readme.md +6 -6
  135. stubber/update_fallback.py +117 -117
  136. stubber/update_module_list.py +123 -123
  137. stubber/utils/__init__.py +6 -6
  138. stubber/utils/config.py +137 -137
  139. stubber/utils/makeversionhdr.py +54 -54
  140. stubber/utils/manifest.py +90 -90
  141. stubber/utils/post.py +80 -80
  142. stubber/utils/repos.py +156 -156
  143. stubber/utils/stubmaker.py +139 -139
  144. stubber/utils/typed_config_toml.py +80 -80
  145. stubber/variants.py +106 -106
  146. micropython_stubber-1.23.1.post1.dist-info/RECORD +0 -159
  147. mpflash/basicgit.py +0 -288
  148. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.3.dist-info}/WHEEL +0 -0
  149. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.3.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