micropython-stubber 1.23.1.post1__py3-none-any.whl → 1.23.2__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.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/LICENSE +30 -30
  2. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/METADATA +4 -4
  3. micropython_stubber-1.23.2.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 +284 -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 +210 -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 +43 -43
  44. mpflash/mpflash/mpremoteboard/__init__.py +266 -266
  45. mpflash/mpflash/mpremoteboard/mpy_fw_info.py +141 -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 +1599 -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 +1004 -986
  59. stubber/board/createstubs_db.py +826 -825
  60. stubber/board/createstubs_db_min.py +332 -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 +767 -766
  65. stubber/board/createstubs_mem_min.py +307 -306
  66. stubber/board/createstubs_mem_mpy.mpy +0 -0
  67. stubber/board/createstubs_min.py +295 -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 +437 -437
  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 +151 -145
  83. stubber/codemod/merge_docstub.py +284 -284
  84. stubber/codemod/modify_list.py +54 -54
  85. stubber/codemod/utils.py +56 -56
  86. stubber/commands/build_cmd.py +94 -94
  87. stubber/commands/cli.py +49 -49
  88. stubber/commands/clone_cmd.py +78 -78
  89. stubber/commands/config_cmd.py +29 -29
  90. stubber/commands/enrich_folder_cmd.py +71 -71
  91. stubber/commands/get_core_cmd.py +71 -71
  92. stubber/commands/get_docstubs_cmd.py +92 -92
  93. stubber/commands/get_frozen_cmd.py +117 -117
  94. stubber/commands/get_mcu_cmd.py +102 -102
  95. stubber/commands/merge_cmd.py +66 -66
  96. stubber/commands/publish_cmd.py +118 -118
  97. stubber/commands/stub_cmd.py +31 -31
  98. stubber/commands/switch_cmd.py +62 -62
  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 +37 -37
  107. stubber/freeze/common.py +72 -72
  108. stubber/freeze/freeze_folder.py +69 -69
  109. stubber/freeze/freeze_manifest_2.py +126 -126
  110. stubber/freeze/get_frozen.py +131 -131
  111. stubber/get_cpython.py +112 -112
  112. stubber/get_lobo.py +59 -59
  113. stubber/minify.py +423 -423
  114. stubber/publish/bump.py +86 -86
  115. stubber/publish/candidates.py +275 -275
  116. stubber/publish/database.py +18 -18
  117. stubber/publish/defaults.py +40 -40
  118. stubber/publish/enums.py +24 -24
  119. stubber/publish/helpers.py +29 -29
  120. stubber/publish/merge_docstubs.py +136 -132
  121. stubber/publish/missing_class_methods.py +51 -51
  122. stubber/publish/package.py +150 -150
  123. stubber/publish/pathnames.py +51 -51
  124. stubber/publish/publish.py +120 -120
  125. stubber/publish/pypi.py +42 -42
  126. stubber/publish/stubpackage.py +1055 -1051
  127. stubber/rst/__init__.py +9 -9
  128. stubber/rst/classsort.py +78 -78
  129. stubber/rst/lookup.py +533 -531
  130. stubber/rst/output_dict.py +401 -401
  131. stubber/rst/reader.py +814 -814
  132. stubber/rst/report_return.py +77 -77
  133. stubber/rst/rst_utils.py +541 -541
  134. stubber/stubber.py +38 -38
  135. stubber/stubs_from_docs.py +90 -90
  136. stubber/tools/manifestfile.py +654 -654
  137. stubber/tools/readme.md +6 -6
  138. stubber/update_fallback.py +117 -117
  139. stubber/update_module_list.py +123 -123
  140. stubber/utils/__init__.py +6 -6
  141. stubber/utils/config.py +137 -137
  142. stubber/utils/makeversionhdr.py +54 -54
  143. stubber/utils/manifest.py +90 -90
  144. stubber/utils/post.py +80 -80
  145. stubber/utils/repos.py +156 -156
  146. stubber/utils/stubmaker.py +139 -139
  147. stubber/utils/typed_config_toml.py +80 -80
  148. stubber/variants.py +106 -106
  149. micropython_stubber-1.23.1.post1.dist-info/RECORD +0 -159
  150. mpflash/basicgit.py +0 -288
  151. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/WHEEL +0 -0
  152. {micropython_stubber-1.23.1.post1.dist-info → micropython_stubber-1.23.2.dist-info}/entry_points.txt +0 -0
