[babeltrace.git] / bindings / python / bt2 / bt2 / graph.py

# The MIT License (MIT)
#
# Copyright (c) 2017 Philippe Proulx <pproulx@efficios.com>
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.

from bt2 import native_bt, object, utils
import bt2.connection
import bt2.component
import functools
import bt2.port
import bt2


class GraphListenerType:
    PORT_ADDED = 0
    PORT_REMOVED = 1
    PORTS_CONNECTED = 2
    PORTS_DISCONNECTED = 3


def _graph_port_added_listener_from_native(user_listener, port_ptr):
    try:
        port = bt2.port._create_from_ptr(port_ptr)
        port._get()
        user_listener(port)
    except:
        pass


def _graph_port_removed_listener_from_native(user_listener, port_ptr):
    try:
        port = bt2.port._create_from_ptr(port_ptr)
        port._get()
        user_listener(port)
    except:
        pass


def _graph_ports_connected_listener_from_native(user_listener,
                                                upstream_port_ptr,
                                                downstream_port_ptr):
    try:
        upstream_port = bt2.port._create_from_ptr(upstream_port_ptr)
        upstream_port._get()
        downstream_port = bt2.port._create_from_ptr(downstream_port_ptr)
        downstream_port._get()
        user_listener(upstream_port, downstream_port)
    except:
        pass


def _graph_ports_disconnected_listener_from_native(user_listener,
                                                   upstream_comp_ptr,
                                                   downstream_comp_ptr,
                                                   upstream_port_ptr,
                                                   downstream_port_ptr):
    try:
        upstream_comp = bt2.component._create_generic_component_from_ptr(upstream_comp_ptr)
        upstream_comp._get()
        downstream_comp = bt2.component._create_generic_component_from_ptr(downstream_comp_ptr)
        downstream_comp._get()
        upstream_port = bt2.port._create_from_ptr(upstream_port_ptr)
        upstream_port._get()
        downstream_port = bt2.port._create_from_ptr(downstream_port_ptr)
        downstream_port._get()
        user_listener(upstream_comp, downstream_comp, upstream_port,
                      downstream_port)
    except:
        pass


class Graph(object._SharedObject):
    def __init__(self):
        ptr = native_bt.graph_create()

        if ptr is None:
            raise bt2.CreationError('cannot create graph object')

        super().__init__(ptr)

    def _handle_status(self, status, gen_error_msg):
        if status == native_bt.GRAPH_STATUS_COMPONENT_REFUSES_PORT_CONNECTION:
            raise bt2.PortConnectionRefused
        elif status == native_bt.GRAPH_STATUS_CANCELED:
            raise bt2.GraphCanceled
        elif status == native_bt.GRAPH_STATUS_END:
            raise bt2.Stop
        elif status == native_bt.GRAPH_STATUS_AGAIN:
            raise bt2.TryAgain
        elif status == native_bt.GRAPH_STATUS_NO_SINK:
            raise bt2.NoSinkComponent
        elif status == native_bt.GRAPH_STATUS_CANNOT_CONSUME:
            raise bt2.CannotConsumeGraph
        elif status < 0:
            raise bt2.Error(gen_error_msg)

    def add_component(self, component_class, name, params=None):
        if isinstance(component_class, bt2.component._GenericComponentClass):
            cc_ptr = component_class._ptr
        elif issubclass(component_class, bt2.component._UserComponent):
            cc_ptr = component_class._cc_ptr
        else:
            raise TypeError("'{}' is not a component class".format(component_class.__class__.__name__))

        utils._check_str(name)
        params = bt2.create_value(params)

        if params is None:
            params_ptr = None
        else:
            params_ptr = params._ptr

        status, comp_ptr = native_bt.graph_add_component(self._ptr, cc_ptr,
                                                         name, params_ptr)
        self._handle_status(status, 'cannot add component to graph')
        assert(comp_ptr)
        return bt2.component._create_generic_component_from_ptr(comp_ptr)

    def connect_ports(self, upstream_port, downstream_port):
        utils._check_type(upstream_port, bt2.port._OutputPort)
        utils._check_type(downstream_port, bt2.port._InputPort)
        status, conn_ptr = native_bt.graph_connect_ports(self._ptr,
                                                         upstream_port._ptr,
                                                         downstream_port._ptr)
        self._handle_status(status, 'cannot connect component ports within graph')
        assert(conn_ptr)
        return bt2.connection._Connection._create_from_ptr(conn_ptr)

    def add_listener(self, listener_type, listener):
        if not hasattr(listener, '__call__'):
            raise TypeError("'listener' parameter is not callable")

        if listener_type == GraphListenerType.PORT_ADDED:
            fn = native_bt.py3_graph_add_port_added_listener
            listener_from_native = functools.partial(_graph_port_added_listener_from_native,
                                                     listener)
        elif listener_type == GraphListenerType.PORT_REMOVED:
            fn = native_bt.py3_graph_add_port_removed_listener
            listener_from_native = functools.partial(_graph_port_removed_listener_from_native,
                                                     listener)
        elif listener_type == GraphListenerType.PORTS_CONNECTED:
            fn = native_bt.py3_graph_add_ports_connected_listener
            listener_from_native = functools.partial(_graph_ports_connected_listener_from_native,
                                                     listener)
        elif listener_type == GraphListenerType.PORTS_DISCONNECTED:
            fn = native_bt.py3_graph_add_ports_disconnected_listener
            listener_from_native = functools.partial(_graph_ports_disconnected_listener_from_native,
                                                     listener)
        else:
            raise TypeError

        listener_id = fn(self._ptr, listener_from_native)
        utils._handle_ret(listener_id, 'cannot add listener to graph object')
        return bt2._ListenerHandle(listener_id, self)

    def run(self):
        status = native_bt.graph_run(self._ptr)

        if status == native_bt.GRAPH_STATUS_END:
            return

        self._handle_status(status, 'graph object stopped running because of an unexpected error')

    def cancel(self):
        status = native_bt.graph_cancel(self._ptr)
        self._handle_status(status, 'cannot cancel graph object')

    @property
    def is_canceled(self):
        is_canceled = native_bt.graph_is_canceled(self._ptr)
        assert(is_canceled >= 0)
        return is_canceled > 0

    def __eq__(self, other):
        if type(other) is not type(self):
            return False

        return self.addr == other.addr
