Moduulit¶

Generated Fri 19 Jun 2026 22:08:45 UTC

Vain paikka-argumentit¶

Koodin koon säästämiseksi monet funktiot, jotka hyväksyvät avainsana-argumentteja CPythonissa, hyväksyvät MicroPythonissa vain paikka-argumentteja.

MicroPython merkitsee vain paikka-argumentteina käytettävät parametrit samoin kuin CPython lisäämällä /-merkin paikkaparametrien lopun merkitsemiseksi. Mikä tahansa funktio, jonka allekirjoitus päättyy /-merkkiin, ottaa vain paikka-argumentteja. Lisätietoja on osoitteessa PEP 570.

Esimerkki¶

Esimerkiksi CPython 3.4:ssä konstruktorin socket.socket allekirjoitus on:

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

MicroPythonissa MicroPython dokumentoitu allekirjoitus on kuitenkin:

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

Parametrien lopussa oleva / osoittaa, että ne ovat kaikki vain paikka-argumentteja MicroPythonissa. Seuraava koodi toimii CPythonissa mutta ei useimmissa MicroPython-porteissa:

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

MicroPython nostaa poikkeuksen:

TypeError: function doesn't take keyword arguments

Seuraava koodi toimii sekä CPythonissa että MicroPythonissa:

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

array¶

Vertailua eri tyyppikoodien välillä ei tueta¶

Syy: Koodin koko

Kiertotapa: Vertaa yksittäisiä elementtejä

Esimerkkikoodi:

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:

Ylivuodon tarkistusta ei ole toteutettu¶

Syy: MicroPython toteuttaa implisiittisen katkaisun koodin koon ja suoritusajan pienentämiseksi

Kiertotapa: Jos CPython-yhteensopivuutta tarvitaan, peittää arvo eksplisiittisesti

Esimerkkikoodi:

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])

Kokonaisluvun etsintää ei ole toteutettu¶

Esimerkkikoodi:

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:

Taulukon poistoa ei ole toteutettu¶

Esimerkkikoodi:

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

Indeksointi askeleella != 1 ei ole vielä toteutettu¶

Esimerkkikoodi:

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.

Esimerkkikoodi:

import errno

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

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

json¶

JSON-moduuli ei nosta poikkeusta, kun olio ei ole sarjallistettavissa¶

Esimerkkikoodi:

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¶

`environ`-attribuuttia ei ole toteutettu¶

Kiertotapa: Käytä getenv-, putenv- ja unsetenv-funktioita

Esimerkkikoodi:

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` palauttaa todellisen arvon välimuistissa olevan arvon sijaan¶

Syy: environ-attribuuttia ei ole toteutettu

Esimerkkikoodi:

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¶

`getrandbits`-metodi voi palauttaa kerralla enintään 32 bittiä.¶

Syy: PRNG:n sisäinen tila on vain 32 bittiä, joten se voi palauttaa kerralla enintään 32 bittiä dataa.

Kiertotapa: Jos tarvitset yli 32 bitin lukua, käytä micropython-lib-kirjaston random-moduulia.

Esimerkkikoodi:

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

`randint`-metodi voi palauttaa vain natiivin sanaleveyden suuruisen kokonaisluvun.¶

Syy: PRNG pystyy tuottamaan kerralla vain 32 bittiä tilaa. Tulos muunnetaan natiivin kokoisen int-arvon sijaan kokonaislukuolioksi.

Kiertotapa: Jos tarvitset natiivia sananleveyttä suurempia kokonaislukuja, käytä micropython-lib-kirjaston random-moduulia.

Esimerkkikoodi:

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¶

Esimerkkikoodi:

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¶

Esimerkkikoodi:

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¶

Syy: MicroPython on optimoitu koodin koon suhteen.

Kiertotapa: Älä käytä välilyöntejä muotoiluketjuissa.

Esimerkkikoodi:

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¶

sys.stdin-, sys.stdout- ja sys.stderr-arvojen ylikirjoittaminen ei ole mahdollista¶

Syy: Ne on tallennettu vain luku -muistiin.

Esimerkkikoodi:

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'

Moduulit¶

Vain paikka-argumentit¶

Esimerkki¶

array¶

Vertailua eri tyyppikoodien välillä ei tueta¶

Ylivuodon tarkistusta ei ole toteutettu¶

Kokonaisluvun etsintää ei ole toteutettu¶

Taulukon poistoa ei ole toteutettu¶

Indeksointi askeleella != 1 ei ole vielä toteutettu¶

errno¶

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

json¶

JSON-moduuli ei nosta poikkeusta, kun olio ei ole sarjallistettavissa¶

os¶

environ-attribuuttia ei ole toteutettu¶

getenv palauttaa todellisen arvon välimuistissa olevan arvon sijaan¶

random¶

getrandbits-metodi voi palauttaa kerralla enintään 32 bittiä.¶

randint-metodi voi palauttaa vain natiivin sanaleveyden suuruisen kokonaisluvun.¶

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¶

sys.stdin-, sys.stdout- ja sys.stderr-arvojen ylikirjoittaminen ei ole mahdollista¶

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

`environ`-attribuuttia ei ole toteutettu¶

`getenv` palauttaa todellisen arvon välimuistissa olevan arvon sijaan¶

`getrandbits`-metodi voi palauttaa kerralla enintään 32 bittiä.¶

`randint`-metodi voi palauttaa vain natiivin sanaleveyden suuruisen kokonaisluvun.¶