micropython-stubber 1.23.2__py3-none-any.whl → 1.24.0__py3-none-any.whl

stubber/board/createstubs_db_min.py

@@ -1,41 +1,41 @@
-A3='No report file'
-A2='Failed to create the report.'
-A1='method'
-A0='function'
-z='bool'
-y='str'
-x='float'
-w='int'
-v='micropython'
-u='stubber'
-t=Exception
-s=KeyError
-r=sorted
-q=MemoryError
-p=NotImplementedError
-l=',\n'
-k='modules.json'
-j='{}/{}'
-i='w'
-h='dict'
-g='list'
-f='tuple'
-e=TypeError
-d=str
-c=repr
-X='-preview'
-W='-'
-V='board'
-U=IndexError
-T=print
-R=True
-Q='family'
-P=len
+A2='No report file'
+A1='Failed to create the report.'
+A0='method'
+z='function'
+y='bool'
+x='str'
+w='float'
+v='int'
+u='micropython'
+t='stubber'
+s=Exception
+r=KeyError
+q=sorted
+p=MemoryError
+o=NotImplementedError
+k=',\n'
+j='modules.json'
+i='{}/{}'
+h='w'
+g='dict'
+f='list'
+e='tuple'
+d=TypeError
+c=str
+b=repr
+W='-preview'
+V='-'
+U='board'
+T=True
+S='family'
+R=len
+Q=IndexError
+P=print
 O=ImportError
 N=dir
 M=open
-K='port'
-J='.'
+L='port'
+K='.'
 I=AttributeError
 H=False
 G='/'
@@ -49,43 +49,44 @@ try:from ujson import dumps
 except:from json import dumps
 try:from machine import reset
 except O:pass
-try:from collections import OrderedDict as m
-except O:from ucollections import OrderedDict as m
-__version__='v1.23.2'
-S=__version__.rsplit(J,1)[0]
+try:from collections import OrderedDict as l
+except O:from ucollections import OrderedDict as l
+__version__='v1.24.0'
+A3=2
 A4=2
-A5=2
-A6=['lib','/lib','/sd/lib','/flash/lib',J]
-class L:
-	INFO=20;WARNING=30;ERROR=40;level=INFO;prnt=T
+A5=['lib','/lib','/sd/lib','/flash/lib',K]
+class J:
+	DEBUG=10;INFO=20;WARNING=30;ERROR=40;level=INFO;prnt=P
 	@staticmethod
-	def getLogger(name):return L()
+	def getLogger(name):return J()
 	@classmethod
 	def basicConfig(A,level):A.level=level
+	def debug(A,msg):
+		if A.level<=J.DEBUG:A.prnt('DEBUG :',msg)
 	def info(A,msg):
-		if A.level<=L.INFO:A.prnt('INFO  :',msg)
+		if A.level<=J.INFO:A.prnt('INFO  :',msg)
 	def warning(A,msg):
-		if A.level<=L.WARNING:A.prnt('WARN  :',msg)
+		if A.level<=J.WARNING:A.prnt('WARN  :',msg)
 	def error(A,msg):
-		if A.level<=L.ERROR:A.prnt('ERROR :',msg)
-A=L.getLogger(u)
-L.basicConfig(level=L.INFO)
+		if A.level<=J.ERROR:A.prnt('ERROR :',msg)
+A=J.getLogger(t)
+J.basicConfig(level=J.INFO)
 class Stubber:
 	def __init__(B,path=E,firmware_id=E):
 		C=firmware_id
 		try:
-			if os.uname().release=='1.13.0'and os.uname().version<'v1.13-103':raise p('MicroPython 1.13.0 cannot be stubbed')
+			if os.uname().release=='1.13.0'and os.uname().version<'v1.13-103':raise o('MicroPython 1.13.0 cannot be stubbed')
 		except I:pass
-		B.info=_info();A.info('Port: {}'.format(B.info[K]));A.info('Board: {}'.format(B.info[V]));F.collect()
+		B.info=_info();A.info('Port: {}'.format(B.info[L]));A.info('Board: {}'.format(B.info[U]));F.collect()
 		if C:B._fwid=C.lower()