Commit	Line	Data
811644b8 PP	1	# The MIT License (MIT)
	2	#
	3	# Copyright (c) 2017 Philippe Proulx <pproulx@efficios.com>
	4	#
	5	# Permission is hereby granted, free of charge, to any person obtaining a copy
	6	# of this software and associated documentation files (the "Software"), to deal
	7	# in the Software without restriction, including without limitation the rights
	8	# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
	9	# copies of the Software, and to permit persons to whom the Software is
	10	# furnished to do so, subject to the following conditions:
	11	#
	12	# The above copyright notice and this permission notice shall be included in
	13	# all copies or substantial portions of the Software.
	14	#
	15	# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
	16	# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
	17	# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
	18	# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
	19	# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
	20	# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
	21	# THE SOFTWARE.
	22
	23	from bt2 import native_bt, object, utils
	24	import bt2.connection
	25	import bt2.component
	26	import functools
	27	import bt2.port
	28	import bt2
	29
	30
	31	class GraphListenerType:
	32	PORT_ADDED = 0
	33	PORT_REMOVED = 1
	34	PORTS_CONNECTED = 2
	35	PORTS_DISCONNECTED = 3
	36
	37
	38	def _graph_port_added_listener_from_native(user_listener, port_ptr):
	39	try:
	40	port = bt2.port._create_from_ptr(port_ptr)
	41	port._get()
	42	user_listener(port)
	43	except:
	44	pass
	45
	46
	47	def _graph_port_removed_listener_from_native(user_listener, port_ptr):
	48	try:
	49	port = bt2.port._create_from_ptr(port_ptr)
	50	port._get()
	51	user_listener(port)
	52	except:
	53	pass
	54
	55
	56	def _graph_ports_connected_listener_from_native(user_listener,
	57	upstream_port_ptr,
	58	downstream_port_ptr):
	59	try:
	60	upstream_port = bt2.port._create_from_ptr(upstream_port_ptr)
	61	upstream_port._get()
	62	downstream_port = bt2.port._create_from_ptr(downstream_port_ptr)
	63	downstream_port._get()
	64	user_listener(upstream_port, downstream_port)
65	except:
66	pass
67
68
69	def _graph_ports_disconnected_listener_from_native(user_listener,
70	upstream_comp_ptr,
71	downstream_comp_ptr,
72	upstream_port_ptr,
73	downstream_port_ptr):
74	try:
75	upstream_comp = bt2.component._create_generic_component_from_ptr(upstream_comp_ptr)
76	upstream_comp._get()
77	downstream_comp = bt2.component._create_generic_component_from_ptr(downstream_comp_ptr)
78	downstream_comp._get()
79	upstream_port = bt2.port._create_from_ptr(upstream_port_ptr)
80	upstream_port._get()
81	downstream_port = bt2.port._create_from_ptr(downstream_port_ptr)
82	downstream_port._get()
83	user_listener(upstream_comp, downstream_comp, upstream_port,
84	downstream_port)
85	except:
86	pass
87
88
78288f58	89	class Graph(object._SharedObject):
811644b8 PP	90	def __init__(self):
	91	ptr = native_bt.graph_create()
	92
	93	if ptr is None:
	94	raise bt2.CreationError('cannot create graph object')
	95
	96	super().__init__(ptr)
	97
	98	def _handle_status(self, status, gen_error_msg):
	99	if status == native_bt.GRAPH_STATUS_COMPONENT_REFUSES_PORT_CONNECTION:
	100	raise bt2.PortConnectionRefused
	101	elif status == native_bt.GRAPH_STATUS_CANCELED:
	102	raise bt2.GraphCanceled
	103	elif status == native_bt.GRAPH_STATUS_END:
	104	raise bt2.Stop
	105	elif status == native_bt.GRAPH_STATUS_AGAIN:
	106	raise bt2.TryAgain
	107	elif status == native_bt.GRAPH_STATUS_NO_SINK:
	108	raise bt2.NoSinkComponent
