iris-pex-embedded-python 4.0.0b13__py3-none-any.whl → 4.0.0b15__py3-none-any.whl

iop/__init__.py

@@ -117,46 +117,137 @@ class OutboundAdapter(_OutboundAdapter):
 
 
 class BusinessService(_BusinessService):
-    """Inbound production entry point.
+    """Purpose:
+        Inbound production entry point for messages entering an IoP production.
 
-    Use for message-driven services or Python services that receive data and
-    send messages into a production. For polling services, prefer
-    PollingBusinessService. For task recipes, see
-    docs/cookbooks/add-polling-service.md and docs/cookbooks/hl7v2-native-input.md.
+    Use when:
+        External data, an adapter, or custom code must send a message into the
+        production graph.
+
+    Lifecycle:
+        IRIS calls on_process_input(); the default implementation delegates to
+        on_process_input(request).
+
+    Best practices:
+        Declare outbound routes with target() and wire them in a Production
+        graph. Use PollingBusinessService for scheduled Python polling.
+
+    Common mistakes:
+        Do not put startup work in __init__(); use on_init(). Do not instantiate
+        downstream components directly.
+
+    Minimal example:
+        class FileIn(BusinessService):
+            Output = target()
+
+            def on_process_input(self, request):
+                self.send_request_async(self.Output, request)
+
+    Related:
+        docs/cookbooks/add-polling-service.md,
+        docs/cookbooks/hl7v2-native-input.md
     """
 
     pass
 
 
 class PollingBusinessService(_PollingBusinessServiceMixin, BusinessService):
-    """Scheduled inbound service called by the default IRIS inbound adapter.
+    """Purpose:
+        Scheduled Python service called by the default IRIS inbound adapter.
+
+    Use when:
+        A production must poll an API, directory, queue, database, or other
+        source from Python.
+
+    Lifecycle:
+        IRIS calls on_process_input(); the mixin delegates that call to
+        on_poll().
+
+    Best practices:
+        Put one polling cycle in on_poll(). Declare outbound routes with
+        target() and send messages with send_request_async(...).
+
+    Common mistakes:
+        Do not block forever inside on_poll(). Do not put startup work in
+        __init__(); use on_init().
+
+    Minimal example:
+        class ApiPoller(PollingBusinessService):
+            Output = target()
+
+            def on_poll(self):
+                self.send_request_async(self.Output, MyRequest())
 
-    Declare outbound routes with target() and send messages with
-    send_request_async(...). Do not put startup work in __init__(); use
-    on_init(). See docs/cookbooks/add-polling-service.md.
+    Related:
+        docs/cookbooks/add-polling-service.md
     """
 
     pass
 
 
 class BusinessOperation(_BusinessOperation):
-    """Outbound side-effect boundary for production messages.
+    """Purpose:
+        Outbound side-effect boundary for production messages.
 
-    Use operations for external APIs, file writes, database writes, FHIR
-    submission, and other side effects. Dispatch can use on_message(), typed
-    one-argument methods, or @handler(MessageType). See
-    docs/cookbooks/add-business-operation.md.
+    Use when:
+        A production must call an external API, write a file, update a database,
+        submit FHIR resources, or perform another side effect.
+
+    Lifecycle:
+        IRIS calls on_message(request). IoP can dispatch to @handler methods,
+        typed one-argument methods, or the on_message fallback.
+
+    Best practices:
+        Keep external-system code here. Return a response message when callers
+        expect synchronous results.
+
+    Common mistakes:
+        Do not put routing orchestration in an operation when a BusinessProcess
+        should own the decision.
+
+    Minimal example:
+        class SubmitOrder(BusinessOperation):
+            def on_message(self, request):
+                return SubmitResult(ok=True)
+
+    Related:
+        docs/cookbooks/add-business-operation.md
     """
 
     pass
 
 
 class BusinessProcess(_BusinessProcess):
-    """Routing, orchestration, decision, and transformation component.
+    """Purpose:
+        Routing, orchestration, decision, and transformation component.
+
+    Use when:
+        A production needs branching, enrichment, transformation, fan-out,
+        request/reply orchestration, or response aggregation.
 
-    Declare outbound routes with target() and connect them in a Production
-    graph. Dispatch can use on_message(), typed one-argument methods, or
-    @handler(MessageType). See docs/cookbooks/add-business-process.md.
+    Lifecycle:
+        IRIS calls on_message(request). For async requests, IRIS can later call
+        on_response(...) and on_complete(...).
+
+    Best practices:
+        Declare outbound routes with target() and wire them with
+        Production.connect(...). Use @handler(MessageType) or typed methods for
+        multiple message types.
+
+    Common mistakes:
+        Do not hard-code target component names when target() can expose a
+        configurable route.
+
+    Minimal example:
+        class Router(BusinessProcess):
+            Accepted = target()
+
+            def on_message(self, request):
+                return self.send_request_sync(self.Accepted, request)
+
+    Related:
+        docs/cookbooks/add-business-process.md,
+        docs/cookbooks/production-settings-and-targets.md
     """
 
     pass
