Модулі¶

Generated Thu 18 Jun 2026 14:23:40 UTC

Лише позиційні параметри¶

Щоб заощадити місце в коді, багато функцій, що приймають ключові аргументи в CPython, приймають лише позиційні аргументи в MicroPython.

MicroPython позначає лише позиційні параметри так само, як CPython, вставляючи / для позначення кінця позиційних параметрів. Будь-яка функція, підпис якої закінчується на /, приймає лише позиційні аргументи. Докладніше дивіться PEP 570.

Приклад¶

Наприклад, у CPython 3.4 ось підпис конструктора socket.socket

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

Однак підпис, задокументований у MicroPython, є:

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

/ у кінці параметрів вказує, що вони всі є лише позиційними в MicroPython. Наступний код працює в CPython, але не в більшості портів MicroPython:

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

MicroPython виникне виняток:

TypeError: function doesn't take keyword arguments

Наступний код буде працювати як у CPython, так і в MicroPython:

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

array¶

Порівняння між різними типовими кодами не підтримується¶

Причина: Розмір коду

Обхідний шлях: Порівнюйте окремі елементи

Зразок коду:

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:

Перевірку переповнення не реалізовано¶

Причина: MicroPython реалізує неявне усічення для зменшення розміру коду та часу виконання

Обхідний шлях: Якщо необхідна сумісність із CPython, явно маскуйте значення

Зразок коду:

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

Пошук цілого числа не реалізовано¶

Зразок коду:

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:

Видалення масиву не реалізовано¶

Зразок коду:

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

Індексування з кроком != 1 ще не реалізовано¶

Зразок коду:

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.

Зразок коду:

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 не генерує виняток, якщо об’єкт не серіалізується¶

Зразок коду:

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` не реалізований¶

Обхідний шлях: Використовуйте getenv, putenv та unsetenv

Зразок коду:

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` повертає фактичне значення замість кешованого¶

Причина: Атрибут environ не реалізований

Зразок коду:

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` може повернути максимум 32 біти за раз.¶

Причина: Внутрішній стан ГПВЧ становить лише 32 біти, тому він може повернути максимум 32 біти даних за раз.

Обхідний шлях: Якщо вам потрібне число, що має більше 32 бітів, використовуйте модуль random з micropython-lib.

Зразок коду:

import random


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

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

Метод `randint` може повернути лише ціле число, що не перевищує розмір рідного слова.¶

Причина: ГПВЧ може генерувати лише 32 біти стану за раз. Результат потім приводиться до int розміром рідного слова замість повноцінного об’єкта int.

Обхідний шлях: Якщо вам потрібні цілі числа, більші за розмір рідного слова, використовуйте модуль random з micropython-lib.

Зразок коду:

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¶

Зразок коду:

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¶

Зразок коду:

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¶

Причина: MicroPython оптимізовано для зменшення розміру коду.

Обхідний шлях: Не використовуйте пробіли у рядках формату.

Зразок коду:

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 та sys.stderr неможливе¶

Причина: Вони зберігаються у пам’яті лише для читання.

Зразок коду:

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'

Модулі¶

Лише позиційні параметри¶

Приклад¶

array¶

Порівняння між різними типовими кодами не підтримується¶

Перевірку переповнення не реалізовано¶

Пошук цілого числа не реалізовано¶

Видалення масиву не реалізовано¶

Індексування з кроком != 1 ще не реалізовано¶

errno¶

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

json¶

Модуль JSON не генерує виняток, якщо об’єкт не серіалізується¶

os¶

Атрибут environ не реалізований¶

getenv повертає фактичне значення замість кешованого¶

random¶

Метод getrandbits може повернути максимум 32 біти за раз.¶

Метод randint може повернути лише ціле число, що не перевищує розмір рідного слова.¶

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 та sys.stderr неможливе¶

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

Атрибут `environ` не реалізований¶

`getenv` повертає фактичне значення замість кешованого¶

Метод `getrandbits` може повернути максимум 32 біти за раз.¶

Метод `randint` може повернути лише ціле число, що не перевищує розмір рідного слова.¶