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,332 +1,332 @@
1
- A2='No report file'
2
- A1='Failed to create the report.'
3
- A0='method'
4
- z='function'
5
- y='bool'
6
- x='str'
7
- w='float'
8
- v='int'
9
- u='micropython'
10
- t='stubber'
11
- s=Exception
12
- r=KeyError
13
- q=sorted
14
- p=MemoryError
15
- o=NotImplementedError
16
- k=',\n'
17
- j='modules.json'
18
- i='{}/{}'
19
- h='w'
20
- g='dict'
21
- f='list'
22
- e='tuple'
23
- d=TypeError
24
- c=str
25
- b=repr
26
- W='-preview'
27
- V='-'
28
- U='board'
29
- T=IndexError
30
- S=print
31
- R=True
32
- Q='family'
33
- P=len
34
- O=ImportError
35
- N=dir
36
- M=open
37
- K='port'
38
- J='.'
39
- I=AttributeError
40
- H=False
41
- G='/'
42
- E=None
43
- D=OSError
44
- C='version'
45
- B=''
46
- import gc as F,os,sys
47
- from time import sleep
48
- try:from ujson import dumps
49
- except:from json import dumps
50
- try:from machine import reset
51
- except O:pass
52
- try:from collections import OrderedDict as l
53
- except O:from ucollections import OrderedDict as l
54
- __version__='v1.23.1'
55
- A3=2
56
- A4=2
57
- A5=['lib','/lib','/sd/lib','/flash/lib',J]
58
- class L:
59
- INFO=20;WARNING=30;ERROR=40;level=INFO;prnt=S
60
- @staticmethod
61
- def getLogger(name):return L()
62
- @classmethod
63
- def basicConfig(A,level):A.level=level
64
- def info(A,msg):
65
- if A.level<=L.INFO:A.prnt('INFO :',msg)
66
- def warning(A,msg):
67
- if A.level<=L.WARNING:A.prnt('WARN :',msg)
68
- def error(A,msg):
69
- if A.level<=L.ERROR:A.prnt('ERROR :',msg)
70
- A=L.getLogger(t)
71
- L.basicConfig(level=L.INFO)
72
- class Stubber:
73
- def __init__(B,path=E,firmware_id=E):
74
- C=firmware_id
75
- try:
76
- if os.uname().release=='1.13.0'and os.uname().version<'v1.13-103':raise o('MicroPython 1.13.0 cannot be stubbed')
77
- except I:pass
78
- B.info=_info();A.info('Port: {}'.format(B.info[K]));A.info('Board: {}'.format(B.info[U]));F.collect()
79
- if C:B._fwid=C.lower()
80
- elif B.info[Q]==u:B._fwid='{family}-v{version}-{port}-{board}'.format(**B.info).rstrip(V)
81
- else:B._fwid='{family}-v{version}-{port}'.format(**B.info)
82
- B._start_free=F.mem_free()
83
- if path:
84
- if path.endswith(G):path=path[:-1]
85
- else:path=get_root()
86
- B.path='{}/stubs/{}'.format(path,B.flat_fwid).replace('//',G)
87
- try:X(path+G)
88
- except D:A.error('error creating stub folder {}'.format(path))
89
- B.problematic=['upip','upysh','webrepl_setup','http_client','http_client_ssl','http_server','http_server_ssl'];B.excluded=['webrepl','_webrepl','port_diag','example_sub_led.py','example_pub_button.py'];B.modules=[];B._json_name=E;B._json_first=H
90
- def get_obj_attributes(L,item_instance):
91
- H=item_instance;C=[];K=[]
92
- for A in N(H):
93
- if A.startswith('__')and not A in L.modules:continue
94
- try:
95
- D=getattr(H,A)
96
- try:E=b(type(D)).split("'")[1]
97
- except T:E=B
98
- if E in{v,w,x,y,e,f,g}:G=1
99
- elif E in{z,A0}:G=2
100
- elif E in'class':G=3
101
- else:G=4
102
- C.append((A,b(D),b(type(D)),D,G))
103
- except I as J:K.append("Couldn't get attribute '{}' from object '{}', Err: {}".format(A,H,J))
104
- except p as J:S('MemoryError: {}'.format(J));sleep(1);reset()
105
- C=q([A for A in C if not A[0].startswith('__')],key=lambda x:x[4]);F.collect();return C,K
106
- def add_modules(A,modules):A.modules=q(set(A.modules)|set(modules))
107
- def create_all_stubs(B):
108
- A.info('Start micropython-stubber {} on {}'.format(__version__,B._fwid));B.report_start();F.collect()
109
- for C in B.modules:B.create_one_stub(C)
110
- B.report_end();A.info('Finally done')
111
- def create_one_stub(C,module_name):
112
- B=module_name
113
- if B in C.problematic:A.warning('Skip module: {:<25} : Known problematic'.format(B));return H
114
- if B in C.excluded:A.warning('Skip module: {:<25} : Excluded'.format(B));return H
115
- I='{}/{}.pyi'.format(C.path,B.replace(J,G));F.collect();E=H
116
- try:E=C.create_module_stub(B,I)
117
- except D:return H
118
- F.collect();return E
119
- def create_module_stub(K,module_name,file_name=E):
120
- I=file_name;C=module_name
121
- if I is E:L=C.replace(J,'_')+'.pyi';I=K.path+G+L
122
- else:L=I.split(G)[-1]
123
- if G in C:C=C.replace(G,J)
124
- N=E
125
- try:N=__import__(C,E,E,'*');Q=F.mem_free();A.info('Stub module: {:<25} to file: {:<70} mem:{:>5}'.format(C,L,Q))
126
- except O:return H
127
- X(I)
128
- with M(I,h)as P:S=c(K.info).replace('OrderedDict(',B).replace('})','}');T='"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(C,K._fwid,S,__version__);P.write(T);P.write('from __future__ import annotations\nfrom typing import Any, Generator\nfrom _typeshed import Incomplete\n\n');K.write_object_stub(P,N,C,B)
129
- K.report_add(C,I)
130
- if C not in{'os','sys','logging','gc'}:
131
- try:del N
132
- except(D,r):A.warning('could not del new_module')
133
- F.collect();return R
134
- def write_object_stub(L,fp,object_expr,obj_name,indent,in_class=0):
135
- Z=' at ...>';Y='generator';X='{0}{1}: {3} = {2}\n';W='bound_method';V='Incomplete';O=in_class;N='Exception';M=object_expr;K=' at ';J=fp;D=indent;F.collect()
136
- if M in L.problematic:A.warning('SKIPPING problematic module:{}'.format(M));return
137
- a,Q=L.get_obj_attributes(M)
138
- if Q:A.error(Q)
139
- for(E,H,I,b,d)in a:
140
- if E in['classmethod','staticmethod','BaseException',N]:continue
141
- if E[0].isdigit():A.warning('NameError: invalid name {}'.format(E));continue
142
- if I=="<class 'type'>"and P(D)<=A4*4:
143
- R=B;S=E.endswith(N)or E.endswith('Error')or E in['KeyboardInterrupt','StopIteration','SystemExit']
144
- if S:R=N
145
- C='\n{}class {}({}):\n'.format(D,E,R)
146
- if S:C+=D+' ...\n';J.write(C);continue
147
- J.write(C);L.write_object_stub(J,b,'{0}.{1}'.format(obj_name,E),D+' ',O+1);C=D+' def __init__(self, *argv, **kwargs) -> None:\n';C+=D+' ...\n\n';J.write(C)
148
- elif any(A in I for A in[A0,z,'closure']):
149
- T=V;U=B
150
- if O>0:U='self, '
151
- if W in I or W in H:C='{}@classmethod\n'.format(D)+'{}def {}(cls, *args, **kwargs) -> {}:\n'.format(D,E,T)
152
- else:C='{}def {}({}*args, **kwargs) -> {}:\n'.format(D,E,U,T)
153
- C+=D+' ...\n\n';J.write(C)
154
- elif I=="<class 'module'>":0
155
- elif I.startswith("<class '"):
156
- G=I[8:-2];C=B
157
- if G in(x,v,w,y,'bytearray','bytes'):C=X.format(D,E,H,G)
158
- elif G in(g,f,e):c={g:'{}',f:'[]',e:'()'};C=X.format(D,E,c[G],G)
159
- elif G in('object','set','frozenset','Pin',Y):
160
- if G==Y:G='Generator'
161
- C='{0}{1}: {2} ## = {4}\n'.format(D,E,G,I,H)
162
- else:
163
- G=V
164
- if K in H:H=H.split(K)[0]+Z
165
- if K in H:H=H.split(K)[0]+Z
166
- C='{0}{1}: {2} ## {3} = {4}\n'.format(D,E,G,I,H)
167
- J.write(C)
168
- else:J.write("# all other, type = '{0}'\n".format(I));J.write(D+E+' # type: Incomplete\n')
169
- @property
170
- def flat_fwid(self):
171
- A=self._fwid;B=' .()/\\:$'
172
- for C in B:A=A.replace(C,'_')
173
- return A
174
- def clean(C,path=E):
175
- if path is E:path=C.path
176
- A.info('Clean/remove files in folder: {}'.format(path))
177
- try:os.stat(path);F=os.listdir(path)
178
- except(D,I):return
179
- for G in F:
180
- B=i.format(path,G)
181
- try:os.remove(B)
182
- except D:
183
- try:C.clean(B);os.rmdir(B)
184
- except D:pass
185
- def report_start(B,filename=j):
186
- H='firmware';B._json_name=i.format(B.path,filename);B._json_first=R;X(B._json_name);A.info('Report file: {}'.format(B._json_name));F.collect()
187
- try:
188
- with M(B._json_name,h)as G:G.write('{');G.write(dumps({H:B.info})[1:-1]);G.write(k);G.write(dumps({t:{C:__version__},'stubtype':H})[1:-1]);G.write(k);G.write('"modules" :[\n')
189
- except D as I:A.error(A1);B._json_name=E;raise I
190
- def report_add(B,module_name,stub_file):
191
- if not B._json_name:raise s(A2)
192
- try:
193
- with M(B._json_name,'a')as C:
194
- if not B._json_first:C.write(k)
195
- else:B._json_first=H
196
- E='{{"module": "{}", "file": "{}"}}'.format(module_name,stub_file.replace('\\',G));C.write(E)
197
- except D:A.error(A1)
198
- def report_end(B):
199
- if not B._json_name:raise s(A2)
200
- with M(B._json_name,'a')as C:C.write('\n]}')
201
- A.info('Path: {}'.format(B.path))
202
- def X(path):
203
- B=E=0
204
- while B!=-1:
205
- B=path.find(G,E)
206
- if B!=-1:
207
- C=path[0]if B==0 else path[:B]
208
- try:I=os.stat(C)
209
- except D as F:
210
- if F.args[0]==A3:
211
- try:os.mkdir(C)
212
- except D as H:A.error('failed to create folder {}'.format(C));raise H
213
- E=B+1
214
- def Y(s):
215
- C=' on '
216
- if not s:return B
217
- s=s.split(C,1)[0]if C in s else s
218
- if s.startswith('v'):
219
- if not V in s:return B
220
- A=s.split(V)[1];return A
221
- if not W in s:return B
222
- A=s.split(W)[1].split(J)[1];return A
223
- def _info():
224
- a='ev3-pybricks';Z='pycom';X='pycopy';V='unix';S='win32';R='arch';P='cpu';M='ver';F='mpy';D='build'
225
- try:H=sys.implementation[0]
226
- except d:H=sys.implementation.name
227
- A=l({Q:H,C:B,D:B,M:B,K:sys.platform,U:'UNKNOWN',P:B,F:B,R:B})
228
- if A[K].startswith('pyb'):A[K]='stm32'
229
- elif A[K]==S:A[K]='windows'
230
- elif A[K]=='linux':A[K]=V
231
- try:A[C]=A6(sys.implementation.version)
232
- except I:pass
233
- try:J=sys.implementation._machine if'_machine'in N(sys.implementation)else os.uname().machine;A[U]=J;A[P]=J.split('with')[-1].strip();A[F]=sys.implementation._mpy if'_mpy'in N(sys.implementation)else sys.implementation.mpy if F in N(sys.implementation)else B
234
- except(I,T):pass
235
- A[U]=A7()
236
- try:
237
- if'uname'in N(os):
238
- A[D]=Y(os.uname()[3])
239
- if not A[D]:A[D]=Y(os.uname()[2])
240
- elif C in N(sys):A[D]=Y(sys.version)
241
- except(I,T,d):pass
242
- if A[C]==B and sys.platform not in(V,S):
243
- try:b=os.uname();A[C]=b.release
244
- except(T,I,d):pass
245
- for(c,e,f)in[(X,X,'const'),(Z,Z,'FAT'),(a,'pybricks.hubs','EV3Brick')]:
246
- try:g=__import__(e,E,E,f);A[Q]=c;del g;break
247
- except(O,r):pass
248
- if A[Q]==a:A['release']='2.0.0'
249
- if A[Q]==u:
250
- A[C]
251
- if A[C]and A[C].endswith('.0')and A[C]>='1.10.0'and A[C]<='1.19.9':A[C]=A[C][:-2]
252
- if F in A and A[F]:
253
- G=int(A[F]);L=[E,'x86','x64','armv6','armv6m','armv7m','armv7em','armv7emsp','armv7emdp','xtensa','xtensawin'][G>>10]
254
- if L:A[R]=L
255
- A[F]='v{}.{}'.format(G&255,G>>8&3)
256
- if A[D]and not A[C].endswith(W):A[C]=A[C]+W
257
- A[M]=f"{A[C]}-{A[D]}"if A[D]else f"{A[C]}";return A
258
- def A6(version):
259
- A=version;B=J.join([c(A)for A in A[:3]])
260
- if P(A)>3 and A[3]:B+=V+A[3]
261
- return B
262
- def A7():
263
- try:from boardname import BOARDNAME as C;A.info('Found BOARDNAME: {}'.format(C))
264
- except O:A.warning('BOARDNAME not found');C=B
265
- return C
266
- def get_root():
267
- try:A=os.getcwd()
268
- except(D,I):A=J
269
- B=A
270
- for B in[A,'/sd','/flash',G,J]:
271
- try:C=os.stat(B);break
272
- except D:continue
273
- return B
274
- def Z(filename):
275
- try:
276
- if os.stat(filename)[0]>>14:return R
277
- return H
278
- except D:return H
279
- def m():S("-p, --path path to store the stubs in, defaults to '.'");sys.exit(1)
280
- def read_path():
281
- path=B
282
- if P(sys.argv)==3:
283
- A=sys.argv[1].lower()
284
- if A in('--path','-p'):path=sys.argv[2]
285
- else:m()
286
- elif P(sys.argv)==2:m()
287
- return path
288
- def n():
289
- try:A=bytes('abc',encoding='utf8');B=n.__module__;return H
290
- except(o,I):return R
291
- a='modulelist.done'
292
- def A8(skip=0):
293
- for E in A5:
294
- B=E+'/modulelist.txt'
295
- if not Z(B):continue
296
- try:
297
- with M(B)as F:
298
- C=0
299
- while R:
300
- A=F.readline().strip()
301
- if not A:break
302
- if P(A)>0 and A[0]=='#':continue
303
- C+=1
304
- if C<skip:continue
305
- yield A
306
- break
307
- except D:pass
308
- def A9(done):
309
- with M(a,h)as A:A.write(c(done)+'\n')
310
- def AA():
311
- A=0
312
- try:
313
- with M(a)as B:A=int(B.readline().strip())
314
- except D:pass
315
- return A
316
- def main():
317
- import machine as D;C=Z(a)
318
- if C:A.info('Continue from last run')
319
- else:A.info('Starting new run')
320
- stubber=Stubber(path=read_path());B=0
321
- if not C:stubber.clean();stubber.report_start(j)
322
- else:B=AA();stubber._json_name=i.format(stubber.path,j)
323
- for E in A8(B):
324
- try:stubber.create_one_stub(E)
325
- except p:D.reset()
326
- F.collect();B+=1;A9(B)
327
- S('All modules have been processed, Finalizing report');stubber.report_end()
328
- if __name__=='__main__'or n():
329
- if not Z('no_auto_stubber.txt'):
330
- try:F.threshold(4*1024);F.enable()
331
- except BaseException:pass
1
+ A2='No report file'
2
+ A1='Failed to create the report.'
3
+ A0='method'
4
+ z='function'
5
+ y='bool'
6
+ x='str'
7
+ w='float'
8
+ v='int'
9
+ u='micropython'
10
+ t='stubber'
11
+ s=Exception
12
+ r=KeyError
13
+ q=sorted
14
+ p=MemoryError
15
+ o=NotImplementedError
16
+ k=',\n'
17
+ j='modules.json'
18
+ i='{}/{}'
19
+ h='w'
20
+ g='dict'
21
+ f='list'
22
+ e='tuple'
23
+ d=TypeError
24
+ c=str
25
+ b=repr
26
+ W='-preview'
27
+ V='-'
28
+ U='board'
29
+ T=IndexError
30
+ S=print
31
+ R=True
32
+ Q='family'
33
+ P=len
34
+ O=ImportError
35
+ N=dir
36
+ M=open
37
+ K='port'
38
+ J='.'
39
+ I=AttributeError
40
+ H=False
41
+ G='/'
42
+ E=None
43
+ D=OSError
44
+ C='version'
45
+ B=''
46
+ import gc as F,os,sys
47
+ from time import sleep
48
+ try:from ujson import dumps
49
+ except:from json import dumps
50
+ try:from machine import reset
51
+ except O:pass
52
+ try:from collections import OrderedDict as l
53
+ except O:from ucollections import OrderedDict as l
54
+ __version__='v1.23.3'
55
+ A3=2
56
+ A4=2
57
+ A5=['lib','/lib','/sd/lib','/flash/lib',J]
58
+ class L:
59
+ INFO=20;WARNING=30;ERROR=40;level=INFO;prnt=S
60
+ @staticmethod
61
+ def getLogger(name):return L()
62
+ @classmethod
63
+ def basicConfig(A,level):A.level=level
64
+ def info(A,msg):
65
+ if A.level<=L.INFO:A.prnt('INFO :',msg)
66
+ def warning(A,msg):
67
+ if A.level<=L.WARNING:A.prnt('WARN :',msg)
68
+ def error(A,msg):
69
+ if A.level<=L.ERROR:A.prnt('ERROR :',msg)
70
+ A=L.getLogger(t)
71
+ L.basicConfig(level=L.INFO)
72
+ class Stubber:
73
+ def __init__(B,path=E,firmware_id=E):
74
+ C=firmware_id
75
+ try:
76
+ if os.uname().release=='1.13.0'and os.uname().version<'v1.13-103':raise o('MicroPython 1.13.0 cannot be stubbed')
77
+ except I:pass
78
+ B.info=_info();A.info('Port: {}'.format(B.info[K]));A.info('Board: {}'.format(B.info[U]));F.collect()
79
+ if C:B._fwid=C.lower()
80
+ elif B.info[Q]==u:B._fwid='{family}-v{version}-{port}-{board}'.format(**B.info).rstrip(V)
81
+ else:B._fwid='{family}-v{version}-{port}'.format(**B.info)
82
+ B._start_free=F.mem_free()
83
+ if path:
84
+ if path.endswith(G):path=path[:-1]
85
+ else:path=get_root()
86
+ B.path='{}/stubs/{}'.format(path,B.flat_fwid).replace('//',G)
87
+ try:X(path+G)
88
+ except D:A.error('error creating stub folder {}'.format(path))
89
+ B.problematic=['upip','upysh','webrepl_setup','http_client','http_client_ssl','http_server','http_server_ssl'];B.excluded=['webrepl','_webrepl','port_diag','example_sub_led.py','example_pub_button.py'];B.modules=[];B._json_name=E;B._json_first=H
90
+ def get_obj_attributes(L,item_instance):
91
+ H=item_instance;C=[];K=[]
92
+ for A in N(H):
93
+ if A.startswith('__')and not A in L.modules:continue
94
+ try:
95
+ D=getattr(H,A)
96
+ try:E=b(type(D)).split("'")[1]
97
+ except T:E=B
98
+ if E in{v,w,x,y,e,f,g}:G=1
99
+ elif E in{z,A0}:G=2
100
+ elif E in'class':G=3
101
+ else:G=4
102
+ C.append((A,b(D),b(type(D)),D,G))
103
+ except I as J:K.append("Couldn't get attribute '{}' from object '{}', Err: {}".format(A,H,J))
104
+ except p as J:S('MemoryError: {}'.format(J));sleep(1);reset()
105
+ C=q([A for A in C if not A[0].startswith('__')],key=lambda x:x[4]);F.collect();return C,K
106
+ def add_modules(A,modules):A.modules=q(set(A.modules)|set(modules))
107
+ def create_all_stubs(B):
108
+ A.info('Start micropython-stubber {} on {}'.format(__version__,B._fwid));B.report_start();F.collect()
109
+ for C in B.modules:B.create_one_stub(C)
110
+ B.report_end();A.info('Finally done')
111
+ def create_one_stub(C,module_name):
112
+ B=module_name
113
+ if B in C.problematic:A.warning('Skip module: {:<25} : Known problematic'.format(B));return H
114
+ if B in C.excluded:A.warning('Skip module: {:<25} : Excluded'.format(B));return H
115
+ I='{}/{}.pyi'.format(C.path,B.replace(J,G));F.collect();E=H
116
+ try:E=C.create_module_stub(B,I)
117
+ except D:return H
118
+ F.collect();return E
119
+ def create_module_stub(K,module_name,file_name=E):
120
+ I=file_name;C=module_name
121
+ if I is E:L=C.replace(J,'_')+'.pyi';I=K.path+G+L
122
+ else:L=I.split(G)[-1]
123
+ if G in C:C=C.replace(G,J)
124
+ N=E
125
+ try:N=__import__(C,E,E,'*');Q=F.mem_free();A.info('Stub module: {:<25} to file: {:<70} mem:{:>5}'.format(C,L,Q))
126
+ except O:return H
127
+ X(I)
128
+ with M(I,h)as P:S=c(K.info).replace('OrderedDict(',B).replace('})','}');T='"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(C,K._fwid,S,__version__);P.write(T);P.write('from __future__ import annotations\nfrom typing import Any, Generator\nfrom _typeshed import Incomplete\n\n');K.write_object_stub(P,N,C,B)
129
+ K.report_add(C,I)
130
+ if C not in{'os','sys','logging','gc'}:
131
+ try:del N
132
+ except(D,r):A.warning('could not del new_module')
133
+ F.collect();return R
134
+ def write_object_stub(L,fp,object_expr,obj_name,indent,in_class=0):
135
+ Z=' at ...>';Y='generator';X='{0}{1}: {3} = {2}\n';W='bound_method';V='Incomplete';O=in_class;N='Exception';M=object_expr;K=' at ';J=fp;D=indent;F.collect()
136
+ if M in L.problematic:A.warning('SKIPPING problematic module:{}'.format(M));return
137
+ a,Q=L.get_obj_attributes(M)
138
+ if Q:A.error(Q)
139
+ for(E,H,I,b,d)in a:
140
+ if E in['classmethod','staticmethod','BaseException',N]:continue
141
+ if E[0].isdigit():A.warning('NameError: invalid name {}'.format(E));continue
142
+ if I=="<class 'type'>"and P(D)<=A4*4:
143
+ R=B;S=E.endswith(N)or E.endswith('Error')or E in['KeyboardInterrupt','StopIteration','SystemExit']
144
+ if S:R=N
145
+ C='\n{}class {}({}):\n'.format(D,E,R)
146
+ if S:C+=D+' ...\n';J.write(C);continue
147
+ J.write(C);L.write_object_stub(J,b,'{0}.{1}'.format(obj_name,E),D+' ',O+1);C=D+' def __init__(self, *argv, **kwargs) -> None:\n';C+=D+' ...\n\n';J.write(C)
148
+ elif any(A in I for A in[A0,z,'closure']):
149
+ T=V;U=B
150
+ if O>0:U='self, '
151
+ if W in I or W in H:C='{}@classmethod\n'.format(D)+'{}def {}(cls, *args, **kwargs) -> {}:\n'.format(D,E,T)
152
+ else:C='{}def {}({}*args, **kwargs) -> {}:\n'.format(D,E,U,T)
153
+ C+=D+' ...\n\n';J.write(C)
154
+ elif I=="<class 'module'>":0
155
+ elif I.startswith("<class '"):
156
+ G=I[8:-2];C=B
157
+ if G in(x,v,w,y,'bytearray','bytes'):C=X.format(D,E,H,G)
158
+ elif G in(g,f,e):c={g:'{}',f:'[]',e:'()'};C=X.format(D,E,c[G],G)
159
+ elif G in('object','set','frozenset','Pin',Y):
160
+ if G==Y:G='Generator'
161
+ C='{0}{1}: {2} ## = {4}\n'.format(D,E,G,I,H)
162
+ else:
163
+ G=V
164
+ if K in H:H=H.split(K)[0]+Z
165
+ if K in H:H=H.split(K)[0]+Z
166
+ C='{0}{1}: {2} ## {3} = {4}\n'.format(D,E,G,I,H)
167
+ J.write(C)
168
+ else:J.write("# all other, type = '{0}'\n".format(I));J.write(D+E+' # type: Incomplete\n')
169
+ @property
170
+ def flat_fwid(self):
171
+ A=self._fwid;B=' .()/\\:$'
172
+ for C in B:A=A.replace(C,'_')
173
+ return A
174
+ def clean(C,path=E):
175
+ if path is E:path=C.path
176
+ A.info('Clean/remove files in folder: {}'.format(path))
177
+ try:os.stat(path);F=os.listdir(path)
178
+ except(D,I):return
179
+ for G in F:
180
+ B=i.format(path,G)
181
+ try:os.remove(B)
182
+ except D:
183
+ try:C.clean(B);os.rmdir(B)
184
+ except D:pass
185
+ def report_start(B,filename=j):
186
+ H='firmware';B._json_name=i.format(B.path,filename);B._json_first=R;X(B._json_name);A.info('Report file: {}'.format(B._json_name));F.collect()
187
+ try:
188
+ with M(B._json_name,h)as G:G.write('{');G.write(dumps({H:B.info})[1:-1]);G.write(k);G.write(dumps({t:{C:__version__},'stubtype':H})[1:-1]);G.write(k);G.write('"modules" :[\n')
189
+ except D as I:A.error(A1);B._json_name=E;raise I
190
+ def report_add(B,module_name,stub_file):
191
+ if not B._json_name:raise s(A2)
192
+ try:
193
+ with M(B._json_name,'a')as C:
194
+ if not B._json_first:C.write(k)
195
+ else:B._json_first=H
196
+ E='{{"module": "{}", "file": "{}"}}'.format(module_name,stub_file.replace('\\',G));C.write(E)
197
+ except D:A.error(A1)
198
+ def report_end(B):
199
+ if not B._json_name:raise s(A2)
200
+ with M(B._json_name,'a')as C:C.write('\n]}')
201
+ A.info('Path: {}'.format(B.path))
202
+ def X(path):
203
+ B=E=0
204
+ while B!=-1:
205
+ B=path.find(G,E)
206
+ if B!=-1:
207
+ C=path[0]if B==0 else path[:B]
208
+ try:I=os.stat(C)
209
+ except D as F:
210
+ if F.args[0]==A3:
211
+ try:os.mkdir(C)
212
+ except D as H:A.error('failed to create folder {}'.format(C));raise H
213
+ E=B+1
214
+ def Y(s):
215
+ C=' on '
216
+ if not s:return B
217
+ s=s.split(C,1)[0]if C in s else s
218
+ if s.startswith('v'):
219
+ if not V in s:return B
220
+ A=s.split(V)[1];return A
221
+ if not W in s:return B
222
+ A=s.split(W)[1].split(J)[1];return A
223
+ def _info():
224
+ a='ev3-pybricks';Z='pycom';X='pycopy';V='unix';S='win32';R='arch';P='cpu';M='ver';F='mpy';D='build'
225
+ try:H=sys.implementation[0]
226
+ except d:H=sys.implementation.name
227
+ A=l({Q:H,C:B,D:B,M:B,K:sys.platform,U:'UNKNOWN',P:B,F:B,R:B})
228
+ if A[K].startswith('pyb'):A[K]='stm32'
229
+ elif A[K]==S:A[K]='windows'
230
+ elif A[K]=='linux':A[K]=V
231
+ try:A[C]=A6(sys.implementation.version)
232
+ except I:pass
233
+ try:J=sys.implementation._machine if'_machine'in N(sys.implementation)else os.uname().machine;A[U]=J;A[P]=J.split('with')[-1].strip();A[F]=sys.implementation._mpy if'_mpy'in N(sys.implementation)else sys.implementation.mpy if F in N(sys.implementation)else B
234
+ except(I,T):pass
235
+ A[U]=A7()
236
+ try:
237
+ if'uname'in N(os):
238
+ A[D]=Y(os.uname()[3])
239
+ if not A[D]:A[D]=Y(os.uname()[2])
240
+ elif C in N(sys):A[D]=Y(sys.version)
241
+ except(I,T,d):pass
242
+ if A[C]==B and sys.platform not in(V,S):
243
+ try:b=os.uname();A[C]=b.release
244
+ except(T,I,d):pass
245
+ for(c,e,f)in[(X,X,'const'),(Z,Z,'FAT'),(a,'pybricks.hubs','EV3Brick')]:
246
+ try:g=__import__(e,E,E,f);A[Q]=c;del g;break
247
+ except(O,r):pass
248
+ if A[Q]==a:A['release']='2.0.0'
249
+ if A[Q]==u:
250
+ A[C]
251
+ if A[C]and A[C].endswith('.0')and A[C]>='1.10.0'and A[C]<='1.19.9':A[C]=A[C][:-2]
252
+ if F in A and A[F]:
253
+ G=int(A[F]);L=[E,'x86','x64','armv6','armv6m','armv7m','armv7em','armv7emsp','armv7emdp','xtensa','xtensawin'][G>>10]
254
+ if L:A[R]=L
255
+ A[F]='v{}.{}'.format(G&255,G>>8&3)
256
+ if A[D]and not A[C].endswith(W):A[C]=A[C]+W
257
+ A[M]=f"{A[C]}-{A[D]}"if A[D]else f"{A[C]}";return A
258
+ def A6(version):
259
+ A=version;B=J.join([c(A)for A in A[:3]])
260
+ if P(A)>3 and A[3]:B+=V+A[3]
261
+ return B
262
+ def A7():
263
+ try:from boardname import BOARDNAME as C;A.info('Found BOARDNAME: {}'.format(C))
264
+ except O:A.warning('BOARDNAME not found');C=B
265
+ return C
266
+ def get_root():
267
+ try:A=os.getcwd()
268
+ except(D,I):A=J
269
+ B=A
270
+ for B in[A,'/sd','/flash',G,J]:
271
+ try:C=os.stat(B);break
272
+ except D:continue
273
+ return B
274
+ def Z(filename):
275
+ try:
276
+ if os.stat(filename)[0]>>14:return R
277
+ return H
278
+ except D:return H
279
+ def m():S("-p, --path path to store the stubs in, defaults to '.'");sys.exit(1)
280
+ def read_path():
281
+ path=B
282
+ if P(sys.argv)==3:
283
+ A=sys.argv[1].lower()
284
+ if A in('--path','-p'):path=sys.argv[2]
285
+ else:m()
286
+ elif P(sys.argv)==2:m()
287
+ return path
288
+ def n():
289
+ try:A=bytes('abc',encoding='utf8');B=n.__module__;return H
290
+ except(o,I):return R
291
+ a='modulelist.done'
292
+ def A8(skip=0):
293
+ for E in A5:
294
+ B=E+'/modulelist.txt'
295
+ if not Z(B):continue
296
+ try:
297
+ with M(B)as F:
298
+ C=0
299
+ while R:
300
+ A=F.readline().strip()
301
+ if not A:break
302
+ if P(A)>0 and A[0]=='#':continue
303
+ C+=1
304
+ if C<skip:continue
305
+ yield A
306
+ break
307
+ except D:pass
308
+ def A9(done):
309
+ with M(a,h)as A:A.write(c(done)+'\n')
310
+ def AA():
311
+ A=0
312
+ try:
313
+ with M(a)as B:A=int(B.readline().strip())
314
+ except D:pass
315
+ return A
316
+ def main():
317
+ import machine as D;C=Z(a)
318
+ if C:A.info('Continue from last run')
319
+ else:A.info('Starting new run')
320
+ stubber=Stubber(path=read_path());B=0
321
+ if not C:stubber.clean();stubber.report_start(j)
322
+ else:B=AA();stubber._json_name=i.format(stubber.path,j)
323
+ for E in A8(B):
324
+ try:stubber.create_one_stub(E)
325
+ except p:D.reset()
326
+ F.collect();B+=1;A9(B)
327
+ S('All modules have been processed, Finalizing report');stubber.report_end()
328
+ if __name__=='__main__'or n():
329
+ if not Z('no_auto_stubber.txt'):
330
+ try:F.threshold(4*1024);F.enable()
331
+ except BaseException:pass
332
332
  main()