PEP 783 – Emscripten 패키징

Author:: Hood Chatham <roberthoodchatham at gmail.com>
Sponsor:: Łukasz Langa <lukasz at python.org>
Discussions-To:: Discourse thread
Status:: Accepted
Type:: Standards Track
Topic:: Packaging
Created:: 28-Mar-2025
Post-History:: 02-Apr-2025, 18-Mar-2025
Resolution:: 06-Apr-2026

Table of Contents

번역·라이선스 안내

이 비공식 한국어 번역은 원문 Copyright 절의 Public Domain or CC0-1.0, whichever is more permissive 조건에 따라 제공합니다. 원저자와 공식 원문은 그대로 표시합니다. 수정되지 않은 기준 원문 · 공식 최신판

초록

이 PEP는 Pyodide Python 런타임을 위한 바이너리 Python 패키지 배포판에 사용할 새로운 플랫폼 태그 시리즈 pyemscripten을 제안합니다.

Emscripten은 완전한 오픈 소스 컴파일러 도구 체인입니다. 브라우저와 Node.js를 포함한 JavaScript 런타임에서 사용하기 위한 C/C++ 코드를 WebAssembly/JavaScript 실행 파일로 컴파일합니다. Rust 언어도 Emscripten 타깃을 유지 관리합니다. PEP 776은 Python의 Emscripten 지원을 명시합니다.

동기

Pyodide는 브라우저에서 사용하기 위한 CPython 배포판입니다. 웹 브라우저는 Windows, macOS, Linux 및 모든 스마트폰에서 사용할 수 있는 범용 컴퓨팅 플랫폼입니다. 수십만 명의 학생이 Capytale및 PyodideU와 같은 프로젝트를 통해 Pyodide로 Python을 배웠습니다. 또한 Python 패키지에서 대화형 문서를 제공하기 위해 Pyodide를 사용하는 경우가 점점 늘고 있습니다.

이 글을 작성하는 시점에 Pyodide는 NumPy, SciPy, pandas, Polars, scikit-learn, OpenCV, PyArrow 및 Pillow와 같은 주요 과학 Python 패키지와 aiohttp, Requests, Pydantic, cryptography 및 orjson과 같은 범용 패키지를 포함하여 255개의 서로 다른 패키지 포트를 유지 관리하고 있습니다.

NumPy, pandas, awkward-cpp, scikit-image, statsmodels, PyArrow, Hypothesis 및 PyO3를 포함하여 약 60개의 패키지도 CI에서 Pyodide를 대상으로 테스트하고 있습니다.

Python 패키지 프로젝트는 PyPI에 Pyodide용 바이너리 배포판을 배포할 수 없습니다. 대신 anaconda.org 또는 jsdelivr.com과 같은 다른 옵션을 사용해야 합니다. 이로 인해 패키지 유지 관리자와 사용자 모두에게 불편이 발생합니다.

근거

Emscripten이 애플리케이션을 빌드할 때는 전체 운영 체제를 포함하는 독립 실행형 프로그램으로 빌드합니다. Emscripten은 주로 완전 정적 프로그램이라는 사용 사례를 대상으로 합니다. 동적 링크를 사용하는 경우의 주요 대상 사용 사례는 번들 분할과 지연 로딩이며, 이 경우 동적 라이브러리는 애플리케이션과 동시에 빌드됩니다.

그 결과 Emscripten 컴파일러는 버전 간 ABI 안정성을 보장하지 않습니다. 많은 Emscripten 업데이트는 우연히 ABI 호환성을 갖추며, Rust Emscripten 타깃은 occasional negative consequences와 같은 간헐적인 부정적 결과만을 초래하면서 ABI가 안정적인 것처럼 동작합니다.

Emscripten ABI 또는 시스템 라이브러리를 조정하는 링커 플래그가 여러 개 있습니다. Emscripten에서 실행되도록 빌드된 Python 패키지는 로드 시 또는 실행 시 오류를 방지하기 위해 인터프리터를 컴파일하는 데 사용된 ABI 민감 링커 플래그와 일치하는지 확인해야 합니다. Emscripten 컴파일러는 지속적으로 버그를 수정하고 새로운 웹 플랫폼 기능에 대한 지원을 추가합니다. 따라서 ABI를 업데이트할 수 있다는 것은 상당한 이점이 있습니다.