@@ -175,12 +266,34 @@ class DuplexProcess(_PrivateSessionProcess):
 
 
 class Message(_Message):
-    """Python-only JSON-serialized message contract.
-
-    Use @dataclass for ordinary app messages between IoP components. Prefer
-    PersistentMessage only when IRIS needs a native persistent message body. See
-    docs/cookbooks/add-business-process.md and
-    docs/cookbooks/add-business-operation.md.
+    """Purpose:
+        Python-only JSON-serialized message contract.
+
+    Use when:
+        IoP components exchange structured Python data and IRIS does not need a
+        native persistent message body.
+
+    Lifecycle:
+        IoP serializes dataclass fields into IOP.Message and restores the Python
+        class on receipt.
+
+    Best practices:
+        Decorate subclasses with @dataclass. Use PydanticMessage when runtime
+        validation is more important.
+
+    Common mistakes:
+        Do not use Message without @dataclass. Do not register Message classes
+        in CLASSES; use PersistentMessage for native IRIS message bodies.
+
+    Minimal example:
+        @dataclass
+        class OrderRequest(Message):
+            order_id: str
+
+    Related:
+        docs/cookbooks/add-business-process.md,
+        docs/cookbooks/add-business-operation.md,
+        docs/getting-started/register-component.md
     """
 
     pass

iop/components/business_host.py

@@ -108,23 +108,30 @@ class _BusinessHost(_Common):
         timeout: int = -1,
         description: str | None = None,
     ) -> Any:
-        """Send message synchronously to target component.
+        """Purpose:
+            Send a message to a target component and wait for the response.
 
-        Prefer a target() attribute such as self.Output for configurable
-        routing. BusinessProcess examples are in
-        docs/cookbooks/add-business-process.md.
+        Use when:
+            The caller needs the target response before continuing.
 
-        Args:
-            target: Name of target component
-            request: Message to send
-            timeout: Timeout in seconds, -1 means wait forever
-            description: Optional description for logging
-
-        Returns:
-            Response from target component
-
-        Raises:
-            TypeError: If request is invalid type
+        Lifecycle:
+            IoP serializes request, calls the IRIS synchronous dispatch API, and
+            deserializes the response before returning.
+
+        Best practices:
+            Pass a target() attribute such as self.Output so the route is
+            configurable in the Production graph.
+
+        Common mistakes:
+            Do not use synchronous calls for long-running work unless the caller
+            really must block.
+
+        Minimal example:
+            response = self.send_request_sync(self.Output, request)
+
+        Related:
+            docs/cookbooks/add-business-process.md,
+            docs/cookbooks/production-settings-and-targets.md
         """
         target = resolve_target(target)
         return self.iris_handle.dispatchSendRequestSync(
@@ -138,19 +145,29 @@ class _BusinessHost(_Common):
         request: Message | Any,
         description: str | None = None,
     ) -> None:
-        """Send message asynchronously to target component.
+        """Purpose:
+            Send a message to a target component without waiting for a response.
 
-        Prefer a target() attribute such as self.Output for configurable
-        routing. Polling service examples are in
-        docs/cookbooks/add-polling-service.md.
+        Use when:
+            A service or operation should enqueue downstream work and continue.
 
