iris-pex-embedded-python 4.0.1b8__py3-none-any.whl → 4.0.2b1__py3-none-any.whl

iop/migration/utils.py

@@ -186,6 +186,69 @@ def _get_python_path() -> str:
     return ""
 
 
+def _migration_namespace_hint() -> str:
+    namespace = os.environ.get("IRISNAMESPACE") or os.environ.get("IOP_NAMESPACE")
+    if namespace:
+        return f"namespace {namespace!r}"
+    return "the target namespace"
+
+
+def _looks_like_missing_iris_class_error(exc: RuntimeError) -> bool:
+    message = str(exc).lower()
+    return "error finding class" in message or "iop.utils" in message
+
+
+def _format_register_component_error(
+    exc: RuntimeError,
+    *,
+    module: str,
+    classname: str,
+    path: str,
+    iris_classname: str,
+) -> str:
+    namespace_hint = _migration_namespace_hint()
+    lines = [
+        (
+            f"Could not register IRIS proxy class {iris_classname!r} "
+            f"for Python component {module}.{classname}."
+        )
+    ]
+
+    if _looks_like_missing_iris_class_error(exc):
+        lines.extend(
+            [
+                "",
+                "IRIS could not find a class required during component registration.",
+                (
+                    "Most often this means the IoP support classes "
+                    f"(`IOP.Utils`, `IOP.BusinessService`, etc.) are not loaded in "
+                    f"{namespace_hint} yet, or migration ran before `iop --init` "
+                    "completed."
+                ),
+                "",
+                "Fix:",
+                f"  1. Run `iop --init` in {namespace_hint}.",
+                "  2. Re-run `iop --migrate <settings.py>`.",
+                (
+                    "  3. In containers, wait for IRIS with "
+                    "`/usr/irissys/dev/Container/waitReady.sh` before `iop --init`."
+                ),
+            ]
+        )
+
+    lines.extend(
+        [
+            "",
+            "Registration details:",
+            f"  IRIS proxy class: {iris_classname}",
+            f"  Python component: {module}.{classname}",
+            f"  Python class path: {path}",
+            f"  Original IRIS error: {exc}",
+        ]
+    )
+    return "\n".join(lines)
+
+
 def register_component(
     module: str,
     classname: str,
@@ -228,10 +291,13 @@ def register_component(
         )
     except RuntimeError as e:
         raise RuntimeError(
-            "Could not register component "
-            f"{iris_classname} from {module}.{classname}. "
-            "If IRIS reports that IOP.Utils is missing, initialize the IRIS "
-            f"support classes with `iop --init`. Original IRIS error: {e}"
+            _format_register_component_error(
+                e,
+                module=module,
+                classname=classname,
+                path=path,
+                iris_classname=iris_classname,
+            )
         ) from e
 
 

{iris_pex_embedded_python-4.0.1b8.dist-info → iris_pex_embedded_python-4.0.2b1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris_pex_embedded_python
-Version: 4.0.1b8
+Version: 4.0.2b1
 Summary: Iris Interoperability based on Embedded Python
 Author-email: grongier <guillaume.rongier@intersystems.com>
 License: MIT License

{iris_pex_embedded_python-4.0.1b8.dist-info → iris_pex_embedded_python-4.0.2b1.dist-info}/RECORD

@@ -62,7 +62,7 @@ iop/migration/__init__.py,sha256=wp-RvjLKYW_Pi2AJLfiWe1bACxENzEgjXtP9UMNiSVY,36
 iop/migration/io.py,sha256=hAehtApFZFgGzjzgwBmDMxdA1xoRhE-okOcEzvgFdQ4,1822
 iop/migration/manifest.py,sha256=Bs4eC1_i-ZnovlgSW9FKu5WBwy_6Zwy5ZAcsi5A1szU,19351
 iop/migration/plans.py,sha256=5kx3aqQiPDJ3F8hU9pp9_mOO1_N6GA0Ps7--G1Iv6z8,2549
-iop/migration/utils.py,sha256=pOojLPMZes05KXrGN2ap45ffppP5Z4tS4bjJ0gSD5Oc,38183
+iop/migration/utils.py,sha256=2lcM3w2cpgw4ijYRprKVBY8zhsp_ySmnPdhuo7WCmXM,40116
 iop/production/__init__.py,sha256=95VmJgC3lWtHpUJijLqyKKxFZa65OcRni8803kb4aHE,2148
 iop/production/actions.py,sha256=TLVAjPTPq21oLj9c-IG10qMNJ2hvPzueviMy_c1a0ZU,17199
 iop/production/common.py,sha256=L2QyvE2nC1J333sbebYx_6dyoaFL-89ouMO3Kfe4-D8,3465
@@ -92,9 +92,9 @@ iop/runtime/remote/director.py,sha256=bkie751GrYLgGs7ApRCowHpSnJA8KupxCOrFDQmjyO
 iop/runtime/remote/migration.py,sha256=Iboz-Ye7i9xif9bn433GazCF-gtD-HJW3wiUwWS5P6w,1831
 iop/runtime/remote/settings.py,sha256=P1Hsgld5o57HpSZgPVZzobyjlUmxJj6bstiWvR0JXnc,2144
 iop/runtime/remote/setup.py,sha256=Tr80F3JJTy7oSUso2jyx0iA_KZayd4MYt9vL0BvPpMA,2600
-iris_pex_embedded_python-4.0.1b8.dist-info/licenses/LICENSE,sha256=rZSiBFId_sfbJ6RL0GjjPX-InNLkNS9ou7eQsikciI8,1089
-iris_pex_embedded_python-4.0.1b8.dist-info/METADATA,sha256=2xgGbmP5t_sp-SvMGjzJp1wkpiU9p32fQ22gWUjG7GE,5854
-iris_pex_embedded_python-4.0.1b8.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-iris_pex_embedded_python-4.0.1b8.dist-info/entry_points.txt,sha256=fzS8ZFsPe8cnpEx208X60DNugCPQmuSloPeg4pyyJDY,42
-iris_pex_embedded_python-4.0.1b8.dist-info/top_level.txt,sha256=BM54-OXQ6l2BDtmesWNXckh033s9gcjoO7bfjbwZbxU,4
-iris_pex_embedded_python-4.0.1b8.dist-info/RECORD,,
+iris_pex_embedded_python-4.0.2b1.dist-info/licenses/LICENSE,sha256=rZSiBFId_sfbJ6RL0GjjPX-InNLkNS9ou7eQsikciI8,1089
+iris_pex_embedded_python-4.0.2b1.dist-info/METADATA,sha256=KH7KNTmCAgq7NDqjtGVeJUxN9SkQxu07iFkNkYWRsa4,5854
+iris_pex_embedded_python-4.0.2b1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+iris_pex_embedded_python-4.0.2b1.dist-info/entry_points.txt,sha256=fzS8ZFsPe8cnpEx208X60DNugCPQmuSloPeg4pyyJDY,42
+iris_pex_embedded_python-4.0.2b1.dist-info/top_level.txt,sha256=BM54-OXQ6l2BDtmesWNXckh033s9gcjoO7bfjbwZbxU,4
+iris_pex_embedded_python-4.0.2b1.dist-info/RECORD,,