-		elif B.info[Q]==v:B._fwid='{family}-v{version}-{port}-{board}'.format(**B.info).rstrip(W)
+		elif B.info[S]==u:B._fwid='{family}-v{version}-{port}-{board}'.format(**B.info).rstrip(V)
 		else:B._fwid='{family}-v{version}-{port}'.format(**B.info)
 		B._start_free=F.mem_free()
 		if path:
 			if path.endswith(G):path=path[:-1]
 		else:path=get_root()
 		B.path='{}/stubs/{}'.format(path,B.flat_fwid).replace('//',G)
-		try:Y(path+G)
+		try:X(path+G)
 		except D:A.error('error creating stub folder {}'.format(path))
 		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
 	def get_obj_attributes(L,item_instance):
@@ -94,17 +95,17 @@ class Stubber:
 			if A.startswith('__')and not A in L.modules:continue
 			try:
 				D=getattr(H,A)
-				try:E=c(type(D)).split("'")[1]
-				except U:E=B
-				if E in{w,x,y,z,f,g,h}:G=1
-				elif E in{A0,A1}:G=2
+				try:E=b(type(D)).split("'")[1]
+				except Q:E=B
+				if E in{v,w,x,y,e,f,g}:G=1
+				elif E in{z,A0}:G=2
 				elif E in'class':G=3
 				else:G=4
-				C.append((A,c(D),c(type(D)),D,G))
+				C.append((A,b(D),b(type(D)),D,G))
 			except I as J:K.append("Couldn't get attribute '{}' from object '{}', Err: {}".format(A,H,J))
-			except q as J:T('MemoryError: {}'.format(J));sleep(1);reset()
-		C=r([A for A in C if not A[0].startswith('__')],key=lambda x:x[4]);F.collect();return C,K
-	def add_modules(A,modules):A.modules=r(set(A.modules)|set(modules))
+			except p as J:P('MemoryError: {}'.format(J));sleep(1);reset()
+		C=q([A for A in C if not A[0].startswith('__')],key=lambda x:x[4]);F.collect();return C,K
+	def add_modules(A,modules):A.modules=q(set(A.modules)|set(modules))
 	def create_all_stubs(B):
 		A.info('Start micropython-stubber {} on {}'.format(__version__,B._fwid));B.report_start();F.collect()
 		for C in B.modules:B.create_one_stub(C)
@@ -113,60 +114,62 @@ class Stubber:
 		B=module_name
 		if B in C.problematic:A.warning('Skip module: {:<25}        : Known problematic'.format(B));return H
 		if B in C.excluded:A.warning('Skip module: {:<25}        : Excluded'.format(B));return H
-		I='{}/{}.pyi'.format(C.path,B.replace(J,G));F.collect();E=H
+		I='{}/{}.pyi'.format(C.path,B.replace(K,G));F.collect();E=H
 		try:E=C.create_module_stub(B,I)
 		except D:return H
 		F.collect();return E
-	def create_module_stub(K,module_name,file_name=E):
+	def create_module_stub(J,module_name,file_name=E):
 		I=file_name;C=module_name
-		if I is E:L=C.replace(J,'_')+'.pyi';I=K.path+G+L
+		if I is E:L=C.replace(K,'_')+'.pyi';I=J.path+G+L
 		else:L=I.split(G)[-1]
-		if G in C:C=C.replace(G,J)
+		if G in C:C=C.replace(G,K)
 		N=E
 		try:N=__import__(C,E,E,'*');Q=F.mem_free();A.info('Stub module: {:<25} to file: {:<70} mem:{:>5}'.format(C,L,Q))
 		except O:return H
-		Y(I)
-		with M(I,i)as P:T=d(K.info).replace('OrderedDict(',B).replace('})','}');U='"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(C,K._fwid,T,S);P.write(U);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)
-		K.report_add(C,I)
+		X(I)
+		with M(I,h)as P:R=c(J.info).replace('OrderedDict(',B).replace('})','}');S='"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(C,J._fwid,R,__version__);P.write(S);P.write('from __future__ import annotations\nfrom typing import Any, Generator\nfrom _typeshed import Incomplete\n\n');J.write_object_stub(P,N,C,B)
+		J.report_add(C,I)
 		if C not in{'os','sys','logging','gc'}:
 			try:del N
-			except(D,s):A.warning('could not del new_module')
-		F.collect();return R
+			except(D,r):A.warning('could not del new_module')
+		F.collect();return T
 	def write_object_stub(L,fp,object_expr,obj_name,indent,in_class=0):
