micropython-stubber 1.20.5__py3-none-any.whl → 1.23.0__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.5.dist-info → micropython_stubber-1.23.0.dist-info}/LICENSE +30 -30
  2. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.dist-info}/METADATA +1 -1
  3. micropython_stubber-1.23.0.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 -236
  8. mpflash/mpflash/bootloader/__init__.py +37 -36
  9. mpflash/mpflash/bootloader/manual.py +102 -102
  10. mpflash/mpflash/bootloader/micropython.py +10 -10
  11. mpflash/mpflash/bootloader/touch1200.py +45 -45
  12. mpflash/mpflash/cli_download.py +129 -129
  13. mpflash/mpflash/cli_flash.py +219 -219
  14. mpflash/mpflash/cli_group.py +98 -98
  15. mpflash/mpflash/cli_list.py +81 -81
  16. mpflash/mpflash/cli_main.py +41 -41
  17. mpflash/mpflash/common.py +164 -164
  18. mpflash/mpflash/config.py +43 -47
  19. mpflash/mpflash/connected.py +74 -74
  20. mpflash/mpflash/download.py +360 -360
  21. mpflash/mpflash/downloaded.py +130 -129
  22. mpflash/mpflash/errors.py +9 -9
  23. mpflash/mpflash/flash.py +55 -52
  24. mpflash/mpflash/flash_esp.py +59 -59
  25. mpflash/mpflash/flash_stm32.py +18 -24
  26. mpflash/mpflash/flash_stm32_cube.py +111 -111
  27. mpflash/mpflash/flash_stm32_dfu.py +104 -101
  28. mpflash/mpflash/flash_uf2.py +89 -67
  29. mpflash/mpflash/flash_uf2_boardid.py +15 -15
  30. mpflash/mpflash/flash_uf2_linux.py +129 -123
  31. mpflash/mpflash/flash_uf2_macos.py +37 -34
  32. mpflash/mpflash/flash_uf2_windows.py +38 -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 +226 -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 -91
  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 +171 -170
  51. mpflash/poetry.lock +1588 -1588
  52. mpflash/pyproject.toml +64 -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 -986
  59. stubber/board/createstubs_db.py +825 -825
  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 -766
  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 -454
  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 +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 +55 -51
  88. stubber/commands/clone_cmd.py +77 -66
  89. stubber/commands/config_cmd.py +29 -29
  90. stubber/commands/enrich_folder_cmd.py +71 -70
  91. stubber/commands/get_core_cmd.py +71 -69
  92. stubber/commands/get_docstubs_cmd.py +89 -87
  93. stubber/commands/get_frozen_cmd.py +114 -112
  94. stubber/commands/get_mcu_cmd.py +61 -56
  95. stubber/commands/merge_cmd.py +67 -66
  96. stubber/commands/publish_cmd.py +119 -119
  97. stubber/commands/stub_cmd.py +31 -30
  98. stubber/commands/switch_cmd.py +62 -54
  99. stubber/commands/variants_cmd.py +49 -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 -262
  116. stubber/publish/database.py +18 -18
  117. stubber/publish/defaults.py +45 -45
  118. stubber/publish/enums.py +24 -24
  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 -146
  123. stubber/publish/pathnames.py +51 -51
  124. stubber/publish/publish.py +120 -120
  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 -822
  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 +655 -610
  137. stubber/tools/readme.md +7 -6
  138. stubber/update_fallback.py +117 -117
  139. stubber/update_module_list.py +123 -123
  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.5.dist-info/RECORD +0 -159
  151. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.dist-info}/WHEEL +0 -0
  152. {micropython_stubber-1.20.5.dist-info → micropython_stubber-1.23.0.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.20.5'
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.0'
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()
Binary file