모듈

Generated Fri 19 Jun 2026 22:08:45 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은 코드 크기와 실행 시간을 줄이기 위해 암묵적 잘림(truncation)을 구현합니다.

해결 방법: 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

step != 1인 구독(subscript)이 아직 구현되지 않음

예제 코드:

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비트만 반환할 수 있습니다.

원인: PRNG의 내부 상태가 32비트뿐이므로 한 번에 최대 32비트의 데이터만 반환할 수 있습니다.

해결 방법: 32비트를 초과하는 숫자가 필요한 경우 micropython-lib의 random 모듈을 활용하십시오.

예제 코드:

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 메서드는 기본 워드 크기 이하의 정수만 반환할 수 있습니다.

원인: PRNG는 한 번에 32비트의 상태만 생성할 수 있습니다. 결과는 전체 int 객체가 아닌 기본 크기의 int로 캐스팅됩니다.

해결 방법: 기본 워드 크기보다 큰 정수가 필요한 경우 micropython-lib의 random 모듈을 사용하십시오.

예제 코드:

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'