-		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()
+		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;E=indent;F.collect()
 		if M in L.problematic:A.warning('SKIPPING problematic module:{}'.format(M));return
-		a,Q=L.get_obj_attributes(M)
-		if Q:A.error(Q)
-		for(E,H,I,b,d)in a:
-			if E in['classmethod','staticmethod','BaseException',N]:continue
-			if E[0].isdigit():A.warning('NameError: invalid name {}'.format(E));continue
-			if I=="<class 'type'>"and P(D)<=A5*4:
-				R=B;S=E.endswith(N)or E.endswith('Error')or E in['KeyboardInterrupt','StopIteration','SystemExit']
-				if S:R=N
-				C='\n{}class {}({}):\n'.format(D,E,R)
-				if S:C+=D+'    ...\n';J.write(C);continue
-				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)
-			elif any(A in I for A in[A1,A0,'closure']):
+		a,P=L.get_obj_attributes(M)
+		if P:A.error(P)
+		for(C,H,I,b,d)in a:
+			if C in['classmethod','staticmethod','BaseException',N]:continue
+			if C[0].isdigit():A.warning('NameError: invalid name {}'.format(C));continue
+			if I=="<class 'type'>"and R(E)<=A4*4:
+				Q=B;S=C.endswith(N)or C.endswith('Error')or C in['KeyboardInterrupt','StopIteration','SystemExit']
+				if S:Q=N
+				D='\n{}class {}({}):\n'.format(E,C,Q)
+				if S:D+=E+'    ...\n';J.write(D);continue
+				J.write(D);L.write_object_stub(J,b,'{0}.{1}'.format(obj_name,C),E+'    ',O+1);D=E+'    def __init__(self, *argv, **kwargs) -> None:\n';D+=E+'        ...\n\n';J.write(D)
+			elif any(A in I for A in[A0,z,'closure']):
 				T=V;U=B
 				if O>0:U='self, '
-				if W in I or W in H:C='{}@classmethod\n'.format(D)+'{}def {}(cls, *args, **kwargs) -> {}:\n'.format(D,E,T)
-				else:C='{}def {}({}*args, **kwargs) -> {}:\n'.format(D,E,U,T)
-				C+=D+'    ...\n\n';J.write(C)
+				if W in I or W in H:D='{}@classmethod\n'.format(E)+'{}def {}(cls, *args, **kwargs) -> {}:\n'.format(E,C,T)
+				else:D='{}def {}({}*args, **kwargs) -> {}:\n'.format(E,C,U,T)
+				D+=E+'    ...\n\n';J.write(D)
 			elif I=="<class 'module'>":0
 			elif I.startswith("<class '"):
-				G=I[8:-2];C=B
-				if G in(y,w,x,z,'bytearray','bytes'):C=X.format(D,E,H,G)
-				elif G in(h,g,f):c={h:'{}',g:'[]',f:'()'};C=X.format(D,E,c[G],G)
+				G=I[8:-2];D=B
+				if G in(x,v,w,y,'bytearray','bytes'):
+					if C.upper()==C:D='{0}{1}: Final[{3}] = {2}\n'.format(E,C,H,G)
+					else:D=X.format(E,C,H,G)
+				elif G in(g,f,e):c={g:'{}',f:'[]',e:'()'};D=X.format(E,C,c[G],G)
 				elif G in('object','set','frozenset','Pin',Y):
 					if G==Y:G='Generator'
-					C='{0}{1}: {2} ## = {4}\n'.format(D,E,G,I,H)
+					D='{0}{1}: {2} ## = {4}\n'.format(E,C,G,I,H)
 				else:
 					G=V
 					if K in H:H=H.split(K)[0]+Z
 					if K in H:H=H.split(K)[0]+Z
-					C='{0}{1}: {2} ## {3} = {4}\n'.format(D,E,G,I,H)
-				J.write(C)
-			else:J.write("# all other, type = '{0}'\n".format(I));J.write(D+E+' # type: Incomplete\n')
+					D='{0}{1}: {2} ## {3} = {4}\n'.format(E,C,G,I,H)
+				J.write(D)
+			else:J.write("# all other, type = '{0}'\n".format(I));J.write(E+C+' # type: Incomplete\n')
 	@property
 	def flat_fwid(self):
 		A=self._fwid;B=' .()/\\:$'