-        Args:
-            target: Name of target component
-            request: Message to send
-            description: Optional description for logging
-
-        Raises:
-            TypeError: If request is invalid type
+        Lifecycle:
+            IoP serializes request and calls the IRIS asynchronous dispatch API.
+
+        Best practices:
+            Pass a target() attribute such as self.Output so the route is
+            configurable in the Production graph.
+
+        Common mistakes:
+            Do not use this helper when the caller requires a response; use
+            send_request_sync(...) or the BusinessProcess async response flow.
+
+        Minimal example:
+            self.send_request_async(self.Output, request)
+
+        Related:
+            docs/cookbooks/add-polling-service.md,
+            docs/cookbooks/production-settings-and-targets.md
         """
         target = resolve_target(target)
         return self.iris_handle.dispatchSendRequestAsync(target, request, description)

iop/components/business_operation.py

@@ -19,16 +19,31 @@ class _BusinessOperation(_BusinessHost):
     adapter: Any = None
 
     def on_message(self, request: Any) -> Any:
-        """Handle incoming messages.
-
-        Process messages received from other production components and either
-        send to external system or forward to another component.
-
-        Args:
-            request: The incoming message
-
-        Returns:
-            Response message
+        """Purpose:
+            Handle an incoming message sent to a BusinessOperation.
+
+        Use when:
+            The operation must perform an outbound side effect or submit data to
+            an external system.
+
+        Lifecycle:
+            IRIS invokes this hook for operation requests unless dispatch routes
+            the message to a @handler or typed one-argument method first.
+
+        Best practices:
+            Keep side effects isolated here. Return a response message when the
+            caller uses send_request_sync(...).
+
+        Common mistakes:
+            Do not put routing decisions here when a BusinessProcess should
+            orchestrate them.
+
+        Minimal example:
+            def on_message(self, request):
+                return SubmitResult(ok=True)
+
+        Related:
+            docs/cookbooks/add-business-operation.md
         """
         warnings.warn(
             f"{self.__class__.__name__} did not override on_message(); "

iop/components/business_process.py

@@ -20,16 +20,35 @@ class _BusinessProcess(_BusinessHost):
     DISPATCH: list[tuple] = []
     PERSISTENT_PROPERTY_LIST: list[str] | None = None
 
-    def on_message(self, request: Any) -> Any:
-        """Handle incoming messages.
-
-        Args:
-            request: The incoming message
-
-        Returns:
-            Response message
-        """
-        return self.on_request(request)
+    def on_message(self, request: Any) -> Any:
+        """Purpose:
+            Handle an incoming message sent to a BusinessProcess.
+
+        Use when:
+            The process owns routing, orchestration, transformation, or
+            decisions for a request.
+
+        Lifecycle:
+            IRIS invokes this hook for process requests unless dispatch routes
+            the message to a @handler or typed one-argument method first. The
+            default implementation delegates to on_request(request).
+
+        Best practices:
+            Declare outbound routes with target() and call
+            send_request_sync(...) or send_request_async(...).
+
+        Common mistakes:
+            Do not hide routing in raw strings when target() can make routes
+            configurable in the production graph.
+
+        Minimal example:
+            def on_message(self, request):
+                return self.send_request_sync(self.Output, request)
+
+        Related:
+            docs/cookbooks/add-business-process.md
+        """
+        return self.on_request(request)
 
     def on_request(self, request: Any) -> Any:
         """Process initial requests sent to this component.
@@ -42,38 +61,67 @@ class _BusinessProcess(_BusinessHost):
         """
         return None
 
-    def on_response(
+    def on_response(
         self,
         request: Any,
         response: Any,
         call_request: Any,
         call_response: Any,
         completion_key: str,
-    ) -> Any:
-        """Handle responses to messages sent by this component.
-
-        Args:
-            request: The initial request message
-            response: The response message
-            call_request: The request sent to the target
-            call_response: The incoming response
-            completion_key: The completion key specified in the outgoing SendAsync() method
-
-        Returns:
-            Response message
-        """
+    ) -> Any:
+        """Purpose:
+            Handle one async response received by a BusinessProcess.
+
+        Use when:
+            The process sends async requests and needs to merge, inspect, or
+            transform each returned response.
+
+        Lifecycle:
+            IRIS calls on_response(...) after an async target response arrives.
+            on_complete(...) can run after all expected responses complete.
+
+        Best practices:
+            Use completion_key to identify which async call returned. Return
+            the accumulated or transformed response state.
+
+        Common mistakes:
+            Do not assume responses arrive in request order.
+
+        Minimal example:
+            def on_response(self, request, response, call_request, call_response, completion_key):
+                return call_response
+
+        Related:
+            docs/cookbooks/add-business-process.md
+        """
         return response
 
-    def on_complete(self, request: Any, response: Any) -> Any:
-        """Called after all responses to requests sent by this component have been handled.
-
-        Args:
-            request: The initial request message
-            response: The response message
-
-        Returns:
-            Response message
-        """
+    def on_complete(self, request: Any, response: Any) -> Any:
+        """Purpose:
+            Finish async request orchestration for a BusinessProcess.
+
+        Use when:
+            The process must return or finalize an aggregate response after
+            async sends, timers, or response handling.
+
+        Lifecycle:
+            IRIS calls on_complete(request, response) after expected async
+            responses have been handled or the completion path is reached.
+
+        Best practices:
+            Return the final response message expected by the original caller.
+
+        Common mistakes:
+            Do not put per-response logic here; use on_response(...) for each
+            individual async response.
+
+        Minimal example:
+            def on_complete(self, request, response):
+                return response
+
+        Related:
+            docs/cookbooks/add-business-process.md
+        """
         return response
 
     @input_serializer_param(0, "response")
@@ -93,19 +141,33 @@ class _BusinessProcess(_BusinessHost):
         description: str | None = None,
         completion_key: str | None = None,
         response_required: bool = True,
-    ) -> None:
-        """Send the specified message to the target business process or business operation asynchronously.
-
-        Args:
-            target: The name of the business process or operation to receive the request
-            request: The message to send to the target
-            description: An optional description property in the message header
-            completion_key: A string that will be returned with the response if the maximum time is exceeded
-            response_required: Whether a response is required
-
-        Raises:
-            TypeError: If request is not of type Message or IRISObject
-        """
+    ) -> None:
+        """Purpose:
+            Send a message asynchronously from a BusinessProcess.
+
+        Use when:
+            The process should continue without blocking for a target response,
+            or when responses will be handled later by on_response(...).
+
+        Lifecycle:
+            IoP serializes request before dispatching to IRIS. IRIS can call
+            on_response(...) and on_complete(...) when response_required is true.
+
+        Best practices:
+            Pass a target() attribute such as self.Output. Use completion_key
+            for fan-out or multiple async calls.
+
+        Common mistakes:
+            Do not pass an unresolved component instance or a hard-coded route
+            when the route should be configurable.
+
+        Minimal example:
+            self.send_request_async(self.Output, request, completion_key="out")
+
+        Related:
+            docs/cookbooks/add-business-process.md,
+            docs/cookbooks/production-settings-and-targets.md
+        """
         # Convert boolean to int for Iris API
         if response_required:
             response_required = 1  # type: ignore

