From 5d6e3fbdc82d01ccd34bd9bc0be4d68c3f998d27 Mon Sep 17 00:00:00 2001 From: Andrej730 Date: Wed, 5 Aug 2026 13:24:03 +0500 Subject: [PATCH] order_pyodide_wheel_shared_objects: explain why --- pyodide/order_pyodide_wheel_shared_objects.py | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/pyodide/order_pyodide_wheel_shared_objects.py b/pyodide/order_pyodide_wheel_shared_objects.py index 4e49077e67..33ed76d2ba 100644 --- a/pyodide/order_pyodide_wheel_shared_objects.py +++ b/pyodide/order_pyodide_wheel_shared_objects.py @@ -2,7 +2,17 @@ # /// script # /// # This file was generated with the assistance of an AI coding tool. -"""Order Pyodide wheel shared objects so wasm side modules load safely.""" +"""Order Pyodide wheel shared objects so wasm side modules load safely. + +Pyodide's package loader loads a wheel's bundled ``.so`` files in the order +they appear in the wheel's zip. +If a ``.so`` that depends on symbols from another ``.so`` is loaded first, +loading fails with errors like +- "Failed to load dynamic library" +- "Dynamic linking error: cannot resolve symbol" + +This is a known issue upstream - https://github.com/pyodide/pyodide/issues/6020. +""" from __future__ import annotations