@@ -178,29 +181,29 @@ class Stubber:
 		try:os.stat(path);F=os.listdir(path)
 		except(D,I):return
 		for G in F:
-			B=j.format(path,G)
+			B=i.format(path,G)
 			try:os.remove(B)
 			except D:
 				try:C.clean(B);os.rmdir(B)
 				except D:pass
-	def report_start(B,filename=k):
-		H='firmware';B._json_name=j.format(B.path,filename);B._json_first=R;Y(B._json_name);A.info('Report file: {}'.format(B._json_name));F.collect()
+	def report_start(B,filename=j):
+		H='firmware';B._json_name=i.format(B.path,filename);B._json_first=T;X(B._json_name);A.info('Report file: {}'.format(B._json_name));F.collect()
 		try:
-			with M(B._json_name,i)as G:G.write('{');G.write(dumps({H:B.info})[1:-1]);G.write(l);G.write(dumps({u:{C:S},'stubtype':H})[1:-1]);G.write(l);G.write('"modules" :[\n')
-		except D as I:A.error(A2);B._json_name=E;raise I
+			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')
+		except D as I:A.error(A1);B._json_name=E;raise I
 	def report_add(B,module_name,stub_file):
-		if not B._json_name:raise t(A3)
+		if not B._json_name:raise s(A2)
 		try:
 			with M(B._json_name,'a')as C:
-				if not B._json_first:C.write(l)
+				if not B._json_first:C.write(k)
 				else:B._json_first=H
 				E='{{"module": "{}", "file": "{}"}}'.format(module_name,stub_file.replace('\\',G));C.write(E)
-		except D:A.error(A2)
+		except D:A.error(A1)
 	def report_end(B):
-		if not B._json_name:raise t(A3)
+		if not B._json_name:raise s(A2)
 		with M(B._json_name,'a')as C:C.write('\n]}')
 		A.info('Path: {}'.format(B.path))
-def Y(path):
+def X(path):
 	B=E=0
 	while B!=-1:
 		B=path.find(G,E)
@@ -208,57 +211,59 @@ def Y(path):
 			C=path[0]if B==0 else path[:B]
 			try:I=os.stat(C)
 			except D as F:
-				if F.args[0]==A4:
-					try:os.mkdir(C)
+				if F.args[0]==A3:
+					try:A.debug('Create folder {}'.format(C));os.mkdir(C)
 					except D as H:A.error('failed to create folder {}'.format(C));raise H
 		E=B+1
-def Z(s):
+def Y(s):
 	C=' on '
 	if not s:return B
 	s=s.split(C,1)[0]if C in s else s
 	if s.startswith('v'):
-		if not W in s:return B
-		A=s.split(W)[1];return A
-	if not X in s:return B
-	A=s.split(X)[1].split(J)[1];return A
+		if not V in s:return B
+		A=s.split(V)[1];return A
+	if not W in s:return B
+	A=s.split(W)[1].split(K)[1];return A
 def _info():
-	b='ev3-pybricks';a='pycom';Y='pycopy';W='unix';T='win32';R='arch';P='cpu';M='ver';F='mpy';D='build'
-	try:H=sys.implementation[0]
-	except e:H=sys.implementation.name
-	A=m({Q:H,C:B,D:B,M:B,K:sys.platform,V:'UNKNOWN',P:B,F:B,R:B})
-	if A[K].startswith('pyb'):A[K]='stm32'
-	elif A[K]==T:A[K]='windows'
-	elif A[K]=='linux':A[K]=W
-	try:A[C]=S(sys.implementation.version)
+	a='ev3-pybricks';Z='pycom';X='pycopy';V='unix';T='win32';R='arch';P='cpu';M='ver';F='mpy';D='build'
+	try:J=sys.implementation[0]
+	except d:J=sys.implementation.name
+	A=l({S:J,C:B,D:B,M:B,L:sys.platform,U:'UNKNOWN',P:B,F:B,R:B})
+	if A[L].startswith('pyb'):A[L]='stm32'
+	elif A[L]==T:A[L]='windows'
+	elif A[L]=='linux':A[L]=V
+	try:A[C]=A6(sys.implementation.version)
 	except I:pass
-	try:J=sys.implementation._machine if'_machine'in N(sys.implementation)else os.uname().machine;A[V]=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
-	except(I,U):pass
-	A[V]=A7()
+	try:K=sys.implementation._machine if'_machine'in N(sys.implementation)else os.uname().machine;A[U]=K;A[P]=K.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
+	except(I,Q):pass
+	A[U]=A7()
 	try:
 		if'uname'in N(os):
