micropython-stubber 1.20.4__py3-none-any.whl → 1.20.6__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.4.dist-info → micropython_stubber-1.20.6.dist-info}/LICENSE +30 -30
  2. {micropython_stubber-1.20.4.dist-info → micropython_stubber-1.20.6.dist-info}/METADATA +4 -4
  3. micropython_stubber-1.20.6.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 -226
  8. mpflash/mpflash/bootloader/__init__.py +37 -0
  9. mpflash/mpflash/bootloader/manual.py +102 -0
  10. mpflash/mpflash/bootloader/micropython.py +10 -0
  11. mpflash/mpflash/bootloader/touch1200.py +45 -0
  12. mpflash/mpflash/cli_download.py +129 -128
  13. mpflash/mpflash/cli_flash.py +219 -212
  14. mpflash/mpflash/cli_group.py +98 -92
  15. mpflash/mpflash/cli_list.py +81 -77
  16. mpflash/mpflash/cli_main.py +41 -38
  17. mpflash/mpflash/common.py +164 -151
  18. mpflash/mpflash/config.py +47 -31
  19. mpflash/mpflash/connected.py +74 -74
  20. mpflash/mpflash/download.py +360 -361
  21. mpflash/mpflash/downloaded.py +129 -129
  22. mpflash/mpflash/errors.py +9 -5
  23. mpflash/mpflash/flash.py +52 -69
  24. mpflash/mpflash/flash_esp.py +59 -59
  25. mpflash/mpflash/flash_stm32.py +24 -24
  26. mpflash/mpflash/flash_stm32_cube.py +111 -111
  27. mpflash/mpflash/flash_stm32_dfu.py +101 -101
  28. mpflash/mpflash/flash_uf2.py +67 -67
  29. mpflash/mpflash/flash_uf2_boardid.py +15 -15
  30. mpflash/mpflash/flash_uf2_linux.py +123 -123
  31. mpflash/mpflash/flash_uf2_macos.py +34 -37
  32. mpflash/mpflash/flash_uf2_windows.py +34 -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 +221 -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 -0
  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 +170 -170
  51. mpflash/poetry.lock +1588 -1623
  52. mpflash/pyproject.toml +60 -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 -987
  59. stubber/board/createstubs_db.py +825 -826
  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 -767
  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 -455
  75. stubber/codemod/_partials/__init__.py +48 -50
  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 +51 -51
  88. stubber/commands/clone_cmd.py +66 -66
  89. stubber/commands/config_cmd.py +29 -29
  90. stubber/commands/enrich_folder_cmd.py +70 -70
  91. stubber/commands/get_core_cmd.py +69 -69
  92. stubber/commands/get_docstubs_cmd.py +87 -87
  93. stubber/commands/get_frozen_cmd.py +112 -112
  94. stubber/commands/get_mcu_cmd.py +56 -56
  95. stubber/commands/merge_cmd.py +66 -66
  96. stubber/commands/publish_cmd.py +119 -119
  97. stubber/commands/stub_cmd.py +30 -30
  98. stubber/commands/switch_cmd.py +54 -54
  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 +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 -283
  116. stubber/publish/database.py +18 -18
  117. stubber/publish/defaults.py +45 -45
  118. stubber/publish/enums.py +24 -30
  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 -177
  123. stubber/publish/pathnames.py +51 -51
  124. stubber/publish/publish.py +120 -121
  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 -823
  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 +610 -610
  137. stubber/tools/readme.md +5 -5
  138. stubber/update_fallback.py +117 -117
  139. stubber/update_module_list.py +123 -125
  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.4.dist-info/RECORD +0 -154
  151. {micropython_stubber-1.20.4.dist-info → micropython_stubber-1.20.6.dist-info}/WHEEL +0 -0
  152. {micropython_stubber-1.20.4.dist-info → micropython_stubber-1.20.6.dist-info}/entry_points.txt +0 -0
