Skip to content

Latest commit

 

History

History
23 lines (21 loc) · 1.31 KB

repository-structure.md

File metadata and controls

23 lines (21 loc) · 1.31 KB
Raw

The Pyodide runtime consists of the following components, sorted in terms of initialization-time (or import-time) dependencies.

  1. CPython
  2. The py/_pyodide package which is a Python package with pure Python code available in the inner stage of the Pyodide bootstrap process.
  3. The core/pyodide code, implemented in a mix of C and JavaScript, which embeds the CPython interpreter in an emscripten application. This relies on py/pyodide and js/pyodide at runtime. The final stage of initialization is to import py/pyodide.
  4. The py/pyodide package which has Python code that is needed for the outer stage of the Pyodide bootstrap process. py/pyodide relies on core/pyodide at import time and relies on js/pyodide at runtime.
  5. The js/pyodide package which defines the JavaScript public API, sets up the process of loading the core/pyodide emscripten application + CPython interpreter, and then completes the bootstrap by injecting the js/pyodide API into the Python sys.modules.
  6. The packages directory, which contains a large number of CPython packages built to run in Pyodide.

One of our long-term organizational goals is to carefully organize core/pyodide, py/_pyodide, py/pyodide, and js/pyodide to clarify which functionality is not part of runtime dependencies that define Pyodide's core behavior.