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
stubber/publish/bump.py CHANGED
@@ -1,86 +1,86 @@
1
- """Bump a version number to a next version"""
2
-
3
- from packaging.version import Version, parse
4
-
5
-
6
- def bump_version(
7
- current: Version,
8
- *,
9
- major_bump: bool = False,
10
- minor_bump: bool = False,
11
- micro_bump: bool = False,
12
- version_bump: bool = False, # Increase the first non-zero of micro , minor , major
13
- post_bump: bool = False,
14
- rc: int = 0, # to bump post release, or release candidate number
15
- ) -> Version:
16
- """
17
- Increases a version number
18
-
19
- This allows for a new stub-release to be published while still using the Major.Minor.Patch version numbers of Micropython
20
- if rc = 0(default) : bump post release
21
- format: x.y.z.post1, x.y.z.post2 ...
22
- if rec specified:
23
- drop the post release and set the release candidate number
24
-
25
- ref: https://peps.python.org/pep-0440/
26
- """
27
- release_bump = major_bump or minor_bump or micro_bump or version_bump
28
- other_bump = post_bump or rc != 0
29
-
30
- if release_bump and other_bump:
31
- raise ValueError("Cannot bump both release and other fragments")
32
-
33
- parts = []
34
-
35
- # ----------------------------------------------------------------------
36
- # Epoch
37
- if current.epoch != 0:
38
- parts.append(f"{current.epoch}!")
39
- # ----------------------------------------------------------------------
40
- # Release segment: major.minor.micro x.y.z
41
- major = current.major
42
- minor = current.minor
43
- micro = current.micro
44
- if version_bump: # Increase the first non-zero of micro , minor , major
45
- if micro != 0:
46
- micro_bump = True
47
- elif minor != 0:
48
- minor_bump = True
49
- elif major != 0:
50
- major_bump = True
51
- else:
52
- raise ValueError("Cannot bump version, all version numbers are zero")
53
-
54
- # higher level bump clears lowers
55
- major = major + 1 if major_bump else major
56
- minor = 0 if major_bump else minor + 1 if minor_bump else minor
57
- micro = 0 if minor_bump or major_bump else micro + 1 if micro_bump else micro
58
-
59
- release = f"{major}.{minor}.{micro}"
60
- parts.append(release)
61
- if not release_bump:
62
- # ----------------------------------------------------------------------
63
- # pre
64
- if rc != 0:
65
- # Pre-release / alpha / beta / rc segment
66
- parts.append(f".a{rc}")
67
- # ----------------------------------------------------------------------
68
- # post
69
- elif post_bump :
70
- parts.append(".post1" if current.post is None else f".post{current.post + 1}")
71
- # ----------------------------------------------------------------------
72
- # Development release
73
- if current.dev is not None:
74
- parts.append(f".dev{current.dev}")
75
-
76
- # ----------------------------------------------------------------------
77
- # Local version segment
78
- if current.local is not None:
79
- parts.append(f"+{current.local}")
80
- try:
81
- # Sanity check that the new version is valid
82
- new = parse("".join(parts))
83
- except ValueError as e:
84
- raise ValueError(f"{''.join(parts)} is not a valid version") from e
85
- assert isinstance(new, Version), "not a valid Version"
86
- return new
1
+ """Bump a version number to a next version"""
2
+
3
+ from packaging.version import Version, parse
4
+
5
+
6
+ def bump_version(
7
+ current: Version,
8
+ *,
9
+ major_bump: bool = False,
10
+ minor_bump: bool = False,
11
+ micro_bump: bool = False,
12
+ version_bump: bool = False, # Increase the first non-zero of micro , minor , major
13
+ post_bump: bool = False,
14
+ rc: int = 0, # to bump post release, or release candidate number
15
+ ) -> Version:
16
+ """
17
+ Increases a version number
18
+
19
+ This allows for a new stub-release to be published while still using the Major.Minor.Patch version numbers of Micropython
20
+ if rc = 0(default) : bump post release
21
+ format: x.y.z.post1, x.y.z.post2 ...
22
+ if rec specified:
23
+ drop the post release and set the release candidate number
24
+
25
+ ref: https://peps.python.org/pep-0440/
26
+ """
27
+ release_bump = major_bump or minor_bump or micro_bump or version_bump
28
+ other_bump = post_bump or rc != 0
29
+
30
+ if release_bump and other_bump:
31
+ raise ValueError("Cannot bump both release and other fragments")
32
+
33
+ parts = []
34
+
35
+ # ----------------------------------------------------------------------
36
+ # Epoch
37
+ if current.epoch != 0:
38
+ parts.append(f"{current.epoch}!")
39
+ # ----------------------------------------------------------------------
40
+ # Release segment: major.minor.micro x.y.z
41
+ major = current.major
42
+ minor = current.minor
43
+ micro = current.micro
44
+ if version_bump: # Increase the first non-zero of micro , minor , major
45
+ if micro != 0:
46
+ micro_bump = True
47
+ elif minor != 0:
48
+ minor_bump = True
49
+ elif major != 0:
50
+ major_bump = True
51
+ else:
52
+ raise ValueError("Cannot bump version, all version numbers are zero")
53
+
54
+ # higher level bump clears lowers
55
+ major = major + 1 if major_bump else major
56
+ minor = 0 if major_bump else minor + 1 if minor_bump else minor
57
+ micro = 0 if minor_bump or major_bump else micro + 1 if micro_bump else micro
58
+
59
+ release = f"{major}.{minor}.{micro}"
60
+ parts.append(release)
61
+ if not release_bump:
62
+ # ----------------------------------------------------------------------
63
+ # pre
64
+ if rc != 0:
65
+ # Pre-release / alpha / beta / rc segment
66
+ parts.append(f".a{rc}")
67
+ # ----------------------------------------------------------------------
68
+ # post
69
+ elif post_bump :
70
+ parts.append(".post1" if current.post is None else f".post{current.post + 1}")
71
+ # ----------------------------------------------------------------------
72
+ # Development release
73
+ if current.dev is not None:
74
+ parts.append(f".dev{current.dev}")
75
+
76
+ # ----------------------------------------------------------------------
77
+ # Local version segment
78
+ if current.local is not None:
79
+ parts.append(f"+{current.local}")
80
+ try:
81
+ # Sanity check that the new version is valid
82
+ new = parse("".join(parts))
83
+ except ValueError as e:
84
+ raise ValueError(f"{''.join(parts)} is not a valid version") from e
85
+ assert isinstance(new, Version), "not a valid Version"
86
+ return new