@@ -1,295 +1,296 @@
1
- z='No report file'
2
- y='Failed to create the report.'
3
- x='{}/{}'
4
- w='logging'
5
- v='sys'
6
- u='method'
7
- t='function'
8
- s='bool'
9
- r='str'
10
- q='float'
11
- p='int'
12
- o='stubber'
13
- n=Exception
14
- m=KeyError
15
- l=sorted
16
- k=NotImplementedError
17
- g='pycom'
18
- f=',\n'
19
- e='dict'
20
- d='list'
21
- c='tuple'
22
- b='micropython'
23
- a=TypeError
24
- Z=repr
25
- Y=print
26
- V='-preview'
27
- U=True
28
- T='-'
29
- S='board'
30
- R=len
31
- Q=open
32
- P=IndexError
33
- O='family'
34
- N=ImportError
35
- M=dir
36
- K='port'
37
- J='.'
38
- I=AttributeError
39
- H=False
40
- G='/'
41
- E=OSError
42
- D=None
43
- C='version'
44
- B=''
45
- import gc as F,os,sys
46
- from time import sleep
47
- try:from ujson import dumps
48
- except:from json import dumps
49
- try:from machine import reset
50
- except N:pass
51
- try:from collections import OrderedDict as h
52
- except N:from ucollections import OrderedDict as h
53
- __version__='v1.23.1'
54
- A0=2
55
- A1=2
56
- A5=['lib','/lib','/sd/lib','/flash/lib',J]
57
- class L:
58
- INFO=20;WARNING=30;ERROR=40;level=INFO;prnt=Y
59
- @staticmethod
60
- def getLogger(name):return L()
61
- @classmethod
62
- def basicConfig(A,level):A.level=level
63
- def info(A,msg):
64
- if A.level<=L.INFO:A.prnt('INFO :',msg)
65
- def warning(A,msg):
66
- if A.level<=L.WARNING:A.prnt('WARN :',msg)
67
- def error(A,msg):
68
- if A.level<=L.ERROR:A.prnt('ERROR :',msg)
69
- A=L.getLogger(o)
70
- L.basicConfig(level=L.INFO)
71
- class Stubber:
72
- def __init__(B,path=D,firmware_id=D):
73
- C=firmware_id
74
- try:
75
- if os.uname().release=='1.13.0'and os.uname().version<'v1.13-103':raise k('MicroPython 1.13.0 cannot be stubbed')
76
- except I:pass
77
- B.info=_info();A.info('Port: {}'.format(B.info[K]));A.info('Board: {}'.format(B.info[S]));F.collect()
78
- if C:B._fwid=C.lower()
79
- elif B.info[O]==b:B._fwid='{family}-v{version}-{port}-{board}'.format(**B.info).rstrip(T)
80
- else:B._fwid='{family}-v{version}-{port}'.format(**B.info)
81
- B._start_free=F.mem_free()
82
- if path:
83
- if path.endswith(G):path=path[:-1]
84
- else:path=get_root()
85
- B.path='{}/stubs/{}'.format(path,B.flat_fwid).replace('//',G)
86
- try:W(path+G)
87
- except E:A.error('error creating stub folder {}'.format(path))
88
- 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=D;B._json_first=H
89
- def get_obj_attributes(L,item_instance):
90
- H=item_instance;C=[];K=[]
91
- for A in M(H):
92
- if A.startswith('__')and not A in L.modules:continue
93
- try:
94
- D=getattr(H,A)
95
- try:E=Z(type(D)).split("'")[1]
96
- except P:E=B
97
- if E in{p,q,r,s,c,d,e}:G=1
98
- elif E in{t,u}:G=2
99
- elif E in'class':G=3
100
- else:G=4
101
- C.append((A,Z(D),Z(type(D)),D,G))
102
- except I as J:K.append("Couldn't get attribute '{}' from object '{}', Err: {}".format(A,H,J))
103
- except MemoryError as J:Y('MemoryError: {}'.format(J));sleep(1);reset()
104
- C=l([A for A in C if not A[0].startswith('__')],key=lambda x:x[4]);F.collect();return C,K
105
- def add_modules(A,modules):A.modules=l(set(A.modules)|set(modules))
106
- def create_all_stubs(B):
107
- A.info('Start micropython-stubber {} on {}'.format(__version__,B._fwid));B.report_start();F.collect()
108
- for C in B.modules:B.create_one_stub(C)
109
- B.report_end();A.info('Finally done')
110
- def create_one_stub(C,module_name):
111
- B=module_name
112
- if B in C.problematic:A.warning('Skip module: {:<25} : Known problematic'.format(B));return H
113
- if B in C.excluded:A.warning('Skip module: {:<25} : Excluded'.format(B));return H
114
- I='{}/{}.pyi'.format(C.path,B.replace(J,G));F.collect();D=H
115
- try:D=C.create_module_stub(B,I)
116
- except E:return H
117
- F.collect();return D
118
- def create_module_stub(K,module_name,file_name=D):
119
- I=file_name;C=module_name
120
- if I is D:L=C.replace(J,'_')+'.pyi';I=K.path+G+L
121
- else:L=I.split(G)[-1]
122
- if G in C:C=C.replace(G,J)
123
- M=D
124
- try:M=__import__(C,D,D,'*');P=F.mem_free();A.info('Stub module: {:<25} to file: {:<70} mem:{:>5}'.format(C,L,P))
125
- except N:return H
126
- W(I)
127
- with Q(I,'w')as O:R=str(K.info).replace('OrderedDict(',B).replace('})','}');S='"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(C,K._fwid,R,__version__);O.write(S);O.write('from __future__ import annotations\nfrom typing import Any, Generator\nfrom _typeshed import Incomplete\n\n');K.write_object_stub(O,M,C,B)
128
- K.report_add(C,I)
129
- if C not in{'os',v,w,'gc'}:
130
- try:del M
131
- except(E,m):A.warning('could not del new_module')
132
- F.collect();return U
133
- def write_object_stub(L,fp,object_expr,obj_name,indent,in_class=0):
134
- 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()
135
- if M in L.problematic:A.warning('SKIPPING problematic module:{}'.format(M));return
136
- a,P=L.get_obj_attributes(M)
137
- if P:A.error(P)
138
- for(E,H,I,b,g)in a:
139
- if E in['classmethod','staticmethod','BaseException',N]:continue
140
- if E[0].isdigit():A.warning('NameError: invalid name {}'.format(E));continue
141
- if I=="<class 'type'>"and R(D)<=A1*4:
142
- Q=B;S=E.endswith(N)or E.endswith('Error')or E in['KeyboardInterrupt','StopIteration','SystemExit']
143
- if S:Q=N
144
- C='\n{}class {}({}):\n'.format(D,E,Q)
145
- if S:C+=D+' ...\n';J.write(C);continue
146
- 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)
147
- elif any(A in I for A in[u,t,'closure']):
148
- T=V;U=B
149
- if O>0:U='self, '
150
- if W in I or W in H:C='{}@classmethod\n'.format(D)+'{}def {}(cls, *args, **kwargs) -> {}:\n'.format(D,E,T)
151
- else:C='{}def {}({}*args, **kwargs) -> {}:\n'.format(D,E,U,T)
152
- C+=D+' ...\n\n';J.write(C)
153
- elif I=="<class 'module'>":0
154
- elif I.startswith("<class '"):
155
- G=I[8:-2];C=B
156
- if G in(r,p,q,s,'bytearray','bytes'):C=X.format(D,E,H,G)
157
- elif G in(e,d,c):f={e:'{}',d:'[]',c:'()'};C=X.format(D,E,f[G],G)
158
- elif G in('object','set','frozenset','Pin',Y):
159
- if G==Y:G='Generator'
160
- C='{0}{1}: {2} ## = {4}\n'.format(D,E,G,I,H)
161
- else:
162
- G=V
163
- if K in H:H=H.split(K)[0]+Z
164
- if K in H:H=H.split(K)[0]+Z
165
- C='{0}{1}: {2} ## {3} = {4}\n'.format(D,E,G,I,H)
166
- J.write(C)
167
- else:J.write("# all other, type = '{0}'\n".format(I));J.write(D+E+' # type: Incomplete\n')
168
- @property
169
- def flat_fwid(self):
170
- A=self._fwid;B=' .()/\\:$'
171
- for C in B:A=A.replace(C,'_')
172
- return A
173
- def clean(C,path=D):
174
- if path is D:path=C.path
175
- A.info('Clean/remove files in folder: {}'.format(path))
176
- try:os.stat(path);F=os.listdir(path)
177
- except(E,I):return
178
- for G in F:
179
- B=x.format(path,G)
180
- try:os.remove(B)
181
- except E:
182
- try:C.clean(B);os.rmdir(B)
183
- except E:pass
184
- def report_start(B,filename='modules.json'):
185
- H='firmware';B._json_name=x.format(B.path,filename);B._json_first=U;W(B._json_name);A.info('Report file: {}'.format(B._json_name));F.collect()
186
- try:
187
- with Q(B._json_name,'w')as G:G.write('{');G.write(dumps({H:B.info})[1:-1]);G.write(f);G.write(dumps({o:{C:__version__},'stubtype':H})[1:-1]);G.write(f);G.write('"modules" :[\n')
188
- except E as I:A.error(y);B._json_name=D;raise I
189
- def report_add(B,module_name,stub_file):
190
- if not B._json_name:raise n(z)
191
- try:
192
- with Q(B._json_name,'a')as C:
193
- if not B._json_first:C.write(f)
194
- else:B._json_first=H
195
- D='{{"module": "{}", "file": "{}"}}'.format(module_name,stub_file.replace('\\',G));C.write(D)
196
- except E:A.error(y)
197
- def report_end(B):
198
- if not B._json_name:raise n(z)
199
- with Q(B._json_name,'a')as C:C.write('\n]}')
200
- A.info('Path: {}'.format(B.path))
201
- def W(path):
202
- B=D=0
203
- while B!=-1:
204
- B=path.find(G,D)
205
- if B!=-1:
206
- C=path[0]if B==0 else path[:B]
207
- try:I=os.stat(C)
208
- except E as F:
209
- if F.args[0]==A0:
210
- try:os.mkdir(C)
211
- except E as H:A.error('failed to create folder {}'.format(C));raise H
212
- D=B+1
213
- def X(s):
214
- C=' on '
215
- if not s:return B
216
- s=s.split(C,1)[0]if C in s else s
217
- if s.startswith('v'):
218
- if not T in s:return B
219
- A=s.split(T)[1];return A
220
- if not V in s:return B
221
- A=s.split(V)[1].split(J)[1];return A
222
- def _info():
223
- Z='ev3-pybricks';Y='pycopy';W='unix';U='win32';T='arch';R='cpu';Q='ver';F='mpy';E='build'
224
- try:H=sys.implementation[0]
225
- except a:H=sys.implementation.name
226
- A=h({O:H,C:B,E:B,Q:B,K:sys.platform,S:'UNKNOWN',R:B,F:B,T:B})
227
- if A[K].startswith('pyb'):A[K]='stm32'
228
- elif A[K]==U:A[K]='windows'
229
- elif A[K]=='linux':A[K]=W
230
- try:A[C]=A2(sys.implementation.version)
231
- except I:pass
232
- try:J=sys.implementation._machine if'_machine'in M(sys.implementation)else os.uname().machine;A[S]=J;A[R]=J.split('with')[-1].strip();A[F]=sys.implementation._mpy if'_mpy'in M(sys.implementation)else sys.implementation.mpy if F in M(sys.implementation)else B
233
- except(I,P):pass
234
- A[S]=A3()
235
- try:
236
- if'uname'in M(os):
237
- A[E]=X(os.uname()[3])
238
- if not A[E]:A[E]=X(os.uname()[2])
239
- elif C in M(sys):A[E]=X(sys.version)
240
- except(I,P,a):pass
241
- if A[C]==B and sys.platform not in(W,U):
242
- try:c=os.uname();A[C]=c.release
243
- except(P,I,a):pass
244
- for(d,e,f)in[(Y,Y,'const'),(g,g,'FAT'),(Z,'pybricks.hubs','EV3Brick')]:
245
- try:i=__import__(e,D,D,f);A[O]=d;del i;break
246
- except(N,m):pass
247
- if A[O]==Z:A['release']='2.0.0'
248
- if A[O]==b:
249
- A[C]
250
- 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]
251
- if F in A and A[F]:
252
- G=int(A[F]);L=[D,'x86','x64','armv6','armv6m','armv7m','armv7em','armv7emsp','armv7emdp','xtensa','xtensawin'][G>>10]
253
- if L:A[T]=L
254
- A[F]='v{}.{}'.format(G&255,G>>8&3)
255
- if A[E]and not A[C].endswith(V):A[C]=A[C]+V
256
- A[Q]=f"{A[C]}-{A[E]}"if A[E]else f"{A[C]}";return A
257
- def A2(version):
258
- A=version;B=J.join([str(A)for A in A[:3]])
259
- if R(A)>3 and A[3]:B+=T+A[3]
260
- return B
261
- def A3():
262
- try:from boardname import BOARDNAME as C;A.info('Found BOARDNAME: {}'.format(C))
263
- except N:A.warning('BOARDNAME not found');C=B
264
- return C
265
- def get_root():
266
- try:A=os.getcwd()
267
- except(E,I):A=J
268
- B=A
269
- for B in[A,'/sd','/flash',G,J]:
270
- try:C=os.stat(B);break
271
- except E:continue
272
- return B
273
- def A4(filename):
274
- try:
275
- if os.stat(filename)[0]>>14:return U
276
- return H
277
- except E:return H
278
- def i():Y("-p, --path path to store the stubs in, defaults to '.'");sys.exit(1)
279
- def read_path():
280
- path=B
281
- if R(sys.argv)==3:
282
- A=sys.argv[1].lower()
283
- if A in('--path','-p'):path=sys.argv[2]
284
- else:i()
285
- elif R(sys.argv)==2:i()
286
- return path
287
- def j():
288
- try:A=bytes('abc',encoding='utf8');B=j.__module__;return H
289
- except(k,I):return U
290
- def main():stubber=Stubber(path=read_path());stubber.clean();stubber.modules=['WM8960','_OTA','_asyncio','_boot_fat','_coap','_espnow','_flash_control_OTA','_main_pybytes','_mqtt','_mqtt_core','_msg_handl','_onewire','_periodical_pin','_pybytes','_pybytes_ca','_pybytes_config','_pybytes_config_reader','_pybytes_connection','_pybytes_constants','_pybytes_debug','_pybytes_library','_pybytes_machine_learning','_pybytes_main','_pybytes_protocol','_pybytes_pyconfig','_pybytes_pymesh_config','_rp2','_terminal','_thread','_uasyncio','_urequest','adcfft','aioble/__init__','aioble/central','aioble/client','aioble/core','aioble/device','aioble/l2cap','aioble/peripheral','aioble/security','aioble/server','aioespnow','ak8963','apa102','apa106','argparse','array','asyncio/__init__','asyncio/core','asyncio/event','asyncio/funcs','asyncio/lock','asyncio/stream','binascii','bluetooth','breakout_as7262','breakout_bh1745','breakout_bme280','breakout_bme68x','breakout_bmp280','breakout_dotmatrix','breakout_encoder','breakout_icp10125','breakout_ioexpander','breakout_ltr559','breakout_matrix11x7','breakout_mics6814','breakout_msa301','breakout_paa5100','breakout_pmw3901','breakout_potentiometer','breakout_rgbmatrix5x5','breakout_rtc','breakout_scd41','breakout_sgp30','breakout_trackball','breakout_vl53l5cx','btree','cmath','collections','crypto','cryptolib','curl','deflate','dht','display','display_driver_utils','ds18x20','encoder','errno','esp','esp32','espidf','espnow','ffi','flashbdev','framebuf','freesans20','fs_driver','functools','galactic','gc','gfx_pack','gsm','hashlib','heapq','hub75','ili9341','ili9XXX','imagetools','inisetup','interstate75','io','jpegdec','js','jsffi','json','lcd160cr','lodepng',w,'lsm6dsox','lv_colors','lv_utils','lvgl','lwip','machine','math','microWebSocket','microWebSrv','microWebTemplate',b,'mip','mip/__init__','mip/__main__','motor','mpu6500','mpu9250','neopixel','network','ntptime','onewire','openamp','os','pcf85063a','picoexplorer','picographics','picokeypad','picoscroll','picounicorn','picowireless','pimoroni','pimoroni_bus','pimoroni_i2c','plasma','platform','pyb',g,'pye','qrcode','queue','random','requests','requests/__init__','rp2','rtch','samd','select','servo','socket','ssd1306','ssh','ssl','stm','struct',v,'termios','time','tls','tpcalib','uarray','uasyncio/__init__','uasyncio/core','uasyncio/event','uasyncio/funcs','uasyncio/lock','uasyncio/stream','uasyncio/tasks','ubinascii','ubluetooth','ucollections','ucrypto','ucryptolib','uctypes','uerrno','uftpd','uhashlib','uheapq','uio','ujson','ulab','ulab/approx','ulab/compare','ulab/fft','ulab/filter','ulab/linalg','ulab/numerical','ulab/poly','ulab/user','ulab/vector','umachine','umqtt/__init__','umqtt/robust','umqtt/simple','uos','uplatform','uqueue','urandom','ure','urequests','urllib/urequest','usb/device','usb/device/cdc','usb/device/hid','usb/device/keyboard','usb/device/midi','usb/device/mouse','uselect','usocket','ussl','ustruct','usys','utelnetserver','utime','utimeq','uwebsocket','uzlib',C,'vfs','websocket','websocket_helper','wipy','writer','xpt2046','ymodem','zephyr','zlib'];F.collect();stubber.create_all_stubs()
291
- if __name__=='__main__'or j():
292
- if not A4('no_auto_stubber.txt'):
293
- try:F.threshold(4*1024);F.enable()
294
- except BaseException:pass
1
+ A0='No report file'
2
+ z='Failed to create the report.'
3
+ y='{}/{}'
4
+ x='logging'
5
+ w='sys'
6
+ v='method'
7
+ u='function'
8
+ t='bool'
9
+ s='str'
10
+ r='float'
11
+ q='int'
12
+ p='stubber'
13
+ o=Exception
14
+ n=KeyError
15
+ m=sorted
16
+ l=NotImplementedError
17
+ h='pycom'
18
+ g=',\n'
19
+ f='dict'
20
+ e='list'
21
+ d='tuple'
22
+ c='micropython'
23
+ b=TypeError
24
+ a=repr
25
+ Z=print
26
+ W='-preview'
27
+ V=True
28
+ U='-'
29
+ T='board'
30
+ S=len
31
+ R=open
32
+ Q=IndexError
33
+ O='family'
34
+ N=ImportError
35
+ M=dir
36
+ K='port'
37
+ J='.'
38
+ I=AttributeError
39
+ H=False
40
+ G='/'
41
+ E=OSError
42
+ D=None
43
+ C='version'
44
+ B=''
45
+ import gc as F,os,sys
46
+ from time import sleep
47
+ try:from ujson import dumps
48
+ except:from json import dumps
49
+ try:from machine import reset
50
+ except N:pass
51
+ try:from collections import OrderedDict as i
52
+ except N:from ucollections import OrderedDict as i
53
+ __version__='v1.23.2'
54
+ P=__version__.rsplit(J,1)[0]
55
+ A1=2
56
+ A2=2
57
+ A5=['lib','/lib','/sd/lib','/flash/lib',J]
58
+ class L:
59
+ INFO=20;WARNING=30;ERROR=40;level=INFO;prnt=Z
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(p)
71
+ L.basicConfig(level=L.INFO)
72
+ class Stubber:
73
+ def __init__(B,path=D,firmware_id=D):
74
+ C=firmware_id
75
+ try:
76
+ if os.uname().release=='1.13.0'and os.uname().version<'v1.13-103':raise l('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[T]));F.collect()
79
+ if C:B._fwid=C.lower()
80
+ elif B.info[O]==c:B._fwid='{family}-v{version}-{port}-{board}'.format(**B.info).rstrip(U)
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 E: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=D;B._json_first=H
90
+ def get_obj_attributes(L,item_instance):
91
+ H=item_instance;C=[];K=[]
92
+ for A in M(H):
93
+ if A.startswith('__')and not A in L.modules:continue
94
+ try:
95
+ D=getattr(H,A)
96
+ try:E=a(type(D)).split("'")[1]
97
+ except Q:E=B
98
+ if E in{q,r,s,t,d,e,f}:G=1
99
+ elif E in{u,v}:G=2
100
+ elif E in'class':G=3
101
+ else:G=4
102
+ C.append((A,a(D),a(type(D)),D,G))
103
+ except I as J:K.append("Couldn't get attribute '{}' from object '{}', Err: {}".format(A,H,J))
104
+ except MemoryError as J:Z('MemoryError: {}'.format(J));sleep(1);reset()
105
+ C=m([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=m(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();D=H
116
+ try:D=C.create_module_stub(B,I)
117
+ except E:return H
118
+ F.collect();return D
119
+ def create_module_stub(K,module_name,file_name=D):
120
+ I=file_name;C=module_name
121
+ if I is D: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
+ M=D
125
+ try:M=__import__(C,D,D,'*');Q=F.mem_free();A.info('Stub module: {:<25} to file: {:<70} mem:{:>5}'.format(C,L,Q))
126
+ except N:return H
127
+ X(I)
128
+ with R(I,'w')as O:S=str(K.info).replace('OrderedDict(',B).replace('})','}');T='"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(C,K._fwid,S,P);O.write(T);O.write('from __future__ import annotations\nfrom typing import Any, Generator\nfrom _typeshed import Incomplete\n\n');K.write_object_stub(O,M,C,B)
129
+ K.report_add(C,I)
130
+ if C not in{'os',w,x,'gc'}:
131
+ try:del M
132
+ except(E,n):A.warning('could not del new_module')
133
+ F.collect();return V
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,P=L.get_obj_attributes(M)
138
+ if P:A.error(P)
139
+ for(E,H,I,b,g)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 S(D)<=A2*4:
143
+ Q=B;R=E.endswith(N)or E.endswith('Error')or E in['KeyboardInterrupt','StopIteration','SystemExit']
144
+ if R:Q=N
145
+ C='\n{}class {}({}):\n'.format(D,E,Q)
146
+ if R: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[v,u,'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(s,q,r,t,'bytearray','bytes'):C=X.format(D,E,H,G)
158
+ elif G in(f,e,d):c={f:'{}',e:'[]',d:'()'};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=D):
175
+ if path is D:path=C.path
176
+ A.info('Clean/remove files in folder: {}'.format(path))
177
+ try:os.stat(path);F=os.listdir(path)
178
+ except(E,I):return
179
+ for G in F:
180
+ B=y.format(path,G)
181
+ try:os.remove(B)
182
+ except E:
183
+ try:C.clean(B);os.rmdir(B)
184
+ except E:pass
185
+ def report_start(B,filename='modules.json'):
186
+ H='firmware';B._json_name=y.format(B.path,filename);B._json_first=V;X(B._json_name);A.info('Report file: {}'.format(B._json_name));F.collect()
187
+ try:
188
+ with R(B._json_name,'w')as G:G.write('{');G.write(dumps({H:B.info})[1:-1]);G.write(g);G.write(dumps({p:{C:P},'stubtype':H})[1:-1]);G.write(g);G.write('"modules" :[\n')
189
+ except E as I:A.error(z);B._json_name=D;raise I
190
+ def report_add(B,module_name,stub_file):
191
+ if not B._json_name:raise o(A0)
192
+ try:
193
+ with R(B._json_name,'a')as C:
194
+ if not B._json_first:C.write(g)
195
+ else:B._json_first=H
196
+ D='{{"module": "{}", "file": "{}"}}'.format(module_name,stub_file.replace('\\',G));C.write(D)
197
+ except E:A.error(z)
198
+ def report_end(B):
199
+ if not B._json_name:raise o(A0)
200
+ with R(B._json_name,'a')as C:C.write('\n]}')
201
+ A.info('Path: {}'.format(B.path))
202
+ def X(path):
203
+ B=D=0
204
+ while B!=-1:
205
+ B=path.find(G,D)
206
+ if B!=-1:
207
+ C=path[0]if B==0 else path[:B]
208
+ try:I=os.stat(C)
209
+ except E as F:
210
+ if F.args[0]==A1:
211
+ try:os.mkdir(C)
212
+ except E as H:A.error('failed to create folder {}'.format(C));raise H
213
+ D=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 U in s:return B
220
+ A=s.split(U)[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='pycopy';X='unix';V='win32';U='arch';S='cpu';R='ver';F='mpy';E='build'
225
+ try:H=sys.implementation[0]
226
+ except b:H=sys.implementation.name
227
+ A=i({O:H,C:B,E:B,R:B,K:sys.platform,T:'UNKNOWN',S:B,F:B,U:B})
228
+ if A[K].startswith('pyb'):A[K]='stm32'
229
+ elif A[K]==V:A[K]='windows'
230
+ elif A[K]=='linux':A[K]=X
231
+ try:A[C]=P(sys.implementation.version)
232
+ except I:pass
233
+ try:J=sys.implementation._machine if'_machine'in M(sys.implementation)else os.uname().machine;A[T]=J;A[S]=J.split('with')[-1].strip();A[F]=sys.implementation._mpy if'_mpy'in M(sys.implementation)else sys.implementation.mpy if F in M(sys.implementation)else B
234
+ except(I,Q):pass
235
+ A[T]=A3()
236
+ try:
237
+ if'uname'in M(os):
238
+ A[E]=Y(os.uname()[3])
239
+ if not A[E]:A[E]=Y(os.uname()[2])
240
+ elif C in M(sys):A[E]=Y(sys.version)
241
+ except(I,Q,b):pass
242
+ if A[C]==B and sys.platform not in(X,V):
243
+ try:d=os.uname();A[C]=d.release
244
+ except(Q,I,b):pass
245
+ for(e,f,g)in[(Z,Z,'const'),(h,h,'FAT'),(a,'pybricks.hubs','EV3Brick')]:
246
+ try:j=__import__(f,D,D,g);A[O]=e;del j;break
247
+ except(N,n):pass
248
+ if A[O]==a:A['release']='2.0.0'
249
+ if A[O]==c:
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=[D,'x86','x64','armv6','armv6m','armv7m','armv7em','armv7emsp','armv7emdp','xtensa','xtensawin'][G>>10]
254
+ if L:A[U]=L
255
+ A[F]='v{}.{}'.format(G&255,G>>8&3)
256
+ if A[E]and not A[C].endswith(W):A[C]=A[C]+W
257
+ A[R]=f"{A[C]}-{A[E]}"if A[E]else f"{A[C]}";return A
258
+ def P(version):
259
+ A=version;B=J.join([str(A)for A in A[:3]])
260
+ if S(A)>3 and A[3]:B+=U+A[3]
261
+ return B
262
+ def A3():
263
+ try:from boardname import BOARDNAME as C;A.info('Found BOARDNAME: {}'.format(C))
264
+ except N:A.warning('BOARDNAME not found');C=B
265
+ return C
266
+ def get_root():
267
+ try:A=os.getcwd()
268
+ except(E,I):A=J
269
+ B=A
270
+ for B in[A,'/sd','/flash',G,J]:
271
+ try:C=os.stat(B);break
272
+ except E:continue
273
+ return B
274
+ def A4(filename):
275
+ try:
276
+ if os.stat(filename)[0]>>14:return V
277
+ return H
278
+ except E:return H
279
+ def j():Z("-p, --path path to store the stubs in, defaults to '.'");sys.exit(1)
280
+ def read_path():
281
+ path=B
282
+ if S(sys.argv)==3:
283
+ A=sys.argv[1].lower()
284
+ if A in('--path','-p'):path=sys.argv[2]
285
+ else:j()
286
+ elif S(sys.argv)==2:j()
287
+ return path
288
+ def k():
289
+ try:A=bytes('abc',encoding='utf8');B=k.__module__;return H
290
+ except(l,I):return V
291
+ def main():stubber=Stubber(path=read_path());stubber.clean();stubber.modules=['WM8960','_OTA','_asyncio','_boot_fat','_coap','_espnow','_flash_control_OTA','_main_pybytes','_mqtt','_mqtt_core','_msg_handl','_onewire','_periodical_pin','_pybytes','_pybytes_ca','_pybytes_config','_pybytes_config_reader','_pybytes_connection','_pybytes_constants','_pybytes_debug','_pybytes_library','_pybytes_machine_learning','_pybytes_main','_pybytes_protocol','_pybytes_pyconfig','_pybytes_pymesh_config','_rp2','_terminal','_thread','_uasyncio','_urequest','adcfft','aioble/__init__','aioble/central','aioble/client','aioble/core','aioble/device','aioble/l2cap','aioble/peripheral','aioble/security','aioble/server','aioespnow','ak8963','apa102','apa106','argparse','array','asyncio/__init__','asyncio/core','asyncio/event','asyncio/funcs','asyncio/lock','asyncio/stream','binascii','bluetooth','breakout_as7262','breakout_bh1745','breakout_bme280','breakout_bme68x','breakout_bmp280','breakout_dotmatrix','breakout_encoder','breakout_icp10125','breakout_ioexpander','breakout_ltr559','breakout_matrix11x7','breakout_mics6814','breakout_msa301','breakout_paa5100','breakout_pmw3901','breakout_potentiometer','breakout_rgbmatrix5x5','breakout_rtc','breakout_scd41','breakout_sgp30','breakout_trackball','breakout_vl53l5cx','btree','cmath','collections','crypto','cryptolib','curl','deflate','dht','display','display_driver_utils','ds18x20','encoder','errno','esp','esp32','espidf','espnow','ffi','flashbdev','framebuf','freesans20','fs_driver','functools','galactic','gc','gfx_pack','gsm','hashlib','heapq','hub75','ili9341','ili9XXX','imagetools','inisetup','interstate75','io','jpegdec','js','jsffi','json','lcd160cr','lodepng',x,'lsm6dsox','lv_colors','lv_utils','lvgl','lwip','machine','math','microWebSocket','microWebSrv','microWebTemplate',c,'mip','mip/__init__','mip/__main__','motor','mpu6500','mpu9250','neopixel','network','ntptime','onewire','openamp','os','pcf85063a','picoexplorer','picographics','picokeypad','picoscroll','picounicorn','picowireless','pimoroni','pimoroni_bus','pimoroni_i2c','plasma','platform','pyb',h,'pye','qrcode','queue','random','requests','requests/__init__','rp2','rtch','samd','select','servo','socket','ssd1306','ssh','ssl','stm','struct',w,'termios','time','tls','tpcalib','uarray','uasyncio/__init__','uasyncio/core','uasyncio/event','uasyncio/funcs','uasyncio/lock','uasyncio/stream','uasyncio/tasks','ubinascii','ubluetooth','ucollections','ucrypto','ucryptolib','uctypes','uerrno','uftpd','uhashlib','uheapq','uio','ujson','ulab','ulab/approx','ulab/compare','ulab/fft','ulab/filter','ulab/linalg','ulab/numerical','ulab/poly','ulab/user','ulab/vector','umachine','umqtt/__init__','umqtt/robust','umqtt/simple','uos','uplatform','uqueue','urandom','ure','urequests','urllib/urequest','usb/device','usb/device/cdc','usb/device/hid','usb/device/keyboard','usb/device/midi','usb/device/mouse','uselect','usocket','ussl','ustruct','usys','utelnetserver','utime','utimeq','uwebsocket','uzlib',C,'vfs','websocket','websocket_helper','wipy','writer','xpt2046','ymodem','zephyr','zlib'];F.collect();stubber.create_all_stubs()
292
+ if __name__=='__main__'or k():
293
+ if not A4('no_auto_stubber.txt'):
294
+ try:F.threshold(4*1024);F.enable()
295
+ except BaseException:pass
295
296
  main()
Binary file