iris-pex-embedded-python 4.0.1b4__tar.gz → 4.0.1b6__tar.gz

{iris_pex_embedded_python-4.0.1b4/src/iris_pex_embedded_python.egg-info → iris_pex_embedded_python-4.0.1b6}/PKG-INFO

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

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/docs/cookbooks/production-settings-and-targets.md

@@ -55,6 +55,25 @@ prod.connect(process.Accepted, accepted)
 prod.connect(process.Rejected, rejected)
 ```
 
+When a route should have a conventional default, pass the target item name to
+`target()`:
+
+```python
+class RouteProcess(BusinessProcess):
+    Accepted = target("AcceptedOperation")
+    Rejected = target("RejectedOperation")
+
+
+process = prod.process("RouteProcess", RouteProcess)
+accepted = prod.operation("AcceptedOperation", AcceptedOperation)
+rejected = prod.operation("RejectedOperation", RejectedOperation)
+```
+
+The default target is written to the generated setting initial expression and
+to the production Host setting. IoP records the graph edge when the named target
+item exists. Use `prod.connect(...)` when the production should override the
+class default.
+
 ## Migration Command
 
 ```bash
@@ -73,4 +92,3 @@ iop --migrate settings.py --dry-run
   `target()` settings.
 - Adding a component to `settings.py` but forgetting its graph edge.
 - Using raw production dictionaries for new Python-authored topology.
-

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/docs/production-graph.md

@@ -51,6 +51,11 @@ Implemented graph import and display:
 `str(target_setting_ref)` returns the stable authoring identity, such as
 `FileInput.Output`. Runtime dispatch uses explicit target setting resolution.
 
+`target("OperationName")` declares a default target. The default is used as the
+generated IRIS property initial expression, applied to the component Host
+setting, and registered as a graph edge once the target item exists. Explicit
+Host settings and `prod.connect(...)` override the class default.
+
 Implemented production lifecycle:
 
 - `prod.start()`
@@ -143,6 +148,18 @@ orders = prod.operation(OrderOperation)
 prod.connect(file.Output, orders)
 ```
 
+For a conventional route, the target can be defaulted on the component class:
+
+```python
+class FileService(PollingBusinessService):
+    Output = target("OrderOperation")
+
+
+prod = Production("Demo.Production")
+file = prod.service("FileInput", FileService)
+orders = prod.operation("OrderOperation", OrderOperation)
+```
+
 ObjectScript and built-in IRIS components use `class_name`:
 
 ```python

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/docs/python-api.md

@@ -209,6 +209,18 @@ class FileService(BusinessService):
     )
 ```
 
+Pass a target item name to `target()` to declare a default route:
+
+```python
+class FileService(BusinessService):
+    Output = target("OrderOperation")
+```
+
+The default is used as the generated IRIS property initial expression and as the
+production Host setting. If the named item is present in the `Production`, IoP
+also records the graph edge. An explicit Host setting or `prod.connect(...)`
+overrides the default.
+
 You can also keep normal Python defaults and attach metadata with `typing.Annotated`:
 
 ```python
@@ -628,6 +640,10 @@ Progressive component methods include `pool()`, `enable()`, `disable()`,
 attributes on `ComponentRef`, so their fluent update methods use distinct names
 instead of shadowing those attributes.
 
+Declared target settings are available as dynamic `ComponentRef` attributes,
+such as `rest.my_target`, and are exposed through `dir(rest)` for runtime
+autocomplete.
+
 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.

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/docs/settings.md

@@ -210,6 +210,24 @@ PRODUCTIONS = [prod]
 `prod.connect()` sets that setting to the destination component and
 records graph edges available to Python.
 
+Pass a production item name as the first `target()` argument when a route should
+have a default target without an explicit `prod.connect(...)` call:
+
+```python
+class FileService(PollingBusinessService):
+    Output = target("OrderOperation")
+
+
+prod = Production("Demo.Production", testing_enabled=True)
+file = prod.service("FileInput", FileService)
+orders = prod.operation("OrderOperation", OrderOperation)
+```
+
+The default becomes the generated IRIS property initial expression, populates
+the component Host setting, and is recorded as a graph edge once the named
+target item exists. An explicit Host setting or `prod.connect(...)` overrides
+the class default.
+
 You can also write the same production as a class declaration. The class is a
 template; put an instance in `PRODUCTIONS`.
 

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools", "wheel"]
 
 [project]
 name = "iris_pex_embedded_python"
-version = "4.0.1b4"
+version = "4.0.1b6"
 description = "Iris Interoperability based on Embedded Python"
 readme = "README.md"
 requires-python = ">=3.10"

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/src/iop/production/component.py

@@ -66,6 +66,13 @@ class ComponentRef:
             return self.target_setting(name)
         raise AttributeError(name)
 
