Moduly¶

Generated Fri 19 Jun 2026 22:08:45 UTC

Pouze poziční parametry¶

Aby se ušetřilo místo v kódu, mnoho funkcí, které v CPython přijímají klíčové argumenty, přijímá v MicroPython pouze poziční argumenty.

MicroPython označuje pouze poziční parametry stejným způsobem jako CPython, vložením / k označení konce pozičních parametrů. Každá funkce, jejíž signatura končí /, přijímá pouze poziční argumenty. Podrobnosti viz PEP 570.

Příklad¶

Například v CPython 3.4 je toto signatura konstruktoru socket.socket:

socket.socket(family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None)

Signatura dokumentovaná v MicroPython je však:

socket(af=AF_INET, type=SOCK_STREAM, proto=IPPROTO_TCP, /)

Znak / na konci parametrů označuje, že jsou všechny v MicroPython pouze poziční. Následující kód funguje v CPython, ale ne ve většině portů MicroPython:

import socket
s = socket.socket(type=socket.SOCK_DGRAM)

MicroPython vyvolá výjimku:

TypeError: function doesn't take keyword arguments

Následující kód bude fungovat jak v CPython, tak v MicroPython:

import socket
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)

array¶

Porovnání mezi různými typovými kódy není podporováno¶

Příčina: Velikost kódu

Řešení: Porovnejte jednotlivé prvky

Ukázkový kód:

import array

array.array("b", [1, 2]) == array.array("i", [1, 2])

CPython output:	MicroPython output:
	Traceback (most recent call last): File "<stdin>", line 10, in <module> NotImplementedError:

Kontrola přetečení není implementována¶

Příčina: MicroPython implementuje implicitní zkrácení za účelem snížení velikosti kódu a doby provádění

Řešení: Pokud je potřebná kompatibilita s CPython, maskujte hodnotu explicitně

Ukázkový kód:

import array

a = array.array("b", [257])
print(a)

CPython output:	MicroPython output:
Traceback (most recent call last): File "<stdin>", line 10, in <module> OverflowError: signed char is greater than maximum	array('b', [1])

Vyhledávání celého čísla není implementováno¶

Ukázkový kód:

import array

print(1 in array.array("B", b"12"))

CPython output:	MicroPython output:
False	Traceback (most recent call last): File "<stdin>", line 10, in <module> NotImplementedError:

Mazání pole není implementováno¶

Ukázkový kód:

import array

a = array.array("b", (1, 2, 3))
del a[1]
print(a)

CPython output:	MicroPython output:
array('b', [1, 3])	Traceback (most recent call last): File "<stdin>", line 11, in <module> TypeError: 'array' object doesn't support item deletion

Indexování s krokem != 1 zatím není implementováno¶

Ukázkový kód:

import array

a = array.array("b", (1, 2, 3))
print(a[3:2:2])

CPython output:	MicroPython output:
array('b')	Traceback (most recent call last): File "<stdin>", line 11, in <module> NotImplementedError: only slices with step=1 (aka None) are supported

errno¶

MicroPython does not include `ENOTSUP` as a name for errno 95.¶

Cause: MicroPython does not implement the ENOTSUP canonical alias for EOPNOTSUPP added in CPython 3.2.

Workaround: Use errno.EOPNOTSUPP in place of errno.ENOTSUP.

Ukázkový kód:

import errno

print(f"{errno.errorcode[errno.EOPNOTSUPP]=!s}")

CPython output:	MicroPython output:
errno.errorcode[errno.EOPNOTSUPP]=ENOTSUP	errno.errorcode[errno.EOPNOTSUPP]=EOPNOTSUPP

json¶

Modul JSON nevyvolá výjimku, pokud objekt není serializovatelný¶

Ukázkový kód:

import json

try:
    print(json.dumps(b"shouldn't be able to serialise bytes"))
except TypeError:
    print("TypeError")

CPython output:	MicroPython output:
TypeError	"shouldn't be able to serialise bytes"

os¶

Atribut `environ` není implementován¶

Řešení: Použijte getenv, putenv a unsetenv

Ukázkový kód:

import os

try:
    print(os.environ.get("NEW_VARIABLE"))
    os.environ["NEW_VARIABLE"] = "VALUE"
    print(os.environ["NEW_VARIABLE"])
except AttributeError:
    print("should not get here")
    print(os.getenv("NEW_VARIABLE"))
    os.putenv("NEW_VARIABLE", "VALUE")
    print(os.getenv("NEW_VARIABLE"))

CPython output:	MicroPython output:
None VALUE	should not get here None VALUE

