iris-pex-embedded-python 2.3.27b2__py3-none-any.whl → 3.2.1b2__py3-none-any.whl

iop/_business_operation.py

@@ -0,0 +1,71 @@
+import importlib
+from typing import Any, List, Optional, Union, Tuple
+from iop._business_host import _BusinessHost
+
+class _BusinessOperation(_BusinessHost):
+    """Business operation component that handles outbound communication.
+    
+    Responsible for sending messages to external systems. Can optionally use an 
+    adapter to handle the outbound messaging protocol.
+    """
+
+    DISPATCH: List[Tuple[str, str]] = []
+    Adapter: Any = None
+    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
+        """
+        return self.OnMessage(request)
+
+    def on_keepalive(self) -> None:
+        """
+        Called when the server sends a keepalive message.
+        """
+        return
+
+    def _set_iris_handles(self, handle_current: Any, handle_partner: Any) -> None:
+        """For internal use only."""
+        self.iris_handle = handle_current
+        if type(handle_partner).__module__.find('iris') == 0:
+            if handle_partner._IsA("Grongier.PEX.OutboundAdapter") or handle_partner._IsA("IOP.OutboundAdapter"):
+                module = importlib.import_module(handle_partner.GetModule())
+                handle_partner = getattr(module, handle_partner.GetClassname())()
+            self.Adapter = self.adapter = handle_partner
+        return
+
+    def _dispatch_on_init(self, host_object: Any) -> None:
+        """For internal use only."""
+        self._create_dispatch()
+        self.on_init()
+        return
+
+    @_BusinessHost.input_deserialzer
+    @_BusinessHost.output_serialzer
+    def _dispatch_on_message(self, request: Any) -> Any:
+        """For internal use only."""
+        return self._dispach_message(request)
+
+    def OnMessage(self, request: Any) -> Any:
+        """DEPRECATED : use on_message
+        Called when the business operation receives a message from another production component.
+        Typically, the operation will either send the message to the external system or forward it to a business process or another business operation.
+        If the operation has an adapter, it uses the Adapter.invoke() method to call the method on the adapter that sends the message to the external system.
+        If the operation is forwarding the message to another production component, it uses the SendRequestAsync() or the SendRequestSync() method
+
+        Parameters:
+        request: An instance of either a subclass of Message or of IRISObject containing the incoming message for the business operation.
+
+        Returns:
+        The response object
+        """
+        return

iop/_business_process.py

@@ -0,0 +1,220 @@
+from typing import Any, List, Optional, Union
+from iop._business_host import _BusinessHost
+
+class _BusinessProcess(_BusinessHost):
+    """Business process component that contains routing and transformation logic.
+    
+    A business process can receive messages from services, other processes, or operations.
+    It can modify messages, transform formats, and route based on content.
+    """
+
+    DISPATCH: List[tuple] = []
+    PERSISTENT_PROPERTY_LIST: Optional[List[str]] = 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_request(self, request: Any) -> Any:
+        """Process initial requests sent to this component.
+        
+        Args:
+            request: The incoming request message
+            
+        Returns:
+            Response message
+        """
+        return self.OnRequest(request)
+
+    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
+        """
+        return self.OnResponse(request, response, call_request, call_response, completion_key)
+
+    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
+        """
+        return self.OnComplete(request, response)
+
+    @_BusinessHost.input_serialzer_param(0,'response')
+    def reply(self, response: Any) -> None:
+        """Send the specified response to the production component that sent the initial request.
+
+        Args:
+            response: The response message
+        """
+        return self.iris_handle.dispatchReply(response)
+    
+    @_BusinessHost.input_serialzer_param(1,'request')
+    def send_request_async(self, target: str, request: Any, response_required: bool=True, completion_key: Optional[str]=None, description: Optional[str]=None) -> 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
+            response_required: Whether a response is required
+            completion_key: A string that will be returned with the response if the maximum time is exceeded
+            description: An optional description property in the message header
+            
+        Raises:
+            TypeError: If request is not of type Message or IRISObject
+        """
+        if response_required:
+            response_required = 1
+        else:
+            response_required = 0
+        return self.iris_handle.dispatchSendRequestAsync(target, request, response_required, completion_key, description)
+
+    def set_timer(self, timeout: Union[int, str], completion_key: Optional[str]=None) -> None:
+        """Specify the maximum time the business process will wait for responses.
+
+        Args:
+            timeout: The maximum time to wait for responses
+            completion_key: A string that will be returned with the response if the maximum time is exceeded
+        """
+        self.iris_handle.dispatchSetTimer(timeout, completion_key)
+        return
+
+    def _set_iris_handles(self, handle_current: Any, handle_partner: Any) -> None:
+        """For internal use only."""
+        self.iris_handle = handle_current
+        return
+
+    def _save_persistent_properties(self, host_object: Any) -> None:
+        """For internal use only."""
+        if self.PERSISTENT_PROPERTY_LIST is None:
+            return
+        for prop in self.PERSISTENT_PROPERTY_LIST:
+            val = getattr(self, prop, None)
+            typ = val.__class__.__name__
+            if typ in ["str", "int", "float", "bool", "bytes"]:
+                try:
+                    host_object.setPersistentProperty(prop, val)
+                except:
+                    pass
+        return
+
+    def _restore_persistent_properties(self, host_object: Any) -> None:
+        """For internal use only."""
+        if self.PERSISTENT_PROPERTY_LIST is None:
+            return
+        for prop in self.PERSISTENT_PROPERTY_LIST:
+            try:
+                val = host_object.getPersistentProperty(prop)
+                setattr(self, prop, val)
+            except:
+                pass
+        return
+
+    def _dispatch_on_connected(self, host_object: Any) -> None:
+        """For internal use only."""
+        self.on_connected()
+        self._save_persistent_properties(host_object)
+        return
+
+    def _dispatch_on_init(self, host_object: Any) -> None:
+        """For internal use only."""
+        self._restore_persistent_properties(host_object)
+        self._create_dispatch()
+        self.on_init()
+        self._save_persistent_properties(host_object)
+        return
+
+    def _dispatch_on_tear_down(self, host_object: Any) -> None:
+        """For internal use only."""
+        self._restore_persistent_properties(host_object)
+        self.on_tear_down()
+        self._save_persistent_properties(host_object)
+        return
+
+    @_BusinessHost.input_deserialzer
+    @_BusinessHost.output_serialzer
+    def _dispatch_on_request(self, host_object: Any, request: Any) -> Any:
+        """For internal use only."""
+        self._restore_persistent_properties(host_object)
+        return_object = self._dispach_message(request)
+        self._save_persistent_properties(host_object)
+        return return_object
+    
+    @_BusinessHost.input_deserialzer
+    @_BusinessHost.output_serialzer
+    def _dispatch_on_response(self, host_object: Any, request: Any, response: Any, call_request: Any, call_response: Any, completion_key: str) -> Any:
+        """For internal use only."""
+        self._restore_persistent_properties(host_object)
+        return_object = self.on_response(request, response, call_request, call_response, completion_key)
+        self._save_persistent_properties(host_object)
+        return return_object
+
+    @_BusinessHost.input_deserialzer
+    @_BusinessHost.output_serialzer
+    def _dispatch_on_complete(self, host_object: Any, request: Any, response: Any) -> Any:
+        """For internal use only."""
+        self._restore_persistent_properties(host_object)
+        return_object = self.on_complete(request, response)
+        self._save_persistent_properties(host_object)
+        return return_object
+
+    def OnRequest(self, request: Any) -> Any:
+        """ 
+        DEPRECATED: Use on_request.
+        
+        Args:
+            request: The incoming request message
+            
+        Returns:
+            Response message
+        """
+        return 
+
+    def OnResponse(self, request: Any, response: Any, call_request: Any, call_response: Any, completion_key: str) -> Any:
+        """ 
+        DEPRECATED: Use on_response.
+        
+        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
+        """
+        return response
+
+    def OnComplete(self, request: Any, response: Any) -> Any:
+        """ 
+        DEPRECATED: Use on_complete.
+        
+        Args:
+            request: The initial request message
+            response: The response message
+            
+        Returns:
+            Response message
+        """
+        return response