패키지 유지 관리자의 ABI 안정성 요구와 플랫폼의 발전을 허용하는 ABI 유연성 사이에서 균형을 맞추기 위해 Pyodide는 Python의 각 기능 릴리스마다 새로운 Emscripten 플랫폼을 채택할 계획이며, 이를 pyemscripten_${YEAR}_${PATCH}라고 부릅니다.

Pyodide 팀은 많은 인기 있는 Rust 패키지를 지원할 수 있도록 Pyodide가 사용하는 ABI 플래그를 Rust가 지원하는 Emscripten ABI와도 조정합니다. 역사적으로 이 작업의 대부분은 언와인딩 ABI와 관련되어 있었습니다. 예를 들어 this Rust Major Change Proposal를 참조하십시오.

pyemscripten 플랫폼은 Python과 특별한 관련이 없으며, 실제로 적절한 버전의 Emscripten과 적절한 링크 플래그를 사용하는 모든 프로그램에서 사용할 수 있습니다. 특히 pyemscripten 플랫폼 태그는 지정된 버전의 Emscripten과 지정된 ABI 민감 플래그를 사용하여 컴파일 및 링크된 Python 인터프리터에서 사용할 수 있습니다.

사양

플랫폼 태그는 다음과 같은 형식을 취합니다:

pyemscripten_${YEAR}_${PATCH}_wasm32

각 태그는 지정된 Python 버전과 함께 사용됩니다. 예를 들어, 플랫폼 태그 pyemscripten_2026_0은 Python 3.14와 함께 사용됩니다.

PyEmscripten 플랫폼

pyemscripten_${YEAR}_${PATCH} 플랫폼의 사양에는 다음이 포함됩니다:

사용할 Emscripten 컴파일러 버전
애플리케이션에 정적으로 링크할 라이브러리
사용할 스택 언와인딩 ABI
로더가 의존성 조회를 처리하는 방식
라이브러리에서 -pthread를 사용할 수 없다는 점
라이브러리를 -sWASM_BIGINT와 함께 링크해야 한다는 점

적절한 버전의 Emscripten 컴파일러를 선택하고 적절한 컴파일러 및 링커 플래그를 전달하여 플랫폼을 선택합니다.

플랫폼 정의에는 Python에 관한 내용이 포함되지 않으며, 특히 사용하려는 Python 버전에 구애받지 않습니다. 그러나 명확성을 위해 각 플랫폼을 어떤 Python 버전과 함께 사용할 계획인지 플랫폼 문서에 명시합니다.

PyEmscripten 플랫폼은 Pyodide’s documentation on the PyEmscripten Platform에서 완전히 지정되어 있습니다.

플랫폼을 정의하려면 주 애플리케이션을 컴파일하고 링크하는 방법만 나타내면 됩니다. 이는 호환되는 공유 라이브러리를 빌드하는 방법을 의미합니다. 그러나 대부분의 사용자가 공유 라이브러리를 빌드할 것으로 가정하므로, 문서에는 호환되는 공유 라이브러리를 빌드하는 방법에 대한 자세한 지침이 포함되어 있습니다.

pyodide build 도구는 PyEmscripten 플랫폼과 호환되는 휠을 만드는 방법을 알고 있습니다. manylinux 휠과 달리 pyemscripten 휠을 빌드하는 데 Docker 컨테이너가 필요하지 않습니다. Linux 머신과 적절한 버전의 Python, Node.js 및 Emscripten만 있으면 됩니다.

적절한 버전의 Pyodide 런타임에 휠을 설치하고 가져와 PyEmscripten 플랫폼과 호환되는지 검증할 수 있습니다. Pyodide는 강력한 샌드박싱 보장이 제공되는 환경에서 실행될 수 있으므로, 이렇게 해도 보안 위험이 발생하지 않습니다.

PyEmscripten 플랫폼 버전 확인

PyEmscripten 플랫폼 버전은 PYEMSCRIPTEN_PLATFORM_VERSION 구성 변수에 저장되며 다음과 같이 확인할 수 있습니다:

pyemscripten_platform_version = sysconfig.get_config_var("PYEMSCRIPTEN_PLATFORM_VERSION")

호환되는 태그 목록을 생성하려면 다음 코드를 사용할 수 있습니다:

from packaging.tags import cpython_tags, _generic_platforms

