iris-pex-embedded-python 4.0.2b1__tar.gz → 4.1.0b1__tar.gz

{iris_pex_embedded_python-4.0.2b1/src/iris_pex_embedded_python.egg-info → iris_pex_embedded_python-4.1.0b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris_pex_embedded_python
-Version: 4.0.2b1
+Version: 4.1.0b1
 Summary: Iris Interoperability based on Embedded Python
 Author-email: grongier <guillaume.rongier@intersystems.com>
 License: MIT License
@@ -46,10 +46,27 @@ License-File: LICENSE
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: xmltodict>=0.12.0
 Requires-Dist: iris-embedded-python-wrapper>=0.5.0
-Requires-Dist: iris-persistence>=0.1.1
+Requires-Dist: iris-persistence>=0.3.0
 Requires-Dist: jsonpath-ng>=1.7.0
-Requires-Dist: debugpy>=1.8.0
 Requires-Dist: requests>=2.24.0
+Provides-Extra: debug
+Requires-Dist: debugpy>=1.8.0; extra == "debug"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: dataclasses-json; extra == "dev"
+Requires-Dist: intersystems-irispython; extra == "dev"
+Requires-Dist: mkdocs; extra == "dev"
+Requires-Dist: mkdocs-gen-files; extra == "dev"
+Requires-Dist: pymdown-extensions; extra == "dev"
+Requires-Dist: pyright; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: python-dotenv; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: tox>=4; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: debugpy>=1.8.0; extra == "dev"
 Dynamic: license-file
 
 # IoP (Interoperability On Python)
@@ -60,7 +77,7 @@ Dynamic: license-file
 [![PyPI - License](https://img.shields.io/pypi/l/iris-pex-embedded-python)](https://pypi.org/project/iris-pex-embedded-python/)
 ![GitHub last commit](https://img.shields.io/github/last-commit/grongierisc/interoperability-embedded-python)
 
-Welcome to the **Interoperability On Python (IoP)** proof of concept! This project demonstrates how the **IRIS Interoperability Framework** can be utilized with a **Python-first approach**.
+Welcome to **Interoperability On Python (IoP)**, a production-stable Python-first toolkit for building on the **IRIS Interoperability Framework**.
 
 Documentation can be found [here](https://grongierisc.github.io/interoperability-embedded-python/).
 For prompt-driven workflows, see [AI-assisted coding with IoP](https://grongierisc.github.io/interoperability-embedded-python/ai-coding/).
@@ -105,7 +122,7 @@ PRODUCTIONS = [prod]
 
 ## Installation
 
-To start using this proof of concept, install it using pip:
+Install the production-stable package using pip:
 
 ```bash
 pip install iris-pex-embedded-python
@@ -120,3 +137,22 @@ For concrete workflows, use the [IoP cookbooks](https://grongierisc.github.io/in
 For healthcare productions, also see [Healthcare AI-assisted coding](https://grongierisc.github.io/interoperability-embedded-python/healthcare-ai-coding/).
 
 Happy coding!
+
+## Compatibility and support
+
+IoP supports Python 3.10 through 3.14 and InterSystems IRIS 2021.2 or newer.
+Changes follow semantic versioning:
+backward-compatible features and deprecations ship in minor releases, while
+removals are reserved for major releases and are announced in the changelog.
+IRIS compatibility is continuously checked against the latest Community image;
+the preview image is tested nightly to identify upcoming incompatibilities.
+
+## Contributing
+
+Create a Python 3.10 or newer virtual environment, then install and verify the
+development environment with:
+
+```bash
+python -m pip install -e ".[dev]"
+tox
+```

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/README.md

@@ -6,7 +6,7 @@
 [![PyPI - License](https://img.shields.io/pypi/l/iris-pex-embedded-python)](https://pypi.org/project/iris-pex-embedded-python/)
 ![GitHub last commit](https://img.shields.io/github/last-commit/grongierisc/interoperability-embedded-python)
 
-Welcome to the **Interoperability On Python (IoP)** proof of concept! This project demonstrates how the **IRIS Interoperability Framework** can be utilized with a **Python-first approach**.
+Welcome to **Interoperability On Python (IoP)**, a production-stable Python-first toolkit for building on the **IRIS Interoperability Framework**.
 
 Documentation can be found [here](https://grongierisc.github.io/interoperability-embedded-python/).
 For prompt-driven workflows, see [AI-assisted coding with IoP](https://grongierisc.github.io/interoperability-embedded-python/ai-coding/).
@@ -51,7 +51,7 @@ PRODUCTIONS = [prod]
 
 ## Installation
 
-To start using this proof of concept, install it using pip:
+Install the production-stable package using pip:
 
 ```bash
 pip install iris-pex-embedded-python
@@ -66,3 +66,22 @@ For concrete workflows, use the [IoP cookbooks](https://grongierisc.github.io/in
 For healthcare productions, also see [Healthcare AI-assisted coding](https://grongierisc.github.io/interoperability-embedded-python/healthcare-ai-coding/).
 
 Happy coding!
+
+## Compatibility and support
+
+IoP supports Python 3.10 through 3.14 and InterSystems IRIS 2021.2 or newer.
+Changes follow semantic versioning:
+backward-compatible features and deprecations ship in minor releases, while
+removals are reserved for major releases and are announced in the changelog.
+IRIS compatibility is continuously checked against the latest Community image;
+the preview image is tested nightly to identify upcoming incompatibilities.
+
+## Contributing
+
+Create a Python 3.10 or newer virtual environment, then install and verify the
+development environment with:
+
+```bash
+python -m pip install -e ".[dev]"
+tox
+```

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/docs/contributing.md

@@ -14,7 +14,8 @@ source .venv/bin/activate
 ### Install the dependencies.
 
 ```bash
-pip install -r requirements-dev.txt
+python -m pip install -e ".[dev]"
+tox
 ```
 
 ### Have a running IRIS instance.
@@ -45,7 +46,7 @@ ln -s <your_git_dir>/src/iop $IRISINSTALLDIR/python/iop
 ##### Run the unit tests.
 
 ```bash
-pytest
+tox -e py
 ```
 
 #### Docker installation of IRIS

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/docs/debug.md

@@ -153,7 +153,7 @@ And select the virtual environment in VsCode.
 4. Install the dependencies.
 
 ```bash
-pip install -r requirements.txt
+python -m pip install -e ".[debug]"
 ```
 
 5. Run the code in debug mode.
@@ -219,4 +219,3 @@ With tracebacks enabled:
 With tracebacks disabled:
 
 ![Traceback disabled](./img/traceback_disable.png)
-

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/docs/index.md

@@ -6,7 +6,7 @@
 [![PyPI - License](https://img.shields.io/pypi/l/iris-pex-embedded-python)](https://pypi.org/project/iris-pex-embedded-python/)
 ![GitHub last commit](https://img.shields.io/github/last-commit/grongierisc/interoperability-embedded-python)
 
-Welcome to the **Interoperability On Python (IoP)** proof of concept! This project demonstrates how the **IRIS Interoperability Framework** can be utilized with a **Python-first approach**.
+Welcome to **Interoperability On Python (IoP)**, a production-stable Python-first toolkit for building on the **IRIS Interoperability Framework**.
 
 Documentation can be found [here](https://grongierisc.github.io/interoperability-embedded-python/).
 For prompt-driven workflows, see [AI-assisted coding with IoP](https://grongierisc.github.io/interoperability-embedded-python/ai-coding/).
@@ -51,7 +51,7 @@ PRODUCTIONS = [prod]
 
 ## Installation
 
-To start using this proof of concept, install it using pip:
+Install the production-stable package using pip:
 
 ```bash
 pip install iris-pex-embedded-python

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/docs/python-api.md

@@ -35,7 +35,10 @@ class MyRequest(PydanticMessage):
 
 Base class for native IRIS message body classes backed by `iris-persistence`. Fields are declared directly on the Python class.
 
-By default, a `PersistentMessage` generates an IRIS class that extends `Ens.MessageBody`, uses schema mode `extend`, and enables runtime auto-sync in extend mode.
+By default, a `PersistentMessage` generates an IRIS class that extends
+`Ens.MessageBody`, uses schema mode `managed`, and enables runtime auto-sync in
+managed mode. This is the replacement for the `extend` mode removed in
+`iris-persistence` 0.3.
 
 **Example:**
 ```python

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools", "wheel"]
 
 [project]
 name = "iris_pex_embedded_python"
-version = "4.0.2b1"
+version = "4.1.0b1"
 description = "Iris Interoperability based on Embedded Python"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -29,14 +29,35 @@ dependencies = [
     "pydantic>=2.0.0",
     "xmltodict>=0.12.0",
     "iris-embedded-python-wrapper>=0.5.0",
-    "iris-persistence>=0.1.1",
+    "iris-persistence>=0.3.0",
     "jsonpath-ng>=1.7.0",
-    "debugpy>=1.8.0",
     "requests>=2.24.0"
 ]
 
 license = { file = "LICENSE" }
 
+[project.optional-dependencies]
+debug = [
+    "debugpy>=1.8.0",
+]
+dev = [
+    "build",
+    "dataclasses-json",
+    "intersystems-irispython",
+    "mkdocs",
+    "mkdocs-gen-files",
+    "pymdown-extensions",
+    "pyright",
+    "pytest",
+    "pytest-asyncio",
+    "python-dotenv",
+    "ruff",
+    "tox>=4",
+    "twine",
+    "wheel",
+    "debugpy>=1.8.0",
+]
+
 [project.urls]
 homepage = "https://github.com/grongierisc/interoperability-embedded-python"
 documentation = "https://github.com/grongierisc/interoperability-embedded-python/blob/master/README.md"
@@ -66,10 +87,12 @@ markers = [
 
 [tool.pyright]
 pythonVersion = "3.10"
+include = ["src/iop"]
 
 [tool.ruff]
 target-version = "py310"
 line-length = 88
+exclude = ["src/tests"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "B", "UP"]

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/src/iop/cli/formatting.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import dataclasses
 import json
-from typing import Any
+from typing import Any, cast
 
 
 def format_test_response(response: Any) -> str:
@@ -41,5 +41,5 @@ def format_test_response(response: Any) -> str:
             return response
 
     if dataclasses.is_dataclass(response):
-        return json.dumps(dataclasses.asdict(response), indent=4)
+        return json.dumps(dataclasses.asdict(cast(Any, response)), indent=4)
     return str(response)

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/src/iop/cli/main.py

@@ -241,6 +241,8 @@ class Command:
             if self.args.export == "not_set"
             else self.args.export
         )
+        if not export_name:
+            raise ValueError("No production name was provided or configured.")
         export_format = self.args.export_format or "json"
         if export_format == "json":
             print(json.dumps(self.director.export_production(export_name), indent=4))

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/src/iop/components/async_request.py

@@ -30,37 +30,48 @@ class AsyncRequest(asyncio.Future):
         if host is None:
             raise ValueError("host parameter cannot be None")
         self._iris_handle = host.iris_handle
-        asyncio.create_task(self.send())
+        self._message_header_id = 0
+        self._queue_name = ""
+        self._end_time = 0
+        self._response = None
+        self._done = False
+        self._send_task = asyncio.create_task(self.send())
 
     async def send(self) -> None:
-        # init parameters
-        iris = _iris.get_iris()
-        message_header_id = iris.ref()
-        queue_name = iris.ref()
-        end_time = iris.ref()
-        request = dispatch_serializer(self.request)
+        try:
+            iris = _iris.get_iris()
+            message_header_id = iris.ref()
+            queue_name = iris.ref()
+            end_time = iris.ref()
+            request = dispatch_serializer(self.request)
 
-        # send request
-        self._iris_handle.dispatchSendRequestAsyncNG(
-            self.target,
-            request,
-            self.timeout,
-            self.description,
-            message_header_id,
-            queue_name,
-            end_time,
-        )
+            self._iris_handle.dispatchSendRequestAsyncNG(
+                self.target,
+                request,
+                self.timeout,
+                self.description,
+                message_header_id,
+                queue_name,
+                end_time,
+            )
 
-        # get byref values
-        self._message_header_id = message_header_id.value
-        self._queue_name = queue_name.value
-        self._end_time = end_time.value
+            self._message_header_id = message_header_id.value
+            self._queue_name = queue_name.value
+            self._end_time = end_time.value
 
-        while not self._done:
-            await asyncio.sleep(0.1)
-            self.is_done()
+            while not self._done:
+                await asyncio.sleep(0.1)
+                self.is_done()
 
-        self.set_result(self._response)
+            if not self.done():
+                self.set_result(self._response)
+        except asyncio.CancelledError:
+            if not self.done():
+                self.cancel()
+            raise
+        except Exception as exc:
+            if not self.done():
+                self.set_exception(exc)
 
     def is_done(self) -> None:
         iris = _iris.get_iris()

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/src/iop/components/debugpy.py

@@ -127,7 +127,10 @@ def debugpython(self, host_object: Any) -> None:
         return
 
     if not is_debugpy_installed():
-        self.log_alert("Debugpy is not installed.")
+        self.log_alert(
+            "Debugpy is not installed. Install iris-pex-embedded-python[debug] "
+            "to enable remote debugging."
+        )
         return
 
     # Configure Python interpreter
@@ -167,7 +170,10 @@ def debugpy_in_iris(iris_dir, port) -> bool:
         os.__file__ = __file__
 
     if not is_debugpy_installed():
-        print("debugpy is not installed.")
+        print(
+            "debugpy is not installed. Install iris-pex-embedded-python[debug] "
+            "to enable remote debugging."
+        )
         return False
     if not iris_dir:
         print("IRIS directory is not specified.")

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/src/iop/messages/persistent.py

@@ -4,18 +4,19 @@ import importlib
 import inspect
 import os
 import sys
+from dataclasses import dataclass
+from enum import Enum
 from typing import Any
 
-import iris_persistence
 from iris_persistence import Field as Field
-from iris_persistence import Model
+from iris_persistence import Model as _PersistenceModel
 from iris_persistence.models import ModelMeta
 from iris_persistence.runtime import get_runtime
 
 from ..runtime.environment import prepend_sys_path
 
 DEFAULT_SUPERCLASS = "Ens.MessageBody"
-DEFAULT_SYNC_MODE = "extend"
+DEFAULT_SYNC_MODE = "managed"
 MESSAGE_KIND_PARAMETER = "IOP_MESSAGE_KIND"
 MESSAGE_KIND_VALUE = "PersistentMessage"
 PYTHON_CLASS_PARAMETER = "IOP_PYTHON_CLASS"
@@ -28,13 +29,46 @@ _IRIS_TO_PYTHON_STRICT_CACHE: dict[str, bool] = {}
 _IRIS_TO_MESSAGE_CLASS_CACHE: dict[str, type] = {}
 _IRIS_PARAMETER_CACHE: dict[tuple[str, str], str | None] = {}
 _AUTO_SYNCED: set[tuple[type, str]] = set()
+_CACHE_VALUE_UNSET = object()
 
 
 class PersistentMessageError(Exception):
     """Raised when a native persistent message cannot be materialized."""
 
 
-class _PersistentMessageMeta(ModelMeta):
+class _PersistentMessageResolutionState(Enum):
+    UNMAPPED = "unmapped"
+    RESOLVED = "resolved"
+    INVALID = "invalid"
+
+
+@dataclass(frozen=True)
+class _PersistentMessageResolution:
+    state: _PersistentMessageResolutionState
+    message_class: type | None = None
+    error: PersistentMessageError | None = None
+
+
+def _materialize_deferred_annotations(namespace: dict) -> None:
+    """Expose Python 3.14 deferred annotations to iris-persistence."""
+    if "__annotations__" in namespace:
+        return
+    annotate = namespace.get("__annotate_func__")
+    if annotate is not None:
+        namespace["__annotations__"] = annotate(1)
+
+
+class _ModelMeta(ModelMeta):
+    def __new__(mcs, name: str, bases: tuple, namespace: dict, **kwargs: Any):
+        _materialize_deferred_annotations(namespace)
+        return super().__new__(mcs, name, bases, namespace, **kwargs)
+
+
+class Model(_PersistenceModel, metaclass=_ModelMeta):
+    """Python 3.10–3.14 compatible public persistence model base."""
+
+
+class _PersistentMessageMeta(_ModelMeta):
     def __init__(cls, name: str, bases: tuple, namespace: dict, **kwargs: Any):
         super().__init__(name, bases, namespace, **kwargs)
 
@@ -199,8 +233,7 @@ def serialize_persistent_message(
     iris_classname = resolve_iris_classname(msg_cls)
     _ensure_schema(msg_cls, iris_classname)
 
-    iris_obj = iris_persistence.materialize(
-        message,
+    iris_obj = message.to_iris(
         auto_sync=False,
         validate=False,
     )
@@ -215,36 +248,14 @@ def deserialize_persistent_message(
     if not iris_classname:
         return serial
 
-    msg_cls = _IRIS_TO_MESSAGE_CLASS_CACHE.get(iris_classname)
-    if msg_cls is None:
-        python_classname, python_classpath, strict = _resolve_python_message_metadata(
-            iris_classname
-        )
-        if not python_classname:
-            return serial
-
-        try:
-            msg_cls = load_python_class(python_classname, python_classpath)
-        except (AttributeError, ModuleNotFoundError, PersistentMessageError) as exc:
-            if strict:
-                raise PersistentMessageError(
-                    f"IRIS class {iris_classname!r} is marked as a PersistentMessage for "
-                    f"Python class {python_classname!r}, but that Python class could not "
-                    "be imported. Ensure the message class is importable, or register it "
-                    "through CLASSES so migration writes IOP_PYTHON_CLASSPATH."
-                ) from exc
-            return serial
-
-        if not is_persistent_message_class(msg_cls):
-            if strict:
-                raise PersistentMessageError(
-                    f"IRIS class {iris_classname!r} maps to {python_classname!r}, "
-                    "but that class is not a PersistentMessage subclass."
-                )
-            return serial
-
-        _prepare_message_class(msg_cls, iris_classname, registered=False)
-        _IRIS_TO_MESSAGE_CLASS_CACHE[iris_classname] = msg_cls
+    resolution = _resolve_persistent_message_class(iris_classname)
+    if resolution.state is _PersistentMessageResolutionState.UNMAPPED:
+        return serial
+    if resolution.state is _PersistentMessageResolutionState.INVALID:
+        assert resolution.error is not None
+        raise resolution.error
+    msg_cls = resolution.message_class
+    assert msg_cls is not None
 
     known_pk = _safe_get_object_id(serial)
     return msg_cls.from_iris(serial, known_pk=known_pk or "")
@@ -353,7 +364,7 @@ def _ensure_schema(msg_cls: type, iris_classname: str) -> None:
         raise PersistentMessageError(
             f"{get_python_classname(msg_cls)} has auto_sync=True but mode="
             f"{getattr(msg_cls, '_sync_mode', None)!r}. Runtime auto-sync is only allowed "
-            "with mode='extend'."
+            "with mode='managed'."
         )
 
     _prepare_message_class(msg_cls, iris_classname, registered=False)
@@ -372,8 +383,12 @@ def _prepare_message_class(
     if registered:
         msg_cls._iop_registered_classname = iris_classname
     _set_message_parameters(msg_cls)
-    _cache_mapping(get_python_classname(msg_cls), iris_classname)
-    _IRIS_TO_MESSAGE_CLASS_CACHE[iris_classname] = msg_cls
+    _cache_mapping(
+        get_python_classname(msg_cls),
+        iris_classname,
+        python_classpath=get_python_classpath(msg_cls),
+        message_class=msg_cls,
+    )
 
 
 def _set_message_parameters(msg_cls: type) -> None:
@@ -388,10 +403,37 @@ def _set_message_parameters(msg_cls: type) -> None:
     msg_cls._parameters = parameters
 
 
-def _cache_mapping(python_classname: str, iris_classname: str) -> None:
+def _cache_mapping(
+    python_classname: str,
+    iris_classname: str,
+    *,
+    python_classpath: str | None | object = _CACHE_VALUE_UNSET,
+    strict: bool = True,
+    message_class: type | None = None,
+) -> None:
+    previous_iris = _PYTHON_TO_IRIS_CACHE.get(python_classname)
+    if previous_iris and previous_iris != iris_classname:
+        _IRIS_TO_PYTHON_CACHE.pop(previous_iris, None)
+        _IRIS_TO_PYTHON_CLASSPATH_CACHE.pop(previous_iris, None)
+        _IRIS_TO_PYTHON_STRICT_CACHE.pop(previous_iris, None)
+        _IRIS_TO_MESSAGE_CLASS_CACHE.pop(previous_iris, None)
+
+    previous_python = _IRIS_TO_PYTHON_CACHE.get(iris_classname)
+    if previous_python and previous_python != python_classname:
+        if _PYTHON_TO_IRIS_CACHE.get(previous_python) == iris_classname:
+            _PYTHON_TO_IRIS_CACHE.pop(previous_python, None)
+        _IRIS_TO_MESSAGE_CLASS_CACHE.pop(iris_classname, None)
+
     _PYTHON_TO_IRIS_CACHE[python_classname] = iris_classname
     _IRIS_TO_PYTHON_CACHE[iris_classname] = python_classname
-    _IRIS_TO_PYTHON_STRICT_CACHE[iris_classname] = True
+    _IRIS_TO_PYTHON_STRICT_CACHE[iris_classname] = strict
+    if python_classpath is not _CACHE_VALUE_UNSET:
+        if python_classpath:
+            _IRIS_TO_PYTHON_CLASSPATH_CACHE[iris_classname] = str(python_classpath)
+        else:
+            _IRIS_TO_PYTHON_CLASSPATH_CACHE.pop(iris_classname, None)
+    if message_class is not None:
+        _IRIS_TO_MESSAGE_CLASS_CACHE[iris_classname] = message_class
 
 
 def _resolve_python_message_metadata(
@@ -416,13 +458,73 @@ def _resolve_python_message_metadata(
         python_classname = iris_classname_to_python_classname(iris_classname)
 
     if python_classname and strict:
-        _cache_mapping(python_classname, iris_classname)
-        if python_classpath:
-            _IRIS_TO_PYTHON_CLASSPATH_CACHE[iris_classname] = python_classpath
+        _cache_mapping(
+            python_classname,
+            iris_classname,
+            python_classpath=python_classpath,
+            strict=strict,
+        )
 
     return python_classname, python_classpath, strict
 
 
+def _resolve_persistent_message_class(
+    iris_classname: str,
+) -> _PersistentMessageResolution:
+    cached = _IRIS_TO_MESSAGE_CLASS_CACHE.get(iris_classname)
+    if cached is not None:
+        return _PersistentMessageResolution(
+            _PersistentMessageResolutionState.RESOLVED,
+            message_class=cached,
+        )
+
+    python_classname, python_classpath, strict = _resolve_python_message_metadata(
+        iris_classname
+    )
+    if not python_classname:
+        return _PersistentMessageResolution(
+            _PersistentMessageResolutionState.UNMAPPED
+        )
+
+    try:
+        msg_cls = load_python_class(python_classname, python_classpath)
+    except (AttributeError, ModuleNotFoundError, PersistentMessageError) as exc:
+        if not strict:
+            return _PersistentMessageResolution(
+                _PersistentMessageResolutionState.UNMAPPED
+            )
+        error = PersistentMessageError(
+            f"IRIS class {iris_classname!r} is marked as a PersistentMessage for "
+            f"Python class {python_classname!r}, but that Python class could not "
+            "be imported. Ensure the message class is importable, or register it "
+            "through CLASSES so migration writes IOP_PYTHON_CLASSPATH."
+        )
+        error.__cause__ = exc
+        return _PersistentMessageResolution(
+            _PersistentMessageResolutionState.INVALID,
+            error=error,
+        )
+
+    if not is_persistent_message_class(msg_cls):
+        if not strict:
+            return _PersistentMessageResolution(
+                _PersistentMessageResolutionState.UNMAPPED
+            )
+        return _PersistentMessageResolution(
+            _PersistentMessageResolutionState.INVALID,
+            error=PersistentMessageError(
+                f"IRIS class {iris_classname!r} maps to {python_classname!r}, "
+                "but that class is not a PersistentMessage subclass."
+            ),
+        )
+
+    _prepare_message_class(msg_cls, iris_classname, registered=False)
+    return _PersistentMessageResolution(
+        _PersistentMessageResolutionState.RESOLVED,
+        message_class=msg_cls,
+    )
+
+
 def get_iris_class_parameter(
     iris_classname: str,
     parameter_name: str,

{iris_pex_embedded_python-4.0.2b1 → iris_pex_embedded_python-4.1.0b1}/src/iop/messages/serialization.py

@@ -104,6 +104,9 @@ class MessageSerializer:
                 f"Failed to load class {serial.classname}: {str(e)}"
             ) from e
 
+        if not isinstance(msg_class, type):
+            raise SerializationError(f"Class {msg_class} must be a class")
+
         if is_dataclass(msg_class) and issubclass(msg_class, BaseModel):
             raise SerializationError(
                 f"Class '{msg_class.__name__}' combines @dataclass with PydanticMessage, which are incompatible. "

iris_pex_embedded_python-4.0.2b1/src/iop/migration/io.py → iris_pex_embedded_python-4.1.0b1/src/iop/migration/_conversion.py

@@ -14,8 +14,6 @@ def dict_to_xml(data: dict[str, Any]) -> str:
 
 
 def xml_to_json(xml_string: str) -> str:
-    """Convert an XML production export to the JSON shape used by Production."""
-
     def postprocessor(path, key, value):
         return key, "" if value is None else value
 
@@ -44,7 +42,6 @@ def string_to_stream(iris, string: str, buffer=1000000):
 
 
 def guess_path(module: str, path: str) -> str:
-    """Determine the full file path for a module name under a base path."""
     if not module:
         raise ValueError("Module name cannot be empty")