+    def __dir__(self) -> list[str]:
+        names = set(super().__dir__())
+        if self.component_class is not None:
+            names.update(_target_setting_names(self.component_class))
+        names.update(self.target_setting_names)
+        return sorted(names)
+
     def target_setting(self, name: str) -> TargetSettingRef:
         self.target_setting_names.add(name)
         return TargetSettingRef(
@@ -232,3 +239,12 @@ class ComponentRef:
             item["Setting"] = settings
 
         return item
+
+
+def _target_setting_names(component_class: type) -> tuple[str, ...]:
+    names: dict[str, None] = {}
+    for base in reversed(component_class.__mro__):
+        for name, value in base.__dict__.items():
+            if isinstance(value, TargetSetting):
+                names[name] = None
+    return tuple(names)

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/src/iop/production/model.py

@@ -34,6 +34,7 @@ from .types import (
     PersistentMessageRegistration,
     ProductionDiff,
     ProductionGraph,
+    TargetSetting,
     TargetSettingRef,
     _edge_identity,
 )
@@ -1055,6 +1056,35 @@ class Production(_DeclarativeProductionMixin):
                     )
         self._items.append(ref)
         self._items_by_name[ref.name] = ref
+        self._apply_target_defaults()
+
+    def _apply_target_defaults(self) -> None:
+        for ref in self._items:
+            for setting_name, target_name in self._target_default_routes(ref):
+                if setting_name not in ref.host_settings:
+                    if setting_name in ref.target_setting_names:
+                        continue
+                    ref.host_settings[setting_name] = target_name
+                ref.target_setting_names.add(setting_name)
+                if str(ref.host_settings[setting_name]) != target_name:
+                    continue
+                if target_name not in self._items_by_name:
+                    continue
+                self._register_connection(
+                    ref.name,
+                    setting_name,
+                    target_name,
+                )
+
+    def _target_default_routes(self, ref: ComponentRef) -> tuple[tuple[str, str], ...]:
+        if ref.component_class is None:
+            return ()
+        routes: list[tuple[str, str]] = []
+        for setting_name, descriptor in _target_settings(ref.component_class):
+            target_name = _target_default_name(descriptor.default)
+            if target_name:
+                routes.append((setting_name, target_name))
+        return tuple(routes)
 
     def _diff_current(
         self,
@@ -1141,3 +1171,21 @@ def _connection_mode(mode: str) -> str:
         "Unsupported connection mode: "
         f"{mode!r}. Expected 'replace', 'add', or 'remove'."
     )
+
+
+def _target_settings(
+    component_class: type,
+) -> tuple[tuple[str, TargetSetting], ...]:
+    descriptors: dict[str, TargetSetting] = {}
+    for base in reversed(component_class.__mro__):
+        for name, value in base.__dict__.items():
+            if isinstance(value, TargetSetting):
+                descriptors[name] = value
+    return tuple(descriptors.items())
+
+
+def _target_default_name(value: Any) -> str:
+    if value is None:
+        return ""
+    name = getattr(value, "name", value)
+    return str(name).strip()

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6}/src/iop/production/types.py

@@ -12,11 +12,11 @@ from ..components.settings import Category, Setting, controls
 class TargetSetting(Setting):
     """Production target setting descriptor created by target()."""
 
-    def __init__(self, **kwargs: Any):
+    def __init__(self, default: Any = "", **kwargs: Any):
         kwargs.setdefault("iris_type", "Ens.DataType.ConfigName")
         kwargs.setdefault("category", Category.BASIC)
         kwargs.setdefault("control", controls.production_item())
-        super().__init__("", **kwargs)
+        super().__init__(default, **kwargs)
 
     @overload
     def __get__(self, instance: None, owner: type | None = None) -> TargetSetting: ...
@@ -34,13 +34,16 @@ class TargetSetting(Setting):
         return super().__get__(instance, owner)
 
 
-def target(**kwargs: Any) -> TargetSetting:
+def target(default: Any = "", **kwargs: Any) -> TargetSetting:
     """Purpose:
         Declare a configurable outbound target setting on a component class.
 
     Use when:
         A service or process sends messages to another production component.
 
+        Pass a target item name as the first argument when the route should have
+        a default target even without an explicit Production.connect(...) call.
+
     Lifecycle:
         The descriptor becomes an IRIS production setting. Production.connect(...)
         binds it to a concrete target component.
@@ -59,11 +62,14 @@ def target(**kwargs: Any) -> TargetSetting:
 
         prod.connect(router.Output, operation)
 
+        class DefaultRouter(BusinessProcess):
+            Output = target("DefaultOperation")
+
     Related:
         docs/cookbooks/production-settings-and-targets.md,
         docs/production-graph.md
     """
-    return TargetSetting(**kwargs)
+    return TargetSetting(default, **kwargs)
 
 
 @dataclass

{iris_pex_embedded_python-4.0.1b4 → iris_pex_embedded_python-4.0.1b6/src/iris_pex_embedded_python.egg-info}/PKG-INFO

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