@@ -1,121 +1,120 @@
1
- """
2
- prepare a set of stub files for publishing to PyPi
3
-
4
- !!Note: anything excluded in .gitignore is not packaged by poetry
5
- """
6
-
7
- from typing import Any, Dict, List, Optional, Union
8
-
9
- from loguru import logger as log
10
-
11
- from stubber.publish.candidates import board_candidates, filter_list
12
- from stubber.publish.database import get_database
13
- from stubber.publish.defaults import GENERIC_U
14
- from stubber.publish.enums import COMBO_STUBS
15
- from stubber.publish.package import get_package
16
- from stubber.utils.config import CONFIG
17
- from stubber.utils.versions import V_PREVIEW
18
-
19
-
20
- def build_multiple(
21
- family: str = "micropython",
22
- versions: Optional[List[str]] = None,
23
- ports: Optional[List[str]] = None,
24
- boards: Optional[List[str]] = None,
25
- production: bool = False,
26
- clean: bool = False,
27
- force: bool = False,
28
- ) -> List[Dict[str, Any]]: # sourcery skip: default-mutable-arg
29
- """
30
- Build a bunch of stub packages
31
- """
32
- # default parameter values
33
- versions = versions or [V_PREVIEW]
34
- ports = ports or ["all"]
35
- boards = boards or [GENERIC_U]
36
-
37
- db = get_database(CONFIG.publish_path, production=production)
38
- results: List[Dict[str, Any]] = []
39
- worklist = build_worklist(family, versions, ports, boards)
40
- if len(worklist) == 0:
41
- log.error("Could not find any packages that can be build.")
42
- return results
43
- log.info(f"checking {len(worklist)} possible board candidates")
44
-
45
- for todo in worklist:
46
- if package := get_package(db, **todo):
47
- package.build_distribution(force=force, production=production)
48
- results.append(package.status)
49
- else:
50
- log.error(f"Failed to create package for {todo}")
51
- return results
52
-
53
-
54
- def publish_multiple(
55
- family: str = "micropython",
56
- versions: Optional[List[str]] = None,
57
- ports: Optional[List[str]] = None,
58
- boards: Optional[List[str]] = None,
59
- production: bool = False,
60
- clean: bool = False,
61
- build: bool = False,
62
- force: bool = False,
63
- dry_run: bool = False,
64
- ) -> List[Dict[str, Any]]: # sourcery skip: default-mutable-arg
65
- """
66
- Publish a bunch of stub packages
67
- """
68
- # default parameter values
69
- versions = versions or [V_PREVIEW]
70
- ports = ports or ["all"]
71
- boards = boards or [GENERIC_U]
72
-
73
- db = get_database(CONFIG.publish_path, production=production)
74
- results = []
75
- worklist = build_worklist(family, versions, ports, boards)
76
-
77
- if len(worklist) == 0:
78
- log.error("Could not find any packages than can be published.")
79
- return results
80
-
81
- for todo in worklist:
82
- if package := get_package(db, **todo):
83
- package.publish_distribution_ifchanged(
84
- db=db,
85
- clean=clean,
86
- force=force,
87
- build=build,
88
- production=production,
89
- dry_run=dry_run,
90
- )
91
- results.append(package.status)
92
- else:
93
- log.error(f"Failed to create package for {todo}")
94
- return results
95
-
96
-
97
- def build_worklist(
98
- family: str,
99
- versions: Union[List[str], str],
100
- ports: Union[List[str], str],
101
- boards: Union[List[str], str],
102
- ):
103
- """Build a worklist of packages to build or publish, and filter to only the requested ports and boards"""
104
- if isinstance(versions, str):
105
- versions = [versions]
106
- if isinstance(ports, str):
107
- ports = [ports]
108
- if isinstance(boards, str):
109
- boards = [boards]
110
- if family != "micropython":
111
- return []
112
- # get all the candidates
113
- worklist = list(board_candidates(family=family, versions=versions, pt=COMBO_STUBS))
114
- worklist = filter_list(worklist, ports, boards)
115
-
116
- for b in boards:
117
- if b == "auto":
118
- continue
119
- if not any(i for i in worklist if i["board"].lower() == b.lower()):
120
- log.warning(f"Could not find any package candidate for board {b}")
121
- return worklist
1
+ """
2
+ prepare a set of stub files for publishing to PyPi
3
+
4
+ !!Note: anything excluded in .gitignore is not packaged by poetry
5
+ """
6
+
7
+ from typing import Any, Dict, List, Optional, Union
8
+
9
+ from loguru import logger as log
10
+
11
+ from stubber.publish.candidates import board_candidates, filter_list
12
+ from stubber.publish.database import get_database
13
+ from stubber.publish.defaults import GENERIC_U
14
+ from stubber.publish.package import get_package
15
+ from stubber.utils.config import CONFIG
16
+ from stubber.utils.versions import V_PREVIEW
17
+
18
+
19
+ def build_multiple(
20
+ family: str = "micropython",
21
+ versions: Optional[List[str]] = None,
22
+ ports: Optional[List[str]] = None,
23
+ boards: Optional[List[str]] = None,
24
+ production: bool = False,
25
+ clean: bool = False,
26
+ force: bool = False,
27
+ ) -> List[Dict[str, Any]]: # sourcery skip: default-mutable-arg
28
+ """
29
+ Build a bunch of stub packages
30
+ """
31
+ # default parameter values
32
+ versions = versions or [V_PREVIEW]
33
+ ports = ports or ["all"]
34
+ boards = boards or [GENERIC_U]
35
+
36
+ db = get_database(CONFIG.publish_path, production=production)
37
+ results: List[Dict[str, Any]] = []
38
+ worklist = build_worklist(family, versions, ports, boards)
39
+ if len(worklist) == 0:
40
+ log.error("Could not find any packages that can be build.")
41
+ return results
42
+ log.info(f"checking {len(worklist)} possible board candidates")
43
+
44
+ for todo in worklist:
45
+ if package := get_package(db, **todo):
46
+ package.build_distribution(force=force, production=production)
47
+ results.append(package.status)
48
+ else:
49
+ log.error(f"Failed to create package for {todo}")
50
+ return results
51
+
52
+
53
+ def publish_multiple(
54
+ family: str = "micropython",
55
+ versions: Optional[List[str]] = None,
56
+ ports: Optional[List[str]] = None,
57
+ boards: Optional[List[str]] = None,
58
+ production: bool = False,
59
+ clean: bool = False,
60
+ build: bool = False,
61
+ force: bool = False,
62
+ dry_run: bool = False,
63
+ ) -> List[Dict[str, Any]]: # sourcery skip: default-mutable-arg
64
+ """
65
+ Publish a bunch of stub packages
66
+ """
67
+ # default parameter values
68
+ versions = versions or [V_PREVIEW]
69
+ ports = ports or ["all"]
70
+ boards = boards or [GENERIC_U]
71
+
72
+ db = get_database(CONFIG.publish_path, production=production)
73
+ results = []
74
+ worklist = build_worklist(family, versions, ports, boards)
75
+
76
+ if len(worklist) == 0:
77
+ log.error("Could not find any packages than can be published.")
78
+ return results
79
+
80
+ for todo in worklist:
81
+ if package := get_package(db, **todo):
82
+ package.publish_distribution_ifchanged(
83
+ db=db,
84
+ clean=clean,
85
+ force=force,
86
+ build=build,
87
+ production=production,
88
+ dry_run=dry_run,
89
+ )
90
+ results.append(package.status)
91
+ else:
92
+ log.error(f"Failed to create package for {todo}")
93
+ return results
94
+
95
+
96
+ def build_worklist(
97
+ family: str,
98
+ versions: Union[List[str], str],
99
+ ports: Union[List[str], str],
100
+ boards: Union[List[str], str],
101
+ ):
102
+ """Build a worklist of packages to build or publish, and filter to only the requested ports and boards"""
103
+ if isinstance(versions, str):
104
+ versions = [versions]
105
+ if isinstance(ports, str):
106
+ ports = [ports]
107
+ if isinstance(boards, str):
108
+ boards = [boards]
109
+ if family != "micropython":
110
+ return []
111
+ # get all the candidates
112
+ worklist = list(board_candidates(family=family, versions=versions))
113
+ worklist = filter_list(worklist, ports, boards)
114
+
115
+ for b in boards:
116
+ if b == "auto":
117
+ continue
118
+ if not any(i for i in worklist if i["board"].lower() == b.lower()):
119
+ log.warning(f"Could not find any package candidate for board {b}")
120
+ return worklist
stubber/publish/pypi.py CHANGED
@@ -1,38 +1,38 @@
1
- """
2
- Read versions published to PyPi or test.PyPi.
3
- uses the pypi-simple package to get the versions from the simple index.
4
- """
5
-
6
- from typing import Optional
7
-
8
- from packaging.version import Version, parse
9
- from pypi_simple import PyPISimple, NoSuchProjectError
10
- from loguru import logger as log
11
-
12
-
13
- def get_pypi_versions(package_name: str, base: Optional[Version] = None, production: bool = True):
14
- """Get all versions of a package from a PyPI endpoint."""
15
- package_info = None
16
- if production:
17
- endpoint = "https://pypi.org/simple/"
18
- else:
19
- endpoint = "https://test.pypi.org/simple/"
20
-
21
- try:
22
- with PyPISimple(endpoint=endpoint) as client:
23
- package_info = client.get_project_page(project=package_name)
24
- except NoSuchProjectError:
25
- log.debug(f"Package {package_name} not found on {endpoint}")
26
- return []
27
-
28
- if not package_info:
29
- return []
30
-
31
- versions = [parse(pkg.version) for pkg in package_info.packages if pkg.package_type == "wheel" and pkg.version]
32
- # print(versions)
33
-
34
- if base:
35
- # if base provided then filter
36
- versions = [v for v in versions if v.base_version == base.base_version]
37
-
38
- return sorted(versions)
1
+ """
2
+ Read versions published to PyPi or test.PyPi.
3
+ uses the pypi-simple package to get the versions from the simple index.
4
+ """
5
+
6
+ from typing import Optional
7
+
8
+ from packaging.version import Version, parse
9
+ from pypi_simple import PyPISimple, NoSuchProjectError
10
+ from loguru import logger as log
11
+
12
+
13
+ def get_pypi_versions(package_name: str, base: Optional[Version] = None, production: bool = True):
14
+ """Get all versions of a package from a PyPI endpoint."""
15
+ package_info = None
16
+ if production:
17
+ endpoint = "https://pypi.org/simple/"
18
+ else:
19
+ endpoint = "https://test.pypi.org/simple/"
20
+
21
+ try:
22
+ with PyPISimple(endpoint=endpoint) as client:
23
+ package_info = client.get_project_page(project=package_name)
24
+ except NoSuchProjectError:
25
+ log.debug(f"Package {package_name} not found on {endpoint}")
26
+ return []
27
+
28
+ if not package_info:
29
+ return []
30
+
31
+ versions = [parse(pkg.version) for pkg in package_info.packages if pkg.package_type == "wheel" and pkg.version]
32
+ # print(versions)
33
+
34
+ if base:
35
+ # if base provided then filter
36
+ versions = [v for v in versions if v.base_version == base.base_version]
37
+
38
+ return sorted(versions)