1d915789 PP	109	elif status == native_bt.GRAPH_STATUS_CANNOT_CONSUME:
1d915789 PP	110	raise bt2.CannotConsumeGraph
811644b8 PP	111	elif status < 0:
	112	raise bt2.Error(gen_error_msg)
	113
	114	def add_component(self, component_class, name, params=None):
	115	if isinstance(component_class, bt2.component._GenericComponentClass):
	116	cc_ptr = component_class._ptr
	117	elif issubclass(component_class, bt2.component._UserComponent):
	118	cc_ptr = component_class._cc_ptr
	119	else:
	120	raise TypeError("'{}' is not a component class".format(component_class.__class__.__name__))
	121
	122	utils._check_str(name)
	123	params = bt2.create_value(params)
	124
	125	if params is None:
	126	params_ptr = None
	127	else:
	128	params_ptr = params._ptr
	129
	130	status, comp_ptr = native_bt.graph_add_component(self._ptr, cc_ptr,
	131	name, params_ptr)
	132	self._handle_status(status, 'cannot add component to graph')
	133	assert(comp_ptr)
	134	return bt2.component._create_generic_component_from_ptr(comp_ptr)
	135
	136	def connect_ports(self, upstream_port, downstream_port):
	137	utils._check_type(upstream_port, bt2.port._OutputPort)
	138	utils._check_type(downstream_port, bt2.port._InputPort)
	139	status, conn_ptr = native_bt.graph_connect_ports(self._ptr,
	140	upstream_port._ptr,
	141	downstream_port._ptr)
	142	self._handle_status(status, 'cannot connect component ports within graph')
	143	assert(conn_ptr)
	144	return bt2.connection._Connection._create_from_ptr(conn_ptr)
	145
	146	def add_listener(self, listener_type, listener):
	147	if not hasattr(listener, '__call__'):
	148	raise TypeError("'listener' parameter is not callable")
	149
	150	if listener_type == GraphListenerType.PORT_ADDED:
	151	fn = native_bt.py3_graph_add_port_added_listener
	152	listener_from_native = functools.partial(_graph_port_added_listener_from_native,
	153	listener)
	154	elif listener_type == GraphListenerType.PORT_REMOVED:
	155	fn = native_bt.py3_graph_add_port_removed_listener
	156	listener_from_native = functools.partial(_graph_port_removed_listener_from_native,
	157	listener)
	158	elif listener_type == GraphListenerType.PORTS_CONNECTED:
	159	fn = native_bt.py3_graph_add_ports_connected_listener
	160	listener_from_native = functools.partial(_graph_ports_connected_listener_from_native,
	161	listener)
	162	elif listener_type == GraphListenerType.PORTS_DISCONNECTED:
	163	fn = native_bt.py3_graph_add_ports_disconnected_listener
	164	listener_from_native = functools.partial(_graph_ports_disconnected_listener_from_native,
	165	listener)
	166	else:
	167	raise TypeError
	168
	169	listener_id = fn(self._ptr, listener_from_native)
	170	utils._handle_ret(listener_id, 'cannot add listener to graph object')
	171	return bt2._ListenerHandle(listener_id, self)
	172
	173	def run(self):
	174	status = native_bt.graph_run(self._ptr)
175
176	if status == native_bt.GRAPH_STATUS_END:
177	return
178
179	self._handle_status(status, 'graph object stopped running because of an unexpected error')
180
181	def cancel(self):
182	status = native_bt.graph_cancel(self._ptr)
183	self._handle_status(status, 'cannot cancel graph object')
184
185	@property
186	def is_canceled(self):
187	is_canceled = native_bt.graph_is_canceled(self._ptr)
188	assert(is_canceled >= 0)
189	return is_canceled > 0
190
191	def __eq__(self, other):
192	if type(other) is not type(self):
193	return False
194
195	return self.addr == other.addr