{grongier/pex → iop}/_business_service.py

@@ -1,5 +1,5 @@
 import importlib
-from grongier.pex._business_host import _BusinessHost
+from iop._business_host import _BusinessHost
 
 class _BusinessService(_BusinessHost):
     """ This class is responsible for receiving the data from external system and sending it to business processes or business operations in the production.
@@ -30,7 +30,7 @@ class _BusinessService(_BusinessHost):
         """ For internal use only. """
         self.iris_handle = handle_current
         if type(handle_partner).__module__.find('iris') == 0:
-            if handle_partner._IsA("Grongier.PEX.InboundAdapter"):
+            if handle_partner._IsA("Grongier.PEX.InboundAdapter") or handle_partner._IsA("IOP.InboundAdapter"):
                 module = importlib.import_module(handle_partner.GetModule())
                 handle_partner = getattr(module, handle_partner.GetClassname())()
         self.Adapter = self.adapter = handle_partner

iop/_cli.py

@@ -0,0 +1,141 @@
+import argparse
+import json
+import os
+from importlib.metadata import version
+
+from iop._director import _Director
+from iop._utils import _Utils
+
+def parse_args():
+    # parse arguments
+    main_parser = argparse.ArgumentParser()
+    parser = main_parser.add_mutually_exclusive_group()
+    parser.add_argument('-d', '--default', help='set the default production', nargs='?', const='not_set')
+    parser.add_argument('-l', '--list', help='list productions', action='store_true')
+    parser.add_argument('-s', '--start', help='start a production', nargs='?', const='not_set')
+    start = main_parser.add_argument_group('start arguments')
+    start.add_argument('-D', '--detach', help='start a production in detach mode', action='store_true')
+    parser.add_argument('-S', '--stop', help='stop a production', action='store_true')
+    parser.add_argument('-k', '--kill', help='kill a production', action='store_true')
+    parser.add_argument('-r', '--restart', help='restart a production', action='store_true')
+    parser.add_argument('-x', '--status', help='status a production', action='store_true')
+    parser.add_argument('-m', '-M', '--migrate', help='migrate production and classes with settings file')
+    parser.add_argument('-e', '--export', help='export a production', nargs='?', const='not_set')
+    parser.add_argument('-v', '--version', help='display version', action='store_true')
+    parser.add_argument('-L', '--log', help='display log', nargs='?', const='not_set')
+    parser.add_argument('-i', '--init', help='init the pex module in iris', nargs='?', const='not_set')
+    parser.add_argument('-t', '--test', help='test the pex module in iris', nargs='?', const='not_set')
+    test = main_parser.add_argument_group('test arguments')
+    # add classname argument
+    test.add_argument('-C', '--classname', help='test classname', nargs='?', const='not_set')
+    # body argument
+    test.add_argument('-B', '--body', help='test body', nargs='?', const='not_set')
+    return main_parser
+
+def main(argv=None):
+    # build arguments
+    parser = parse_args()
+    args = parser.parse_args(argv)
+
+    if args.default:
+        # set default production
+        if args.default == 'not_set':
+            # display default production name
+            print(_Director.get_default_production())
+        else:
+            _Director.set_default_production(args.default)
+
+    elif args.list:
+        # display list of productions
+        dikt = _Director.list_productions()
+        print(json.dumps(dikt, indent=4))
+
+    elif args.start:
+        production_name = None
+        if args.start == 'not_set':
+            # start default production
+            production_name = _Director.get_default_production()
+        else:
+            # start production with name
+            production_name = args.start
+        if args.detach:
+            # start production in detach mode
+            _Director.start_production(production_name)
+            print(f"Production {production_name} started")
+        else:
+            _Director.start_production_with_log(production_name)
+
+    elif args.init:
+        if args.init == 'not_set':
+            # set arg to None
+            args.init = None
+        _Utils.setup(args.start)
+
+    elif args.kill:
+        # kill a production
+        _Director.shutdown_production()
+
+    elif args.restart:
+        # restart a production
+        _Director.restart_production()
+
+    elif args.migrate:
+        # check if migrate is absolute path
+        if os.path.isabs(args.migrate):
+            # migrate a production with absolute path
+            _Utils.migrate(args.migrate)
+        else:
+            # migrate a production with relative path
+            _Utils.migrate(os.path.join(os.getcwd(), args.migrate))
+
+    elif args.version:
+        # display version
+        print(version('iris-pex-embedded-python'))
+
+    elif args.log:
+        # display log
+        if args.log == 'not_set':
+            # display default production log
+            _Director.log_production()
+        else:
+            _Director.log_production_top(args.log)
+
+    elif args.stop:
+        # stop a production
+        _Director.stop_production()
+        print(f"Production {_Director.get_default_production()} stopped")
+
+    elif args.status:
+        dikt=_Director.status_production()
+        print(json.dumps(dikt, indent=4))
+
+    elif args.test:
+        classname = None
+        body = None
+        if args.test == 'not_set':
+            # set arg to None
+            args.test = None
+        if args.classname:
+            classname = args.classname
+        if args.body:
+            body = args.body
+        response = _Director.test_component(args.test, classname=classname, body=body)
+        print(response)
+
+    elif args.export:
+        if args.export == 'not_set':
+            # export default production
+            args.export=_Director.get_default_production()
+
+        dikt = _Utils.export_production(args.export)
+        print(json.dumps(dikt, indent=4))
+
+    else:
+        # display help
+        parser.print_help()
+        print()
+        print("Default production : " + _Director.get_default_production())
+
+
+if __name__ == '__main__':
+    main()