Az alapnyelv¶
Generated Fri 19 Jun 2026 22:08:45 UTC
Osztályok¶
A __del__ speciális metódus nincs megvalósítva felhasználó által definiált osztályokhoz¶
Mintakód:
import gc
class Foo:
def __del__(self):
print("__del__")
f = Foo()
del f
gc.collect()
CPython output: | MicroPython output: |
__del__
|
__init_subclass__ isn’t automatically called.¶
Cause: MicroPython does not currently implement PEP 487.
Workaround: Manually call __init_subclass__ after class creation if needed. e.g.:
class A(Base):
pass
A.__init_subclass__()
Mintakód:
class Base:
@classmethod
def __init_subclass__(cls):
print(f"Base.__init_subclass__({cls.__name__})")
class A(Base):
pass
CPython output: | MicroPython output: |
Base.__init_subclass__(A)
|
__init_subclass__ isn’t an implicit classmethod.¶
Cause: MicroPython does not currently implement PEP 487. __init_subclass__ is not currently in the list of special-cased class/static methods.
Workaround: Decorate declarations of __init_subclass__ with @classmethod.
Mintakód:
def regularize_spelling(text, prefix="bound_"):
# for regularizing across the CPython "method" vs MicroPython "bound_method" spelling for the type of a bound classmethod
if text.startswith(prefix):
return text[len(prefix) :]
return text
class A:
def __init_subclass__(cls):
pass
@classmethod
def manual_decorated(cls):
pass
a = type(A.__init_subclass__).__name__
b = type(A.manual_decorated).__name__
print(regularize_spelling(a))
print(regularize_spelling(b))
if a != b:
print("FAIL")
CPython output: | MicroPython output: |
method
method
| function
method
FAIL
|
MicroPython doesn’t support parameterized __init_subclass__ class customization.¶
Cause: MicroPython does not currently implement PEP 487. The MicroPython syntax tree does not include a kwargs node after the class inheritance list.
Workaround: Use class variables or another mechanism to specify base-class customizations.
Mintakód:
class Base:
@classmethod
def __init_subclass__(cls, arg=None, **kwargs):
cls.init_subclass_was_called = True
print(f"Base.__init_subclass__({cls.__name__}, {arg=!r}, {kwargs=!r})")
class A(Base, arg="arg"):
pass
# Regularize across MicroPython not automatically calling __init_subclass__ either.
if not getattr(A, "init_subclass_was_called", False):
A.__init_subclass__()
CPython output: | MicroPython output: |
Base.__init_subclass__(A, arg='arg', kwargs={})
| Traceback (most recent call last):
File "<stdin>", line 16, in <module>
TypeError: function doesn't take keyword arguments
|
__init_subclass__ can’t be defined a cooperatively-recursive way.¶
Cause: MicroPython does not currently implement PEP 487. The base object type does not have an __init_subclass__ implementation.
Workaround: Omit the recursive __init_subclass__ call unless it’s known that the grandparent also defines it.
Mintakód:
class Base:
@classmethod
def __init_subclass__(cls, **kwargs):
cls.init_subclass_was_called = True
super().__init_subclass__(**kwargs)
class A(Base):
pass
# Regularize across MicroPython not automatically calling __init_subclass__ either.
if not getattr(A, "init_subclass_was_called", False):
A.__init_subclass__()
CPython output: | MicroPython output: |
Traceback (most recent call last):
File "<stdin>", line 22, in <module>
File "<stdin>", line 13, in __init_subclass__
AttributeError: 'super' object has no attribute '__init_subclass__'
|
A metódusfeloldási sorrend (MRO) nem felel meg a CPython-nak¶
Ok: Mélység-először, nem kimerítő metódusfeloldási sorrend
Megkerülés: Kerülje a többszörös öröklődéssel és összetett metódus-felüldefiniálással rendelkező bonyolult osztályhierarchiákat. Tartsa szem előtt, hogy sok nyelv egyáltalán nem támogatja a többszörös öröklődést.
Mintakód:
class Foo:
def __str__(self):
return "Foo"
class C(tuple, Foo):
pass
t = C((1, 2, 3))
print(t)
CPython output: | MicroPython output: |
Foo
| (1, 2, 3)
|
A privát osztálytagok névcsúfítása nincs megvalósítva¶
Ok: A MicroPython fordító nem valósítja meg a névcsúfítást a privát osztálytagokhoz.
Megkerülés: Kerülje a globális nevekkel való ütközést úgy, hogy manuálisan egyedi előtagot ad a privát osztálytag nevéhez.
Mintakód:
def __print_string(string):
print(string)
class Foo:
def __init__(self, string):
self.string = string
def do_print(self):
__print_string(self.string)
example_string = "Example String to print."
class_item = Foo(example_string)
print(class_item.string)
class_item.do_print()
CPython output: | MicroPython output: |
Example String to print.
Traceback (most recent call last):
File "<stdin>", line 26, in <module>
File "<stdin>", line 18, in do_print
NameError: name '_Foo__print_string' is not defined. Did you mean: '__print_string'?
| Example String to print.
Example String to print.
|
Natív típusok öröklésekor egy metódus hívása a __init__(self, ...)-ban a super().__init__() előtt AttributeError-t vált ki (vagy segfault-ot okoz, ha a MICROPY_BUILTIN_METHOD_CHECK_SELF_ARG nincs engedélyezve).¶
Ok: A MicroPython natív típusaiban nincs különálló __new__ és __init__ metódus.
Megkerülés: Először hívja a super().__init__()-t.
Mintakód:
class L1(list):
def __init__(self, a):
self.append(a)
try:
L1(1)
print("OK")
except AttributeError:
print("AttributeError")
class L2(list):
def __init__(self, a):
super().__init__()
self.append(a)
try:
L2(1)
print("OK")
except AttributeError:
print("AttributeError")
CPython output: | MicroPython output: |
OK
OK
| AttributeError
OK
|
Több osztályból való öröklésnél a super() csak egy osztályt hív meg¶
Ok: Lásd: A metódusfeloldási sorrend (MRO) nem felel meg a CPython-nak
Megkerülés: Lásd: A metódusfeloldási sorrend (MRO) nem felel meg a CPython-nak
Mintakód:
class A:
def __init__(self):
print("A.__init__")
class B(A):
def __init__(self):
print("B.__init__")
super().__init__()
class C(A):
def __init__(self):
print("C.__init__")
super().__init__()
class D(B, C):
def __init__(self):
print("D.__init__")
super().__init__()
D()
CPython output: | MicroPython output: |
D.__init__
B.__init__
C.__init__
A.__init__
| D.__init__
B.__init__
A.__init__
|
A super() getter property hívása alosztályban property objektumot ad vissza, nem az értéket¶
Mintakód:
class A:
@property
def p(self):
return {"a": 10}
class AA(A):
@property
def p(self):
return super().p
a = AA()
print(a.p)
CPython output: | MicroPython output: |
{'a': 10}
| <property>
|
Exceptions¶
Throwing a derived exception class instance in its __init__ without first calling super().__init__ is a TypeError¶
Cause: In MicroPython, an object is incompletely constructed if it does not call its superclass init function or return normally from its __init__. This prevents its usage in some circumstances.
Workaround: Call the superclass __init__ method before raising the exception.
Mintakód:
class C(Exception):
def __init__(self):
raise self
class C1(Exception):
def __init__(self):
super().__init__()
raise self
try:
C()
except Exception as e:
print(type(e).__name__)
try:
C1()
except Exception as e:
print(type(e).__name__)
CPython output: | MicroPython output: |
C
C1
| TypeError
C1
|
Függvények¶
A metódusok hibaüzenetei váratlan argumentumszámot jeleníthetnek meg¶
Ok: A MicroPython a „self”-et argumentumként számolja.
Megkerülés: A hibaüzeneteket a fenti információ figyelembevételével értelmezze.
Mintakód:
try:
[].append()
except Exception as e:
print(e)
CPython output: | MicroPython output: |
list.append() takes exactly one argument (0 given)
| function takes 2 positional arguments but 1 were given
|
A függvényobjektumoknak nincs __module__ attribútumuk¶
Ok: A MicroPython a kisebb kódméret és RAM-használat érdekében van optimalizálva.
Megkerülés: Nem beépített moduloknál használja a sys.modules[function.__globals__['__name__']] kifejezést.
Mintakód:
def f():
pass
print(f.__module__)
CPython output: | MicroPython output: |
__main__
| Traceback (most recent call last):
File "<stdin>", line 13, in <module>
AttributeError: 'function' object has no attribute '__module__'
|
A függvények felhasználó által definiált attribútumai nem támogatottak¶
Ok: A MicroPython erősen optimalizált a memóriahasználat szempontjából.
Megkerülés: Használjon külső szótárt, pl. FUNC_X[f] = 0.
Mintakód:
def f():
pass
f.x = 0
print(f.x)
CPython output: | MicroPython output: |
0
| Traceback (most recent call last):
File "<stdin>", line 13, in <module>
AttributeError: 'function' object has no attribute 'x'
|
Generátor¶
A kontextuskezelő __exit__()-ja nem hívódik meg olyan generátorban, amely nem fut le teljesen¶
Mintakód:
class foo(object):
def __enter__(self):
print("Enter")
def __exit__(self, *args):
print("Exit")
def bar(x):
with foo():
while True:
x += 1
yield x
def func():
g = bar(0)
for _ in range(3):
print(next(g))
func()
CPython output: | MicroPython output: |
Enter
1
2
3
Exit
| Enter
1
2
3
|
Futtatókörnyezet¶
A helyi változók nem szerepelnek a locals() eredményében¶
Ok: A MicroPython nem tart fenn szimbolikus helyi környezetet, hanem egy résidőkeret-tömbre van optimalizálva. Ezért a helyi változók névvel nem érhetők el.
Mintakód:
def test():
val = 2
print(locals())
test()
CPython output: | MicroPython output: |
{'val': 2}
| {'test': <function test at 0x7f5d74c05260>, '__name__': '__main__', '__file__': '<stdin>'}
|
Az eval() függvényben futó kód nem fér hozzá a helyi változókhoz¶
Ok: A MicroPython nem tart fenn szimbolikus helyi környezetet, hanem egy résidőkeret-tömbre van optimalizálva. Ezért a helyi változók névvel nem érhetők el. A MicroPythonban az eval(expr) gyakorlatilag egyenértékű az eval(expr, globals(), globals()) hívással.
Mintakód:
val = 1
def test():
val = 2
print(val)
eval("print(val)")
test()
CPython output: | MicroPython output: |
2
2
| 2
1
|
f-strings¶
Az f-stringek nem támogatják a szomszédos literálokkal való összefűzést, ha a szomszédos literálok kapcsos zárójeleket tartalmaznak¶
Ok: A MicroPython a kódterület optimalizálására van tervezve.
Megkerülés: Használja a + operátort literál stringek között, ha nem mindkettő f-string
Mintakód:
x, y = 1, 2
print("aa" f"{x}") # works
print(f"{x}" "ab") # works
print("a{}a" f"{x}") # fails
print(f"{x}" "a{}b") # fails
CPython output: | MicroPython output: |
aa1
1ab
a{}a1
1a{}b
| aa1
1ab
Traceback (most recent call last):
File "<stdin>", line 12, in <module>
IndexError: tuple index out of range
|
Az f-stringek nem támogatnak olyan kifejezéseket, amelyek elemzése kiegyensúlyozatlan egymásba ágyazott kapcsos és szögletes zárójelek feloldását igényli¶
Ok: A MicroPython a kódterület optimalizálására van tervezve.
Megkerülés: Mindig használjon kiegyensúlyozott kapcsos és szögletes zárójeleket az f-stringeken belüli kifejezésekben
Mintakód:
print(f"{'hello { world'}")
print(f"{'hello ] world'}")
CPython output: | MicroPython output: |
hello { world
hello ] world
| Traceback (most recent call last):
File "<stdin>", line 9
SyntaxError: invalid syntax
|
Az f-stringek nem támogatják a !a konverziókat¶
Ok: A MicroPython nem valósítja meg az ascii() függvényt
Megkerülés: Nincs
Mintakód:
f"{'unicode text'!a}"
CPython output: | MicroPython output: |
Traceback (most recent call last):
File "<stdin>", line 8
SyntaxError: invalid syntax
|
import¶
Egy csomag __path__ attribútuma eltérő típusú MicroPythonban (egyetlen string a stringek listája helyett)¶
Ok: A MicroPython nem támogatja a fájlrendszerben szétterülő névtércsomagokat. Ezen túlmenően a MicroPython importrendszere erősen optimalizált a minimális memóriahasználat érdekében.
Megkerülés: Az importkezelés részletei alapvetően implementációfüggők. Ne támaszkodjon ilyen részletekre hordozható alkalmazásokban.
Mintakód:
import modules
print(modules.__path__)
CPython output: | MicroPython output: |
['/home/runner/work/openmv-doc/openmv-doc/micropython/tests/cpydiff/modules']
| ../tests/cpydiff/modules
|
A MicroPython nem támogatja a fájlrendszerben szétterülő névtércsomagokat.¶
Ok: A MicroPython importrendszere erősen optimalizált az egyszerűség, a minimális memóriahasználat és a minimális fájlrendszer-keresési terhelés érdekében.
Megkerülés: Ne telepítsen ugyanazon névtércsomaghoz tartozó modulokat különböző könyvtárakba. MicroPythonhoz ajánlott legfeljebb 3 összetevőjű modulkeresési útvonalat megadni: a jelenlegi alkalmazáshoz, felhasználónként (írható) és rendszerszinten (nem írható).
Mintakód:
import sys
sys.path.append(sys.path[1] + "/modules")
sys.path.append(sys.path[1] + "/modules2")
import subpkg.foo
import subpkg.bar
print("Two modules of a split namespace package imported")
CPython output: | MicroPython output: |
Two modules of a split namespace package imported
| Traceback (most recent call last):
File "<stdin>", line 14, in <module>
ImportError: no module named 'subpkg.bar'
|