`getenv` vrací skutečnou hodnotu místo hodnoty z mezipaměti¶

Příčina: Atribut environ není implementován

Ukázkový kód:

import os

print(os.getenv("NEW_VARIABLE"))
os.putenv("NEW_VARIABLE", "VALUE")
print(os.getenv("NEW_VARIABLE"))

CPython output:	MicroPython output:
None None	None VALUE

random¶

Metoda `getrandbits` může vrátit nejvýše 32 bitů najednou.¶

Příčina: Vnitřní stav PRNG je pouze 32bitový, takže může vrátit nejvýše 32 bitů dat najednou.

Řešení: Pokud potřebujete číslo s více než 32 bity, použijte modul random z micropython-lib.

Ukázkový kód:

import random


x = random.getrandbits(64)
print("{}".format(x))

CPython output:	MicroPython output:
10880755926996596610	Traceback (most recent call last): File "<stdin>", line 11, in <module> ValueError: bits must be 32 or less

Metoda `randint` může vrátit pouze celé číslo nejvýše nativní velikosti slova.¶

Příčina: PRNG je schopen generovat pouze 32 bitů stavu najednou. Výsledek je pak přetypován na nativní int místo plného objektu int.

Řešení: Pokud potřebujete celá čísla větší než nativní velikost slova, použijte modul random z micropython-lib.

Ukázkový kód:

import random


x = random.randint(2**128 - 1, 2**128)
print("x={}".format(x))

CPython output:	MicroPython output:
x=340282366920938463463374607431768211456	Traceback (most recent call last): File "<stdin>", line 11, in <module> OverflowError: overflow converting long int to machine word

struct¶

Struct pack with too few args, not checked by MicroPython¶

Ukázkový kód:

import struct

try:
    print(struct.pack("bb", 1))
    print("Should not get here")
except:
    print("struct.error")

CPython output:	MicroPython output:
struct.error	b'\x01\x00' Should not get here

Struct pack with too many args, not checked by MicroPython¶

Ukázkový kód:

import struct

try:
    print(struct.pack("bb", 1, 2, 3))
    print("Should not get here")
except:
    print("struct.error")

CPython output:	MicroPython output:
struct.error	b'\x01\x02' Should not get here

Struct pack with whitespace in format, whitespace ignored by CPython, error on MicroPython¶

Příčina: MicroPython je optimalizován pro velikost kódu.

Řešení: Nepoužívejte mezery ve formátovacích řetězcích.

Ukázkový kód:

import struct

try:
    print(struct.pack("b b", 1, 2))
    print("Should have worked")
except:
    print("struct.error")

CPython output:	MicroPython output:
b'\x01\x02' Should have worked	struct.error

sys¶

Přepisování sys.stdin, sys.stdout a sys.stderr není možné¶

Příčina: Jsou uloženy v paměti pouze pro čtení.

Ukázkový kód:

import sys

sys.stdin = None
print(sys.stdin)

CPython output:	MicroPython output:
None	Traceback (most recent call last): File "<stdin>", line 10, in <module> AttributeError: 'module' object has no attribute 'stdin'

Moduly¶

Pouze poziční parametry¶

Příklad¶

array¶

Porovnání mezi různými typovými kódy není podporováno¶

Kontrola přetečení není implementována¶

Vyhledávání celého čísla není implementováno¶

Mazání pole není implementováno¶

Indexování s krokem != 1 zatím není implementováno¶

errno¶

MicroPython does not include ENOTSUP as a name for errno 95.¶

json¶

Modul JSON nevyvolá výjimku, pokud objekt není serializovatelný¶

os¶

Atribut environ není implementován¶

getenv vrací skutečnou hodnotu místo hodnoty z mezipaměti¶

random¶

Metoda getrandbits může vrátit nejvýše 32 bitů najednou.¶

Metoda randint může vrátit pouze celé číslo nejvýše nativní velikosti slova.¶

struct¶

Struct pack with too few args, not checked by MicroPython¶

Struct pack with too many args, not checked by MicroPython¶

Struct pack with whitespace in format, whitespace ignored by CPython, error on MicroPython¶

sys¶

Přepisování sys.stdin, sys.stdout a sys.stderr není možné¶

MicroPython does not include `ENOTSUP` as a name for errno 95.¶

Atribut `environ` není implementován¶

`getenv` vrací skutečnou hodnotu místo hodnoty z mezipaměti¶

Metoda `getrandbits` může vrátit nejvýše 32 bitů najednou.¶

Metoda `randint` může vrátit pouze celé číslo nejvýše nativní velikosti slova.¶