-			A[D]=Z(os.uname()[3])
-			if not A[D]:A[D]=Z(os.uname()[2])
-		elif C in N(sys):A[D]=Z(sys.version)
-	except(I,U,e):pass
-	if A[C]==B and sys.platform not in(W,T):
-		try:c=os.uname();A[C]=c.release
-		except(U,I,e):pass
-	for(d,f,g)in[(Y,Y,'const'),(a,a,'FAT'),(b,'pybricks.hubs','EV3Brick')]:
-		try:h=__import__(f,E,E,g);A[Q]=d;del h;break
-		except(O,s):pass
-	if A[Q]==b:A['release']='2.0.0'
-	if A[Q]==v:
+			A[D]=Y(os.uname()[3])
+			if not A[D]:A[D]=Y(os.uname()[2])
+		elif C in N(sys):A[D]=Y(sys.version)
+	except(I,Q,d):pass
+	if A[C]==B and sys.platform not in(V,T):
+		try:b=os.uname();A[C]=b.release
+		except(Q,I,d):pass
+	for(c,e,f)in[(X,X,'const'),(Z,Z,'FAT'),(a,'pybricks.hubs','EV3Brick')]:
+		try:g=__import__(e,E,E,f);A[S]=c;del g;break
+		except(O,r):pass
+	if A[S]==a:A['release']='2.0.0'
+	if A[S]==u:
 		A[C]
 		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]
 	if F in A and A[F]:
-		G=int(A[F]);L=[E,'x86','x64','armv6','armv6m','armv7m','armv7em','armv7emsp','armv7emdp','xtensa','xtensawin'][G>>10]
-		if L:A[R]=L
+		G=int(A[F])
+		try:H=[E,'x86','x64','armv6','armv6m','armv7m','armv7em','armv7emsp','armv7emdp','xtensa','xtensawin','rv32imc'][G>>10]
+		except Q:H='unknown'
+		if H:A[R]=H
 		A[F]='v{}.{}'.format(G&255,G>>8&3)
-	if A[D]and not A[C].endswith(X):A[C]=A[C]+X
+	if A[D]and not A[C].endswith(W):A[C]=A[C]+W
 	A[M]=f"{A[C]}-{A[D]}"if A[D]else f"{A[C]}";return A
-def S(version):
-	A=version;B=J.join([d(A)for A in A[:3]])
-	if P(A)>3 and A[3]:B+=W+A[3]
+def A6(version):
+	A=version;B=K.join([c(A)for A in A[:3]])
+	if R(A)>3 and A[3]:B+=V+A[3]
 	return B
 def A7():
 	try:from boardname import BOARDNAME as C;A.info('Found BOARDNAME: {}'.format(C))
@@ -266,68 +271,69 @@ def A7():
 	return C
 def get_root():
 	try:A=os.getcwd()
-	except(D,I):A=J
+	except(D,I):A=K
 	B=A
-	for B in[A,'/sd','/flash',G,J]:
+	for B in['/remote','/sd','/flash',G,A,K]:
 		try:C=os.stat(B);break
 		except D:continue
 	return B
-def a(filename):
+def Z(filename):
 	try:
-		if os.stat(filename)[0]>>14:return R
+		if os.stat(filename)[0]>>14:return T
 		return H
 	except D:return H
-def n():T("-p, --path   path to store the stubs in, defaults to '.'");sys.exit(1)
+def m():P("-p, --path   path to store the stubs in, defaults to '.'");sys.exit(1)
 def read_path():
 	path=B
-	if P(sys.argv)==3:
+	if R(sys.argv)==3:
 		A=sys.argv[1].lower()
 		if A in('--path','-p'):path=sys.argv[2]
-		else:n()
-	elif P(sys.argv)==2:n()
+		else:m()
+	elif R(sys.argv)==2:m()
 	return path
-def o():
-	try:A=bytes('abc',encoding='utf8');B=o.__module__;return H
-	except(p,I):return R
-b='modulelist.done'
+def n():
+	try:A=bytes('abc',encoding='utf8');B=n.__module__;return H
+	except(o,I):return T
+a='modulelist.done'
 def A8(skip=0):