def _emscripten_platforms() -> Iterator[str]:
    pyemscripten_platform_version = sysconfig.get_config_var("PYEMSCRIPTEN_PLATFORM_VERSION")
    if pyemscripten_platform_version:
        yield f"pyemscripten_{pyemscripten_platform_version}_wasm32"
    yield from _generic_platforms()

emscripten_tags = cpython_tags(platforms=_emscripten_platforms())

이 코드는 pypa/packaging에 추가될 예정입니다.

패키지 설치 관리자

설치 관리자는 위에 표시된 _emscripten_platforms() 함수를 사용하여 Emscripten으로 빌드된 CPython과 호환되는 플랫폼을 확인해야 합니다. 특히 PyEmscripten 플랫폼 버전은 sysconfig.get_config_var("PYEMSCRIPTEN_PLATFORM_VERSION")을 통해 노출됩니다.

패키지 색인

패키지 색인은 플랫폼 태그가 정규 표현식 pyemscripten_[0-9]+_[0-9]+_wasm32과 일치하는 모든 휠을 수락해야 합니다.

의존성 지정자 마커

Emscripten Python에서는 PEP 776에 따르면 sys.platform은 "emscripten"을 반환합니다. 의존성 지정자에서 Emscripten 플랫폼을 확인하려면 sys_platform == "emscripten" (또는 그 부정)을 사용할 수 있습니다.

Trove 분류자

Emscripten 휠을 빌드하고 테스트하는 패키지는 Environment :: WebAssembly :: Emscripten 분류자를 추가하여 이를 선언할 수 있습니다. PyPI는 이미 이 분류자가 포함된 패키지의 업로드를 수락합니다.

하위 호환성

이 PEP에는 하위 호환성 문제가 없습니다.

보안 관련 사항

이 PEP에는 보안 관련 사항이 없습니다.

거부된 아이디어

Pyodide를 위한 사용자 지정 인터프리터 태그

Pyodide는 CPython이므로 Pyodide를 위한 사용자 지정 인터프리터 태그는 필요하지 않습니다. 몇 가지 사소한 패치를 적용하기는 하지만, 이러한 패치는 인터프리터 ABI에 영향을 주지 않으며 장기적인 목표는 모든 내용을 업스트림에 반영하는 것입니다.

플랫폼 태그를 위한 대안

emscripten_${EMSCRIPTEN_VERSION}: emscripten을 플랫폼 태그로 사용하고 싶은 유혹이 생기는 이유는 pyemscripten 플랫폼이 Python과 특별히 관련이 없고, 실제로 적절한 버전의 Emscripten과 적절한 링크 플래그를 사용하는 모든 프로그램에서 사용할 수 있기 때문입니다. 그러나 emscripten_${EMSCRIPTEN_VERSION}은 그 자체로는 너무 모호합니다. 플랫폼이 다양한 링커 플래그에도 의존하기 때문입니다.
비슷한 문제를 겪는 다른 커뮤니티들도 있으며, 전체 생태계가 사용할 수 있는 “장기 서비스” Emscripten 플랫폼을 위한 중앙 집중식 표준의 혜택을 받을 수 있습니다. 그러나 Emscripten 팀은 동적 링크를 특이한 사용 사례로 간주하기 때문에 지금까지 이러한 표준을 제공하려 하지 않았습니다. 따라서 이 문제는 우리 생태계가 스스로 해결해야 합니다. 플랫폼 태그에는 이를 나타내는 표시가 포함되어야 합니다.
pyemscripten_${PYTHON_MAJOR_MINOR}_${PATCH}: 이렇게 하면 각 플랫폼에서 사용하도록 의도된 Python 버전이 더 명확해지지만, 플랫폼이 Python과 아무 관련이 없으므로 개념적 혼란이 발생합니다.
pyodide_...: 현재 플랫폼은 Pyodide가 정의하므로 플랫폼을 pyodide라고 부르면 이러한 연결이 더 명확해집니다. 그러나 플랫폼의 기능은 Pyodide가 지원하는 것이 아니라 Emscripten이 지원하는 것에 좌우되므로 플랫폼 태그는 Emscripten에 초점을 맞추어야 합니다. 또한 pyemscripten 태그는 플랫폼의 정의가 Pyodide의 업스트림으로 이동하는 미래에도 더 높은 전방 호환성을 제공합니다.
패치 버전 없음: 패치 버전이 필요하지 않기를 바라지만, 예기치 않은 문제에 대비하는 것이 좋습니다.

Python 개선 제안 한국어 번역