iop/components/business_service.py

@@ -42,11 +42,32 @@ class _BusinessService(_BusinessHost):
         return
 
     def on_message(self, request=None):
-        """Handle a message received by the business service.
+        """Purpose:
+            Handle a message received by a BusinessService.
 
-        Override this for message-driven services. Adapter-driven services may
-        still override on_process_input() directly when they need the lower
-        level IRIS ProcessInput hook.
+        Use when:
+            A service receives data from an adapter, Director API call, or
+            custom entry point and should send work into the production graph.
+
+        Lifecycle:
+            The default on_process_input(message_input) implementation delegates
+            to on_message(message_input).
+
+        Best practices:
+            Validate or normalize inbound data, then send a Message to a target
+            declared with target().
+
+        Common mistakes:
+            Do not call downstream component methods directly. Use
+            send_request_async(...) or send_request_sync(...).
+
+        Minimal example:
+            def on_message(self, request):
+                self.send_request_async(self.Output, request)
+
+        Related:
+            docs/cookbooks/add-polling-service.md,
+            docs/cookbooks/hl7v2-native-input.md
         """
         warnings.warn(
             f"{self.__class__.__name__} did not override on_message() or "

iop/components/common.py

@@ -223,10 +223,36 @@ class _Common:
         self._log_to_console = value
         self.logger = LogManager.get_logger(self.__class__.__name__, value)
 
-    # Lifecycle methods
-    def on_init(self) -> None:
-        """Initialize component when started."""
-        pass
+    # Lifecycle methods
+    def on_init(self) -> None:
+        """Purpose:
+            Component startup hook.
+
+        Use when:
+            A component needs to initialize clients, caches, credentials,
+            counters, or other runtime state after IRIS creates the host.
+
+        Lifecycle:
+            IoP calls on_init() from the internal dispatch startup path. IRIS
+            may allocate the Python object without calling __init__().
+
+        Best practices:
+            Keep initialization idempotent and quick. Read production settings
+            from self inside this method.
+
+        Common mistakes:
+            Do not put component startup work in __init__(); it may not run in
+            the IRIS component lifecycle.
+
+        Minimal example:
+            def on_init(self):
+                self.client = make_client(self.Endpoint)
+
+        Related:
+            docs/ai-coding.md,
+            docs/cookbooks/index.md
+        """
+        pass
 
     def on_tear_down(self) -> None:
         """Clean up component before termination."""

iop/components/polling_business_service.py

@@ -9,10 +9,30 @@ class _PollingBusinessServiceMixin:
         return "Ens.InboundAdapter"
 
     def on_poll(self):
-        """Run one scheduled polling cycle.
+        """Purpose:
+            Run one scheduled polling cycle.
 
-        Override this for services that are called by the default IRIS inbound
-        adapter and fetch their own external data.
+        Use when:
+            A PollingBusinessService fetches or discovers new work from Python.
+
+        Lifecycle:
+            The default IRIS inbound adapter calls on_process_input(), and this
+            mixin delegates that call to on_poll().
+
+        Best practices:
+            Do a bounded unit of work, then return. Send produced messages with
+            send_request_async(self.Output, message).
+
+        Common mistakes:
+            Do not create an infinite loop inside on_poll(); use the production
+            schedule or call interval for repeated execution.
+
+        Minimal example:
+            def on_poll(self):
+                self.send_request_async(self.Output, PollRequest())
+
+        Related:
+            docs/cookbooks/add-polling-service.md
         """
         warnings.warn(
             f"{self.__class__.__name__} did not override on_poll() or "

iop/messages/decorators.py

@@ -9,6 +9,7 @@ from .dispatch import handler as handler
 def input_serializer(fonction: Callable) -> Callable:
     """Decorator that serializes all input arguments."""
 
+    @wraps(fonction)
     def _dispatch_serializer(self, *params: Any, **param2: Any) -> Any:
         serialized = [dispatch_serializer(param) for param in params]
         param2 = {key: dispatch_serializer(value) for key, value in param2.items()}
@@ -41,6 +42,7 @@ def input_serializer_param(position: int, name: str) -> Callable:
 def output_deserializer(fonction: Callable) -> Callable:
     """Decorator that deserializes function output."""
 
+    @wraps(fonction)
     def _dispatch_deserializer(self, *params: Any, **param2: Any) -> Any:
         return dispatch_deserializer(fonction(self, *params, **param2))
 
@@ -50,6 +52,7 @@ def output_deserializer(fonction: Callable) -> Callable:
 def input_deserializer(fonction: Callable) -> Callable:
     """Decorator that deserializes all input arguments."""
 
+    @wraps(fonction)
     def _dispatch_deserializer(self, *params: Any, **param2: Any) -> Any:
         serialized = [dispatch_deserializer(param) for param in params]
         param2 = {key: dispatch_deserializer(value) for key, value in param2.items()}
@@ -61,6 +64,7 @@ def input_deserializer(fonction: Callable) -> Callable:
 def output_serializer(fonction: Callable) -> Callable:
     """Decorator that serializes function output."""
 
+    @wraps(fonction)
     def _dispatch_serializer(self, *params: Any, **param2: Any) -> Any:
         return dispatch_serializer(fonction(self, *params, **param2))
 

iop/messages/dispatch.py

@@ -7,6 +7,7 @@ from typing import Any
 from .persistent import (
     deserialize_persistent_message,
     get_iris_object_classname,
+    is_persistent_message_class,
     is_persistent_message_instance,
     serialize_persistent_message,
 )
@@ -20,7 +21,9 @@ from .serialization import (
 )
 from .validation import (
     is_iris_object_instance,
+    is_message_class,
     is_message_instance,
+    is_pickle_message_class,
     is_pickle_message_instance,
 )
 
@@ -326,7 +329,23 @@ def _message_class_name(message_type: Any) -> str | None:
     if is_iris_object_instance(message_type):
         return f"{type(message_type).__module__}.{type(message_type).__name__}"
 
+    if message_type is Any or message_type is object:
+        return None
+
     if not isinstance(message_type, type):
         return None
 
+    if not _is_dispatch_message_class(message_type):
+        return None
+
     return f"{message_type.__module__}.{message_type.__name__}"
+
+
+def _is_dispatch_message_class(klass: type) -> bool:
+    if is_message_class(klass):
+        return True
+    if is_pickle_message_class(klass):
+        return True
+    if is_persistent_message_class(klass):
+        return True
+    return klass.__module__.startswith("iris")

iop/messages/validation.py

@@ -1,12 +1,14 @@
 import dataclasses
 from typing import Any
 
-from .base import BaseModel, _Message, _PickleMessage, _PydanticPickleMessage
+from .base import _Message, _PickleMessage, _PydanticMessage, _PydanticPickleMessage
+
+_PYDANTIC_BASE = _PydanticMessage.__mro__[1]
 
 
 def is_message_instance(obj: Any) -> bool:
     """Check if object is a valid Message instance."""
-    if isinstance(obj, BaseModel):
+    if isinstance(obj, _PYDANTIC_BASE):
         return True
     if is_message_class(type(obj)):
         if not dataclasses.is_dataclass(obj):
@@ -38,15 +40,15 @@ def is_iris_object_instance(obj: Any) -> bool:
 
 def is_message_class(klass: type) -> bool:
     """Check if class is a Message type."""
-    if issubclass(klass, _Message):
-        return True
-    return False
+    try:
+        return issubclass(klass, (_Message, _PYDANTIC_BASE))
+    except TypeError:
+        return False
 
 
 def is_pickle_message_class(klass: type) -> bool:
     """Check if class is a PickleMessage type."""
-    if issubclass(klass, _PickleMessage):
-        return True
-    if issubclass(klass, _PydanticPickleMessage):
-        return True
-    return False
+    try:
+        return issubclass(klass, (_PickleMessage, _PydanticPickleMessage))
+    except TypeError:
+        return False

iop/production/model.py

@@ -42,15 +42,35 @@ _MISSING = object()
 
 
 class Production(_DeclarativeProductionMixin):
-    """Python authoring DSL for IRIS interoperability production topology.
-
-    Python Production is the source of truth for Python-authored topology.
-    IRIS remains the runtime source of truth. Imported graphs are operational
-    reconstructions until metadata persistence makes round-trip fidelity possible.
-
-    For app-building workflows, see docs/cookbooks/index.md. New applications
-    usually export PRODUCTIONS = [prod] from settings.py and declare topology
-    with service(), process(), operation(), target(), and connect().
+    """Purpose:
+        Python authoring DSL for IRIS interoperability production topology.
+
+    Use when:
+        A project should declare services, processes, operations, settings, and
+        graph connections in Python.
+
+    Lifecycle:
+        A settings.py module exports PRODUCTIONS = [prod]. Migration renders the
+        graph to IRIS; IRIS remains the runtime source of truth.
+
+    Best practices:
+        Declare topology with service(), process(), operation(), target(), and
+        connect(). Keep the Production object import-safe.
+
+    Common mistakes:
+        Do not execute migration or runtime side effects at module import time.
+        Do not use raw CLASSES entries for graph components.
+
+    Minimal example:
+        prod = Production("Demo.Production")
+        svc = prod.service("Demo.Service", MyService)
+        op = prod.operation("Demo.Operation", MyOperation)
+        prod.connect(svc.Output, op)
+        PRODUCTIONS = [prod]
+
+    Related:
+        docs/cookbooks/hello-world-production.md,
+        docs/production-graph.md
     """
 
     def __init__(

iop/production/types.py

@@ -35,11 +35,33 @@ class TargetSetting(Setting):
 
 
 def target(**kwargs: Any) -> TargetSetting:
-    """Declare an outbound target setting on a component class.
+    """Purpose:
+        Declare a configurable outbound target setting on a component class.
 
-    Use target() on BusinessService and BusinessProcess classes, then connect
-    the target in a Production graph with prod.connect(...). See
-    docs/cookbooks/production-settings-and-targets.md.
+    Use when:
+        A service or process sends messages to another production component.
+
+    Lifecycle:
+        The descriptor becomes an IRIS production setting. Production.connect(...)
+        binds it to a concrete target component.
+
+    Best practices:
+        Use target() instead of hard-coded component names for routes that
+        should be visible and configurable in the production graph.
+
+    Common mistakes:
+        Do not use setting(...) for outbound routing when target() should expose
+        a production target.
+
+    Minimal example:
+        class Router(BusinessProcess):
+            Output = target()
+
+        prod.connect(router.Output, operation)
+
+    Related:
+        docs/cookbooks/production-settings-and-targets.md,
+        docs/production-graph.md
     """
     return TargetSetting(**kwargs)
 

{iris_pex_embedded_python-4.0.0b13.dist-info → iris_pex_embedded_python-4.0.0b15.dist-info}/METADATA

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

{iris_pex_embedded_python-4.0.0b13.dist-info → iris_pex_embedded_python-4.0.0b15.dist-info}/RECORD

@@ -1,4 +1,4 @@
-iop/__init__.py,sha256=XIjNdHI_c6jz3N0dhTPlW01S80hueLfoO6v3JFQWWsc,7460
+iop/__init__.py,sha256=4QGYNWs4t-Zt4-WfjHXmKRosWS5jZ5A27vl2hiObCVc,10621
 iop/__main__.py,sha256=2rUNM7vaYK0W57Jj72rm7GORyIFLMXKwPq3QNLwYBmY,100
 iop/cli/__init__.py,sha256=Y78pBdA-ULzq1c_9xQZsFBlzm3x5xgxSzkvrH5DoM7I,31
 iop/cli/formatting.py,sha256=OLgHA1d8_paAuINQyKkYgihWMLoBhPn7kSXW5whRlIs,1606
@@ -36,27 +36,27 @@ iop/cls/IOP/Service/Remote/Handler.cls,sha256=JfsXse2jvoVvQfW8_rVEt2DCQJ9SVqReCc
 iop/cls/IOP/Service/Remote/Rest/v1.cls,sha256=33FEBVZhHqysYaLL7l0314kJu1eZXyJlvAk2l4Q-B5g,20277
 iop/components/__init__.py,sha256=uRF_YCn_ukkgzFrW0nLLMmC2jJ1dMk-ME7HX9EEEVic,880
 iop/components/async_request.py,sha256=AU36pf6NIQMM9ZYR5h6LeQry0EfXXqDaKAjsP16_hWE,2411
-iop/components/business_host.py,sha256=N0NHmJSiDrwxn2Qf7TtyvxtIB_LBTd8UwXSmFR-jjaU,11430
-iop/components/business_operation.py,sha256=sSOmwgo9j0DAcavMVdZ9hkeLEQtsXlKCOeFabG-JEMw,2332
-iop/components/business_process.py,sha256=2sin6-ApkA6Ke-85RP4qdLo7UsYSjAkWwn40IiU4vTA,7621
-iop/components/business_service.py,sha256=p_pHRRMmxt3LFkxJAZcG8Ogmyh2x2c5zICljk8wuwi4,4032
-iop/components/common.py,sha256=tRrRg925LKrh5hz4zRGo66SYR6GGmEq-skeG7kHxQ7I,18220
+iop/components/business_host.py,sha256=5EXwzZzfEVYLFlzi519GXKclTz2m5FMcqtl10lLzUyw,12089
+iop/components/business_operation.py,sha256=KycRNz-zuyJs2VneTBVcppyd3rKLekrISjbubCbzHxY,2905
+iop/components/business_process.py,sha256=1xTYwqhvJaXC-BvQ5WoGOud5QwxT9EPpvDPDX4zThXg,9839
+iop/components/business_service.py,sha256=fwSdHGFuC55_qSjFBpW-cLZmrK3Cm8Yxgk1KvxuQv2Y,4718
+iop/components/common.py,sha256=tsP2APRBnks1hVazS9dX0Q8KCoANbUsnaFTlzqOIkVY,19063
 iop/components/debugpy.py,sha256=sNFKaF9MtWBNAqxH4ubSIVqjsIpsHGjRK2jzBU-O59Y,6011
 iop/components/generator_request.py,sha256=NOllwJnY06kk_eC7cQXDQ8NBFKfQakyz3A_AgYJ5f5Y,1351
 iop/components/inbound_adapter.py,sha256=H36HcHHn7fbzUuAMG-f2CwCesOeKnE6FZPuVGCUCEXo,1130
 iop/components/log_manager.py,sha256=nIBMp4sz2Bi5tQml-LKj8cheiGk1LjNh5BiwqUupuZw,3241
 iop/components/outbound_adapter.py,sha256=Bm6KeaLR0fO3z5o9cmJxcMdIiOvdExik-Oc272WZtHg,731
-iop/components/polling_business_service.py,sha256=5rVr6DVgfK3xwEfjFHa4dsWb6wI3JXJOQQYtHLAIjSY,901
+iop/components/polling_business_service.py,sha256=1EkEW8KVx6wW7DCXnrExe2z07NcmuqJN0C6P5hxVNRM,1562
 iop/components/private_session_duplex.py,sha256=IZ50ThI074qwFF1wFyhFCsSJK0huyuoIeVxwlGyweeQ,5157
 iop/components/private_session_process.py,sha256=edugk8iLTjaHMsz_fBuj9VE8aL66IgOz-mMlqPyk3Zc,1731
 iop/components/settings.py,sha256=USAKAisdersKlAEIk8HDu_TuYtkO-Sc3an3PXjPcDRA,6296
 iop/messages/__init__.py,sha256=k1AKplpjdqSxM5Gl7bpWAfw93xUgigovlI4SKhwKHRI,355
 iop/messages/base.py,sha256=ZrVXEz7JrYHnt5b3M7avxcJCB0_OZxm1uWm9gQ4_eAw,1906
-iop/messages/decorators.py,sha256=tMHUVeTN7zFrjfm74Z6yVIiemTCDPWozs58IeJ_slZk,2404
-iop/messages/dispatch.py,sha256=2_wbxayCwZ1pNgq2OxsFdPqV1rLq4gejO_t_1cAm5X4,9950
+iop/messages/decorators.py,sha256=CWk08k8U2aTJv7Dx1n2jp8sjZZSCD8NJPoifKLB3W2g,2488
+iop/messages/dispatch.py,sha256=Mgz0OHTQDU02Z8qPxl_lks-nlAvW6ADcJkTS4faYE-Q,10459
 iop/messages/persistent.py,sha256=ibRhRTqzwGcAqem744KZzHiouUlc8-J3ftB4zyzQYx4,16906
 iop/messages/serialization.py,sha256=BW0o-7GaceMW7RMOzOJ8g9rKEv28NYnYFwtTLmAf7Yg,9255
-iop/messages/validation.py,sha256=cbq2VaaWTcqesmV-DDwReHh8peynvEMw9h0JNf4q9kQ,1530
+iop/messages/validation.py,sha256=X6MSWsjLZDuyX1Tfx0TP3T6OI4nj1HZccwR2Z9PSubY,1606
 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
@@ -71,13 +71,13 @@ iop/production/declarative.py,sha256=IpHYO46mu7k9wnq3DpFreoALPoX1Vi8DrJb-85O_-bQ
 iop/production/diff.py,sha256=NYpcSVklaGpaZOyl933W8eLsDWcwjlf6Upbp4pVGSMU,9975
 iop/production/import_.py,sha256=twBra6j2peolFadv8WyDwZZOd9NznzAkPsk2RbOfZQM,10833
 iop/production/inspection.py,sha256=PPv9DiDS4OrnKROqV7JPbuY8Y0JR-m8syPhap3GgE4g,3363
-iop/production/model.py,sha256=snpZROI5evDfbNXpENaLRxaSDAZJ46gl5aTS220Nh8g,41192
+iop/production/model.py,sha256=CpI5OBEBBw9z40Lws1rKVL9Mx_P4fhKmwYPoqEUntKU,41705
 iop/production/planning.py,sha256=nCYrXLKlHBlUaQZPzPfqtIERIv62F2sg4gJ0b8mtcKk,23375
 iop/production/reconstruction.py,sha256=5vVteTEM6IOiQUfpe4AUQg6Nt4oaaIDR61-1l6Vu8hk,12532
 iop/production/rendering.py,sha256=UVHLICY4zWEP3W7-99TpB2WeLBNREC2N8rYSnBa_iZM,20240
 iop/production/runtime.py,sha256=6grX1u20OhHnvhzC3yPDTFEoDs_TN4mfs5MxzFzZMls,2637
 iop/production/source_inference.py,sha256=Wl3E9-1hWb4qxD1jwrrZTLSgqN-0vGhOrJtmzDWPCao,21613
-iop/production/types.py,sha256=yYYLHMrT0z1uJeI1X5ncS2Hw7zIH7ZzLQ483v_Sl6Ug,15969
+iop/production/types.py,sha256=L_wyXO8deOnqRFin74SX_K8UWILFu-VzIO5pKNa6VXY,16580
 iop/production/validation.py,sha256=14BfjrLXW1AOuP8AdBrs-CY6zynaDc8_AUD9frsYAIU,13753
 iop/runtime/__init__.py,sha256=wcyWMRuPCYE_CLd1NmgmI1M-IbFs2Gz2yIj2-EW_2AA,70
 iop/runtime/director.py,sha256=KW8BvkATK8XuIUPNBD9rMww9r3Zg4K3H54868eOgvl0,12867
@@ -91,9 +91,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.0b13.dist-info/licenses/LICENSE,sha256=rZSiBFId_sfbJ6RL0GjjPX-InNLkNS9ou7eQsikciI8,1089
-iris_pex_embedded_python-4.0.0b13.dist-info/METADATA,sha256=ZLBr8mI8obs6BR-4FLbYfxNIO8m_qjSIO9NfaDbxOlA,5284
-iris_pex_embedded_python-4.0.0b13.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-iris_pex_embedded_python-4.0.0b13.dist-info/entry_points.txt,sha256=fzS8ZFsPe8cnpEx208X60DNugCPQmuSloPeg4pyyJDY,42
-iris_pex_embedded_python-4.0.0b13.dist-info/top_level.txt,sha256=BM54-OXQ6l2BDtmesWNXckh033s9gcjoO7bfjbwZbxU,4
-iris_pex_embedded_python-4.0.0b13.dist-info/RECORD,,
+iris_pex_embedded_python-4.0.0b15.dist-info/licenses/LICENSE,sha256=rZSiBFId_sfbJ6RL0GjjPX-InNLkNS9ou7eQsikciI8,1089
+iris_pex_embedded_python-4.0.0b15.dist-info/METADATA,sha256=FAs1I9jhJCMQabHY14tAR02X2fnv_DS7Yu-yrAZLVso,5284
+iris_pex_embedded_python-4.0.0b15.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+iris_pex_embedded_python-4.0.0b15.dist-info/entry_points.txt,sha256=fzS8ZFsPe8cnpEx208X60DNugCPQmuSloPeg4pyyJDY,42
+iris_pex_embedded_python-4.0.0b15.dist-info/top_level.txt,sha256=BM54-OXQ6l2BDtmesWNXckh033s9gcjoO7bfjbwZbxU,4
+iris_pex_embedded_python-4.0.0b15.dist-info/RECORD,,