Módulos¶

Generated Thu 18 Jun 2026 14:23:40 UTC

Parâmetros Exclusivamente Posicionais¶

Para poupar espaço de código, muitas funções que aceitam argumentos de palavra-chave no CPython apenas aceitam argumentos posicionais no MicroPython.

O MicroPython marca os parâmetros exclusivamente posicionais da mesma forma que o CPython, inserindo um / para marcar o fim dos parâmetros posicionais. Qualquer função cuja assinatura termine em / aceita apenas argumentos posicionais. Para mais detalhes, consulte PEP 570.

Exemplo¶

Por exemplo, no CPython 3.4 esta é a assinatura do construtor socket.socket

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

No entanto, a assinatura documentada em MicroPython é:

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

O / no final dos parâmetros indica que todos são exclusivamente posicionais no MicroPython. O código seguinte funciona no CPython mas não na maioria dos ports do MicroPython:

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

O MicroPython lançará uma exceção:

TypeError: function doesn't take keyword arguments

O código seguinte funcionará tanto no CPython como no MicroPython:

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

array¶

Comparação entre typecodes diferentes não suportada¶

Causa: Tamanho do código

Solução: Compare elementos individuais

Código de exemplo:

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:

Verificação de overflow não implementada¶

Causa: O MicroPython implementa truncagem implícita de modo a reduzir o tamanho do código e o tempo de execução

Solução: Se for necessária compatibilidade com CPython, mascare o valor explicitamente

Código de exemplo:

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

Pesquisa de inteiro não implementada¶

Código de exemplo:

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:

Eliminação de array não implementada¶

Código de exemplo:

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

Subscrição com passo != 1 ainda não implementado¶

Código de exemplo:

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.

Código de exemplo:

import errno

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

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

json¶

O módulo JSON não lança exceção quando o objeto não é serializável¶

Código de exemplo:

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¶

O atributo `environ` não está implementado¶

Solução: Utilize getenv, putenv e unsetenv

Código de exemplo:

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` devolve o valor real em vez do valor em cache¶

Causa: O atributo environ não está implementado

Código de exemplo:

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¶

O método `getrandbits` só pode devolver no máximo 32 bits de cada vez.¶

Causa: O estado interno do PRNG tem apenas 32 bits, pelo que só pode devolver no máximo 32 bits de dados de cada vez.

Solução: Se precisar de um número com mais de 32 bits, utilize o módulo random do micropython-lib.

Código de exemplo:

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

O método `randint` só pode devolver um inteiro que seja no máximo do tamanho de palavra nativo.¶

Causa: O PRNG só consegue gerar 32 bits de estado de cada vez. O resultado é então convertido num int de tamanho nativo em vez de um objeto int completo.

Solução: Se precisar de inteiros maiores do que o tamanho de palavra nativo, utilize o módulo random do micropython-lib.

Código de exemplo:

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¶

Código de exemplo:

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¶

Código de exemplo:

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¶

Causa: O MicroPython é otimizado para tamanho de código.

Solução: Não utilize espaços em strings de formato.

Código de exemplo:

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¶

Não é possível substituir sys.stdin, sys.stdout e sys.stderr¶

Causa: São armazenados em memória de apenas leitura.

Código de exemplo:

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'

Módulos¶

Parâmetros Exclusivamente Posicionais¶

Exemplo¶

array¶

Comparação entre typecodes diferentes não suportada¶

Verificação de overflow não implementada¶

Pesquisa de inteiro não implementada¶

Eliminação de array não implementada¶

Subscrição com passo != 1 ainda não implementado¶

errno¶

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

json¶

O módulo JSON não lança exceção quando o objeto não é serializável¶

os¶

O atributo environ não está implementado¶

getenv devolve o valor real em vez do valor em cache¶

random¶

O método getrandbits só pode devolver no máximo 32 bits de cada vez.¶

O método randint só pode devolver um inteiro que seja no máximo do tamanho de palavra nativo.¶

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¶

Não é possível substituir sys.stdin, sys.stdout e sys.stderr¶

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

O atributo `environ` não está implementado¶

`getenv` devolve o valor real em vez do valor em cache¶

O método `getrandbits` só pode devolver no máximo 32 bits de cada vez.¶

O método `randint` só pode devolver um inteiro que seja no máximo do tamanho de palavra nativo.¶