-	for E in A6:
+	for E in A5:
 		B=E+'/modulelist.txt'
-		if not a(B):continue
+		if not Z(B):continue
 		try:
 			with M(B)as F:
 				C=0
-				while R:
+				while T:
 					A=F.readline().strip()
 					if not A:break
-					if P(A)>0 and A[0]=='#':continue
+					if R(A)>0 and A[0]=='#':continue
 					C+=1
 					if C<skip:continue
 					yield A
 				break
 		except D:pass
 def A9(done):
-	with M(b,i)as A:A.write(d(done)+'\n')
+	with M(a,h)as A:A.write(c(done)+'\n')
 def AA():
 	A=0
 	try:
-		with M(b)as B:A=int(B.readline().strip())
+		with M(a)as B:A=int(B.readline().strip())
 	except D:pass
 	return A
 def main():
-	import machine as D;C=a(b)
+	import machine as D;C=Z(a)
 	if C:A.info('Continue from last run')
 	else:A.info('Starting new run')
 	stubber=Stubber(path=read_path());B=0
-	if not C:stubber.clean();stubber.report_start(k)
-	else:B=AA();stubber._json_name=j.format(stubber.path,k)
+	if not C:stubber.clean();stubber.report_start(j)
+	else:B=AA();stubber._json_name=i.format(stubber.path,j)
 	for E in A8(B):
 		try:stubber.create_one_stub(E)
-		except q:D.reset()
+		except p:D.reset()
 		F.collect();B+=1;A9(B)
-	T('All modules have been processed, Finalizing report');stubber.report_end()
-if __name__=='__main__'or o():
-	if not a('no_auto_stubber.txt'):
-		try:F.threshold(4*1024);F.enable()
+	P('All modules have been processed, Finalizing report');stubber.report_end()
+if __name__=='__main__'or n():
+	if not Z('no_auto_stubber.txt'):
+		P(f"createstubs.py: {__version__}")
+		try:F.threshold(4096);F.enable()
 		except BaseException:pass
 		main()

stubber/board/createstubs_mem.py

@@ -9,7 +9,7 @@
     - cross compilation, using mpy-cross, 
       to avoid the compilation step on the micropython device 
 
-This variant was generated from createstubs.py by micropython-stubber v1.23.2
+This variant was generated from createstubs.py by micropython-stubber v1.24.0
 """
 
 # Copyright (c) 2019-2024 Jos Verlinde
@@ -34,8 +34,7 @@ try:
 except ImportError:
     from ucollections import OrderedDict  # type: ignore
 
-__version__ = "v1.23.2"
-version_str = __version__.rsplit(".", 1)[0]
+__version__ = "v1.24.0"
 ENOENT = 2
 _MAX_CLASS_LEVEL = 2  # Max class nesting
 LIBS = ["lib", "/lib", "/sd/lib", "/flash/lib", "."]
@@ -43,7 +42,7 @@ LIBS = ["lib", "/lib", "/sd/lib", "/flash/lib", "."]
 
 # our own logging module to avoid dependency on and interfering with logging module
 class logging:
-    # DEBUG = 10
+    DEBUG = 10
     INFO = 20
     WARNING = 30
     ERROR = 40
@@ -58,9 +57,9 @@ class logging:
     def basicConfig(cls, level):
         cls.level = level
 
-    # def debug(self, msg):
-    #     if self.level <= logging.DEBUG:
-    #         self.prnt("DEBUG :", msg)
+    def debug(self, msg):
+        if self.level <= logging.DEBUG:
+            self.prnt("DEBUG :", msg)
 
     def info(self, msg):
         if self.level <= logging.INFO:
@@ -236,10 +235,11 @@ class Stubber:
             return False
 
         # Start a new file
+        # log.debug("Create file: {}".format(file_name))
         ensure_folder(file_name)
         with open(file_name, "w") as fp:
             info_ = str(self.info).replace("OrderedDict(", "").replace("})", "}")
-            s = '"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(module_name, self._fwid, info_, version_str)
+            s = '"""\nModule: \'{0}\' on {1}\n"""\n# MCU: {2}\n# Stubber: {3}\n'.format(module_name, self._fwid, info_, __version__)
             fp.write(s)
             fp.write("from __future__ import annotations\nfrom typing import Any, Generator\nfrom _typeshed import Incomplete\n\n")
             self.write_object_stub(fp, new_module, module_name, "")
@@ -349,8 +349,10 @@ class Stubber:
 
                 if t in ("str", "int", "float", "bool", "bytearray", "bytes"):
                     # known type: use actual value
-                    # s = "{0}{1} = {2} # type: {3}\n".format(indent, item_name, item_repr, t)
-                    s = "{0}{1}: {3} = {2}\n".format(indent, item_name, item_repr, t)
+                    if item_name.upper() == item_name:  # ALL_CAPS --> Final
+                        s = "{0}{1}: Final[{3}] = {2}\n".format(indent, item_name, item_repr, t)
+                    else:
+                        s = "{0}{1}: {3} = {2}\n".format(indent, item_name, item_repr, t)
                 elif t in ("dict", "list", "tuple"):
                     # dict, list , tuple: use empty value
                     ev = {"dict": "{}", "list": "[]", "tuple": "()"}
@@ -434,7 +436,7 @@ class Stubber:
                 f.write("{")
                 f.write(dumps({"firmware": self.info})[1:-1])
                 f.write(",\n")
-                f.write(dumps({"stubber": {"version": version_str}, "stubtype": "firmware"})[1:-1])
+                f.write(dumps({"stubber": {"version": __version__}, "stubtype": "firmware"})[1:-1])
                 f.write(",\n")
                 f.write('"modules" :[\n')
 
@@ -483,6 +485,7 @@ def ensure_folder(path: str):
                 # folder does not exist
                 if e.args[0] == ENOENT:
                     try:
+                        log.debug("Create folder {}".format(p))
                         os.mkdir(p)
                     except OSError as e2:
                         log.error("failed to create folder {}".format(p))
@@ -493,7 +496,7 @@ def ensure_folder(path: str):
 
 def _build(s):
     # extract build from sys.version or os.uname().version if available
-    # sys.version: 'MicroPython v1.23.2-preview.6.g3d0b6276f'
+    # sys.version: 'MicroPython v1.24.0-preview.6.g3d0b6276f'
     # sys.implementation.version: 'v1.13-103-gb137d064e'
     if not s:
         return ""
@@ -598,29 +601,33 @@ def _info():  # type:() -> dict[str, str]
         if (
             info["version"]
             and info["version"].endswith(".0")
-            and info["version"] >= "1.10.0"  # versions from 1.10.0 to 1.23.2 do not have a micro .0
+            and info["version"] >= "1.10.0"  # versions from 1.10.0 to 1.24.0 do not have a micro .0
             and info["version"] <= "1.19.9"
         ):
-            # versions from 1.10.0 to 1.23.2 do not have a micro .0
+            # versions from 1.10.0 to 1.24.0 do not have a micro .0
             info["version"] = info["version"][:-2]
 
     # spell-checker: disable
     if "mpy" in info and info["mpy"]:  # mpy on some v1.11+ builds
         sys_mpy = int(info["mpy"])
         # .mpy architecture
-        arch = [
-            None,
-            "x86",
-            "x64",
-            "armv6",
-            "armv6m",
-            "armv7m",
-            "armv7em",
-            "armv7emsp",
-            "armv7emdp",
-            "xtensa",
-            "xtensawin",
-        ][sys_mpy >> 10]
+        try:
+            arch = [
+                None,
+                "x86",
+                "x64",
+                "armv6",
+                "armv6m",
+                "armv7m",
+                "armv7em",
+                "armv7emsp",
+                "armv7emdp",
+                "xtensa",
+                "xtensawin",
+                "rv32imc",
+            ][sys_mpy >> 10]
+        except IndexError:
+            arch = "unknown"
         if arch:
             info["arch"] = arch
         # .mpy version.minor
@@ -660,7 +667,7 @@ def get_root() -> str:  # sourcery skip: use-assigned-variable
         # unix port
         c = "."
     r = c
-    for r in [c, "/sd", "/flash", "/", "."]:
+    for r in ["/remote", "/sd", "/flash", "/", c, "."]:
         try:
             _ = os.stat(r)
             break
@@ -759,6 +766,7 @@ def main():
 
 if __name__ == "__main__" or is_micropython():
     if not file_exists("no_auto_stubber.txt"):
+        print(f"createstubs.py: {__version__}")
         try:
             gc.threshold(4 * 1024)  # type: ignore
             gc.enable()