[babeltrace.git] / src / bindings / python / bt2 / bt2 / trace_collection_message_iterator.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 utils
import bt2
import itertools
import bt2.message_iterator
import datetime
from collections import namedtuple
import numbers


# a pair of component and ComponentSpec
_ComponentAndSpec = namedtuple('_ComponentAndSpec', ['comp', 'spec'])


class ComponentSpec:
    def __init__(self, plugin_name, class_name, params=None,
                 logging_level=bt2.logging.LoggingLevel.NONE):
        utils._check_str(plugin_name)
        utils._check_str(class_name)
        utils._check_log_level(logging_level)
        self._plugin_name = plugin_name
        self._class_name = class_name
        self._logging_level = logging_level

        if type(params) is str:
            self._params = bt2.create_value({'paths': [params]})
        else:
            self._params = bt2.create_value(params)

    @property
    def plugin_name(self):
        return self._plugin_name

    @property
    def class_name(self):
        return self._class_name

    @property
    def logging_level(self):
        return self._logging_level

    @property
    def params(self):
        return self._params


# datetime.datetime or integral to nanoseconds
def _get_ns(obj):
    if obj is None:
        return

    if isinstance(obj, numbers.Real):
        # consider that it's already in seconds
        s = obj
    elif isinstance(obj, datetime.datetime):
        # s -> ns
        s = obj.timestamp()
    else:
        raise TypeError('"{}" is not an integral number or a datetime.datetime object'.format(obj))

    return int(s * 1e9)


class _CompClsType:
    SOURCE = 0
    FILTER = 1


class TraceCollectionMessageIterator(bt2.message_iterator._MessageIterator):
    def __init__(self, source_component_specs, filter_component_specs=None,
                 stream_intersection_mode=False, begin=None, end=None):
        utils._check_bool(stream_intersection_mode)
        self._stream_intersection_mode = stream_intersection_mode
        self._begin_ns = _get_ns(begin)
        self._end_ns = _get_ns(end)

        if type(source_component_specs) is ComponentSpec:
            source_component_specs = [source_component_specs]

        if type(filter_component_specs) is ComponentSpec:
            filter_component_specs = [filter_component_specs]
        elif filter_component_specs is None:
            filter_component_specs = []

        self._src_comp_specs = source_component_specs
        self._flt_comp_specs = filter_component_specs
        self._next_suffix = 1
        self._connect_ports = False

        # lists of _ComponentAndSpec
        self._src_comps_and_specs = []
        self._flt_comps_and_specs = []

        self._validate_component_specs(source_component_specs)
        self._validate_component_specs(filter_component_specs)
        self._build_graph()

    def _validate_component_specs(self, comp_specs):
        for comp_spec in comp_specs:
            if type(comp_spec) is not ComponentSpec:
                raise TypeError('"{}" object is not a ComponentSpec'.format(type(comp_spec)))

    def __next__(self):
        return next(self._msg_iter)

    def _create_stream_intersection_trimmer(self, component, port):
        # find the original parameters specified by the user to create
        # this port's component to get the `path` parameter
        for src_comp_and_spec in self._src_comps_and_specs:
            if component == src_comp_and_spec.comp:
                break

        try:
            paths = src_comp_and_spec.spec.params['paths']
        except Exception as e:
            raise bt2.Error('all source components must be created with a "paths" parameter in stream intersection mode') from e

        params = {'paths': paths}

        # query the port's component for the `trace-info` object which
        # contains the stream intersection range for each exposed
        # trace
        query_exec = bt2.QueryExecutor()
        trace_info_res = query_exec.query(src_comp_and_spec.comp.cls,
                                          'trace-info', params)
        begin = None
        end = None

        # find the trace info for this port's trace
        try:
            for trace_info in trace_info_res:
                for stream in trace_info['streams']:
                    if stream['port-name'] == port.name:
                        range_ns = trace_info['intersection-range-ns']
                        begin = range_ns['begin']
                        end = range_ns['end']
                        break
        except Exception:
            pass

        if begin is None or end is None:
            raise bt2.Error('cannot find stream intersection range for port "{}"'.format(port.name))

        name = 'trimmer-{}-{}'.format(src_comp_and_spec.comp.name, port.name)
        return self._create_trimmer(begin, end, name)

    def _create_muxer(self):
        plugin = bt2.find_plugin('utils')

        if plugin is None:
            raise bt2.Error('cannot find "utils" plugin (needed for the muxer)')

        if 'muxer' not in plugin.filter_component_classes:
            raise bt2.Error('cannot find "muxer" filter component class in "utils" plugin')

        comp_cls = plugin.filter_component_classes['muxer']
        return self._graph.add_component(comp_cls, 'muxer')

    def _create_trimmer(self, begin_ns, end_ns, name):
        plugin = bt2.find_plugin('utils')

        if plugin is None:
            raise bt2.Error('cannot find "utils" plugin (needed for the trimmer)')

        if 'trimmer' not in plugin.filter_component_classes:
            raise bt2.Error('cannot find "trimmer" filter component class in "utils" plugin')

        params = {}

        def ns_to_string(ns):
            s_part = ns // 1000000000
            ns_part = ns % 1000000000
            return '{}.{:09d}'.format(s_part, ns_part)

        if begin_ns is not None:
            params['begin'] = ns_to_string(begin_ns)

        if end_ns is not None:
            params['end'] = ns_to_string(end_ns)

        comp_cls = plugin.filter_component_classes['trimmer']
        return self._graph.add_component(comp_cls, name, params)

    def _get_unique_comp_name(self, comp_spec):
        name = '{}-{}'.format(comp_spec.plugin_name,
                              comp_spec.class_name)
        comps_and_specs = itertools.chain(self._src_comps_and_specs,
                                          self._flt_comps_and_specs)

        if name in [comp_and_spec.comp.name for comp_and_spec in comps_and_specs]:
            name += '-{}'.format(self._next_suffix)
            self._next_suffix += 1

        return name

    def _create_comp(self, comp_spec, comp_cls_type):
        plugin = bt2.find_plugin(comp_spec.plugin_name)

        if plugin is None:
            raise bt2.Error('no such plugin: {}'.format(comp_spec.plugin_name))

        if comp_cls_type == _CompClsType.SOURCE:
            comp_classes = plugin.source_component_classes
        else:
            comp_classes = plugin.filter_component_classes

        if comp_spec.class_name not in comp_classes:
            cc_type = 'source' if comp_cls_type == _CompClsType.SOURCE else 'filter'
            raise bt2.Error('no such {} component class in "{}" plugin: {}'.format(cc_type,
                                                                                   comp_spec.plugin_name,
                                                                                   comp_spec.class_name))

        comp_cls = comp_classes[comp_spec.class_name]
        name = self._get_unique_comp_name(comp_spec)
        comp = self._graph.add_component(comp_cls, name, comp_spec.params,
                                         comp_spec.logging_level)
        return comp

    def _get_free_muxer_input_port(self):
        for port in self._muxer_comp.input_ports.values():
            if not port.is_connected:
                return port

    def _connect_src_comp_port(self, component, port):
        # if this trace collection iterator is in stream intersection
        # mode, we need this connection:
        #
        #     port -> trimmer -> muxer
        #
        # otherwise, simply:
        #
        #     port -> muxer
        if self._stream_intersection_mode:
            trimmer_comp = self._create_stream_intersection_trimmer(component, port)
            self._graph.connect_ports(port, trimmer_comp.input_ports['in'])
            port_to_muxer = trimmer_comp.output_ports['out']
        else:
            port_to_muxer = port

        self._graph.connect_ports(port_to_muxer, self._get_free_muxer_input_port())

    def _graph_port_added(self, component, port):
        if not self._connect_ports:
            return

        if type(port) is bt2.port._InputPort:
            return

        if component not in [comp.comp for comp in self._src_comps_and_specs]:
            # do not care about non-source components (muxer, trimmer, etc.)
            return

        self._connect_src_comp_port(component, port)

    def _build_graph(self):
        self._graph = bt2.Graph()
        self._graph.add_port_added_listener(self._graph_port_added)
        self._muxer_comp = self._create_muxer()

        if self._begin_ns is not None or self._end_ns is not None:
            trimmer_comp = self._create_trimmer(self._begin_ns,
                                                self._end_ns, 'trimmer')
            self._graph.connect_ports(self._muxer_comp.output_ports['out'],
                                      trimmer_comp.input_ports['in'])
            msg_iter_port = trimmer_comp.output_ports['out']
        else:
            msg_iter_port = self._muxer_comp.output_ports['out']

        # create extra filter components (chained)
        for comp_spec in self._flt_comp_specs:
            comp = self._create_comp(comp_spec, _CompClsType.FILTER)
            self._flt_comps_and_specs.append(_ComponentAndSpec(comp, comp_spec))

        # connect the extra filter chain
        for comp_and_spec in self._flt_comps_and_specs:
            in_port = list(comp_and_spec.comp.input_ports.values())[0]
            out_port = list(comp_and_spec.comp.output_ports.values())[0]
            self._graph.connect_ports(msg_iter_port, in_port)
            msg_iter_port = out_port

        # Here we create the components, self._graph_port_added() is
        # called when they add ports, but the callback returns early
        # because self._connect_ports is False. This is because the
        # self._graph_port_added() could not find the associated source
        # component specification in self._src_comps_and_specs because
        # it does not exist yet (it needs the created component to
        # exist).
        for comp_spec in self._src_comp_specs:
            comp = self._create_comp(comp_spec, _CompClsType.SOURCE)
            self._src_comps_and_specs.append(_ComponentAndSpec(comp, comp_spec))

        # Now we connect the ports which exist at this point. We allow
        # self._graph_port_added() to automatically connect _new_ ports.
        self._connect_ports = True

        for comp_and_spec in self._src_comps_and_specs:
            # Keep a separate list because comp_and_spec.output_ports
            # could change during the connection of one of its ports.
            # Any new port is handled by self._graph_port_added().
            out_ports = [port for port in comp_and_spec.comp.output_ports.values()]

            for out_port in out_ports:
                if out_port.is_connected:
                    continue

                self._connect_src_comp_port(comp_and_spec.comp, out_port)

        # create this trace collection iterator's message iterator
        self._msg_iter = self._graph.create_output_port_message_iterator(msg_iter_port)
Commit	Line	Data
85dcce24 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 utils
	24	import bt2
3d60267b	25	import itertools
5602ef81	26	import bt2.message_iterator
85dcce24	27	import datetime
85dcce24 PP	28	from collections import namedtuple
	29	import numbers
	30
	31
3d60267b PP	32	# a pair of component and ComponentSpec
3d60267b PP	33	_ComponentAndSpec = namedtuple('_ComponentAndSpec', ['comp', 'spec'])
85dcce24 PP	34
85dcce24 PP	35
3d60267b	36	class ComponentSpec:
e874da19 PP	37	def __init__(self, plugin_name, class_name, params=None,
e874da19 PP	38	logging_level=bt2.logging.LoggingLevel.NONE):
85dcce24	39	utils._check_str(plugin_name)
e8ac1aae	40	utils._check_str(class_name)
e874da19	41	utils._check_log_level(logging_level)
85dcce24	42	self._plugin_name = plugin_name
e8ac1aae	43	self._class_name = class_name
e874da19	44	self._logging_level = logging_level
85dcce24 PP	45
85dcce24 PP	46	if type(params) is str:
907f2b70	47	self._params = bt2.create_value({'paths': [params]})
85dcce24 PP	48	else:
	49	self._params = bt2.create_value(params)
	50
	51	@property
	52	def plugin_name(self):
	53	return self._plugin_name
	54
	55	@property
e8ac1aae PP	56	def class_name(self):
e8ac1aae PP	57	return self._class_name
85dcce24	58
e874da19 PP	59	@property
	60	def logging_level(self):
	61	return self._logging_level
	62
85dcce24 PP	63	@property
	64	def params(self):
	65	return self._params
	66
	67
	68	# datetime.datetime or integral to nanoseconds
	69	def _get_ns(obj):
	70	if obj is None:
	71	return
	72
	73	if isinstance(obj, numbers.Real):
	74	# consider that it's already in seconds
	75	s = obj
	76	elif isinstance(obj, datetime.datetime):
	77	# s -> ns
	78	s = obj.timestamp()
	79	else:
	80	raise TypeError('"{}" is not an integral number or a datetime.datetime object'.format(obj))
	81
	82	return int(s * 1e9)
	83
	84
3d60267b PP	85	class _CompClsType:
	86	SOURCE = 0
	87	FILTER = 1
	88
	89
5602ef81	90	class TraceCollectionMessageIterator(bt2.message_iterator._MessageIterator):
3d60267b	91	def __init__(self, source_component_specs, filter_component_specs=None,
907f2b70	92	stream_intersection_mode=False, begin=None, end=None):
85dcce24 PP	93	utils._check_bool(stream_intersection_mode)
	94	self._stream_intersection_mode = stream_intersection_mode
	95	self._begin_ns = _get_ns(begin)
	96	self._end_ns = _get_ns(end)
3d60267b PP	97
	98	if type(source_component_specs) is ComponentSpec:
	99	source_component_specs = [source_component_specs]
	100
	101	if type(filter_component_specs) is ComponentSpec:
	102	filter_component_specs = [filter_component_specs]
	103	elif filter_component_specs is None:
	104	filter_component_specs = []
	105
85dcce24	106	self._src_comp_specs = source_component_specs
3d60267b	107	self._flt_comp_specs = filter_component_specs
85dcce24 PP	108	self._next_suffix = 1
	109	self._connect_ports = False
	110
3d60267b	111	# lists of _ComponentAndSpec
85dcce24	112	self._src_comps_and_specs = []
3d60267b	113	self._flt_comps_and_specs = []
85dcce24	114
3d60267b PP	115	self._validate_component_specs(source_component_specs)
3d60267b PP	116	self._validate_component_specs(filter_component_specs)
85dcce24 PP	117	self._build_graph()
85dcce24 PP	118
3d60267b PP	119	def _validate_component_specs(self, comp_specs):
	120	for comp_spec in comp_specs:
	121	if type(comp_spec) is not ComponentSpec:
	122	raise TypeError('"{}" object is not a ComponentSpec'.format(type(comp_spec)))
85dcce24 PP	123
85dcce24 PP	124	def __next__(self):
5602ef81	125	return next(self._msg_iter)
85dcce24	126
907f2b70	127	def _create_stream_intersection_trimmer(self, component, port):
85dcce24 PP	128	# find the original parameters specified by the user to create
	129	# this port's component to get the `path` parameter
	130	for src_comp_and_spec in self._src_comps_and_specs:
907f2b70	131	if component == src_comp_and_spec.comp:
85dcce24 PP	132	break
	133
	134	try:
907f2b70 SM	135	paths = src_comp_and_spec.spec.params['paths']
	136	except Exception as e:
	137	raise bt2.Error('all source components must be created with a "paths" parameter in stream intersection mode') from e
85dcce24	138
907f2b70	139	params = {'paths': paths}
85dcce24 PP	140
	141	# query the port's component for the `trace-info` object which
	142	# contains the stream intersection range for each exposed
	143	# trace
	144	query_exec = bt2.QueryExecutor()
e8ac1aae	145	trace_info_res = query_exec.query(src_comp_and_spec.comp.cls,
85dcce24 PP	146	'trace-info', params)
	147	begin = None
	148	end = None
	149
a38d7650	150	# find the trace info for this port's trace
87b768aa PP	151	try:
87b768aa PP	152	for trace_info in trace_info_res:
a38d7650 SM	153	for stream in trace_info['streams']:
	154	if stream['port-name'] == port.name:
	155	range_ns = trace_info['intersection-range-ns']
	156	begin = range_ns['begin']
	157	end = range_ns['end']
	158	break
907f2b70	159	except Exception:
87b768aa	160	pass
85dcce24 PP	161
	162	if begin is None or end is None:
	163	raise bt2.Error('cannot find stream intersection range for port "{}"'.format(port.name))
	164
907f2b70	165	name = 'trimmer-{}-{}'.format(src_comp_and_spec.comp.name, port.name)
85dcce24 PP	166	return self._create_trimmer(begin, end, name)
	167
	168	def _create_muxer(self):
	169	plugin = bt2.find_plugin('utils')
	170
	171	if plugin is None:
	172	raise bt2.Error('cannot find "utils" plugin (needed for the muxer)')
	173
	174	if 'muxer' not in plugin.filter_component_classes:
	175	raise bt2.Error('cannot find "muxer" filter component class in "utils" plugin')
	176
	177	comp_cls = plugin.filter_component_classes['muxer']
	178	return self._graph.add_component(comp_cls, 'muxer')
	179
907f2b70	180	def _create_trimmer(self, begin_ns, end_ns, name):
85dcce24 PP	181	plugin = bt2.find_plugin('utils')
	182
	183	if plugin is None:
	184	raise bt2.Error('cannot find "utils" plugin (needed for the trimmer)')
	185
	186	if 'trimmer' not in plugin.filter_component_classes:
	187	raise bt2.Error('cannot find "trimmer" filter component class in "utils" plugin')
	188
	189	params = {}
	190
907f2b70 SM	191	def ns_to_string(ns):
	192	s_part = ns // 1000000000
	193	ns_part = ns % 1000000000
	194	return '{}.{:09d}'.format(s_part, ns_part)
85dcce24	195
907f2b70 SM	196	if begin_ns is not None:
	197	params['begin'] = ns_to_string(begin_ns)
	198
	199	if end_ns is not None:
	200	params['end'] = ns_to_string(end_ns)
85dcce24 PP	201
	202	comp_cls = plugin.filter_component_classes['trimmer']
	203	return self._graph.add_component(comp_cls, name, params)
	204
3d60267b	205	def _get_unique_comp_name(self, comp_spec):
85dcce24	206	name = '{}-{}'.format(comp_spec.plugin_name,
e8ac1aae	207	comp_spec.class_name)
3d60267b PP	208	comps_and_specs = itertools.chain(self._src_comps_and_specs,
3d60267b PP	209	self._flt_comps_and_specs)
85dcce24	210
3d60267b	211	if name in [comp_and_spec.comp.name for comp_and_spec in comps_and_specs]:
85dcce24 PP	212	name += '-{}'.format(self._next_suffix)
	213	self._next_suffix += 1
	214
	215	return name
	216
3d60267b	217	def _create_comp(self, comp_spec, comp_cls_type):
85dcce24 PP	218	plugin = bt2.find_plugin(comp_spec.plugin_name)
	219
	220	if plugin is None:
	221	raise bt2.Error('no such plugin: {}'.format(comp_spec.plugin_name))
	222
3d60267b PP	223	if comp_cls_type == _CompClsType.SOURCE:
	224	comp_classes = plugin.source_component_classes
	225	else:
	226	comp_classes = plugin.filter_component_classes
	227
e8ac1aae	228	if comp_spec.class_name not in comp_classes:
3d60267b PP	229	cc_type = 'source' if comp_cls_type == _CompClsType.SOURCE else 'filter'
	230	raise bt2.Error('no such {} component class in "{}" plugin: {}'.format(cc_type,
	231	comp_spec.plugin_name,
e8ac1aae	232	comp_spec.class_name))
85dcce24	233
e8ac1aae	234	comp_cls = comp_classes[comp_spec.class_name]
3d60267b	235	name = self._get_unique_comp_name(comp_spec)
e874da19 PP	236	comp = self._graph.add_component(comp_cls, name, comp_spec.params,
e874da19 PP	237	comp_spec.logging_level)
85dcce24 PP	238	return comp
	239
	240	def _get_free_muxer_input_port(self):
	241	for port in self._muxer_comp.input_ports.values():
	242	if not port.is_connected:
	243	return port
	244
907f2b70	245	def _connect_src_comp_port(self, component, port):
85dcce24 PP	246	# if this trace collection iterator is in stream intersection
	247	# mode, we need this connection:
	248	#
	249	# port -> trimmer -> muxer
	250	#
	251	# otherwise, simply:
	252	#
	253	# port -> muxer
	254	if self._stream_intersection_mode:
907f2b70	255	trimmer_comp = self._create_stream_intersection_trimmer(component, port)
85dcce24 PP	256	self._graph.connect_ports(port, trimmer_comp.input_ports['in'])
	257	port_to_muxer = trimmer_comp.output_ports['out']
	258	else:
	259	port_to_muxer = port
	260
	261	self._graph.connect_ports(port_to_muxer, self._get_free_muxer_input_port())
	262
907f2b70	263	def _graph_port_added(self, component, port):
85dcce24 PP	264	if not self._connect_ports:
	265	return
	266
907f2b70	267	if type(port) is bt2.port._InputPort:
85dcce24 PP	268	return
85dcce24 PP	269
907f2b70	270	if component not in [comp.comp for comp in self._src_comps_and_specs]:
85dcce24 PP	271	# do not care about non-source components (muxer, trimmer, etc.)
	272	return
	273
907f2b70	274	self._connect_src_comp_port(component, port)
85dcce24 PP	275
	276	def _build_graph(self):
	277	self._graph = bt2.Graph()
907f2b70	278	self._graph.add_port_added_listener(self._graph_port_added)
85dcce24 PP	279	self._muxer_comp = self._create_muxer()
	280
	281	if self._begin_ns is not None or self._end_ns is not None:
	282	trimmer_comp = self._create_trimmer(self._begin_ns,
	283	self._end_ns, 'trimmer')
	284	self._graph.connect_ports(self._muxer_comp.output_ports['out'],
	285	trimmer_comp.input_ports['in'])
5602ef81	286	msg_iter_port = trimmer_comp.output_ports['out']
85dcce24	287	else:
5602ef81	288	msg_iter_port = self._muxer_comp.output_ports['out']
85dcce24	289
3d60267b PP	290	# create extra filter components (chained)
	291	for comp_spec in self._flt_comp_specs:
	292	comp = self._create_comp(comp_spec, _CompClsType.FILTER)
	293	self._flt_comps_and_specs.append(_ComponentAndSpec(comp, comp_spec))
	294
	295	# connect the extra filter chain
	296	for comp_and_spec in self._flt_comps_and_specs:
	297	in_port = list(comp_and_spec.comp.input_ports.values())[0]
	298	out_port = list(comp_and_spec.comp.output_ports.values())[0]
5602ef81 SM	299	self._graph.connect_ports(msg_iter_port, in_port)
5602ef81 SM	300	msg_iter_port = out_port
3d60267b	301
85dcce24 PP	302	# Here we create the components, self._graph_port_added() is
	303	# called when they add ports, but the callback returns early
	304	# because self._connect_ports is False. This is because the
	305	# self._graph_port_added() could not find the associated source
	306	# component specification in self._src_comps_and_specs because
	307	# it does not exist yet (it needs the created component to
	308	# exist).
	309	for comp_spec in self._src_comp_specs:
3d60267b PP	310	comp = self._create_comp(comp_spec, _CompClsType.SOURCE)
3d60267b PP	311	self._src_comps_and_specs.append(_ComponentAndSpec(comp, comp_spec))
85dcce24 PP	312
	313	# Now we connect the ports which exist at this point. We allow
	314	# self._graph_port_added() to automatically connect _new_ ports.
	315	self._connect_ports = True
	316
	317	for comp_and_spec in self._src_comps_and_specs:
	318	# Keep a separate list because comp_and_spec.output_ports
	319	# could change during the connection of one of its ports.
	320	# Any new port is handled by self._graph_port_added().
	321	out_ports = [port for port in comp_and_spec.comp.output_ports.values()]
	322
	323	for out_port in out_ports:
907f2b70	324	if out_port.is_connected:
85dcce24 PP	325	continue
85dcce24 PP	326
907f2b70	327	self._connect_src_comp_port(comp_and_spec.comp, out_port)
85dcce24	328
5602ef81	329	# create this trace collection iterator's message iterator
907f2b70	330	self._msg_iter = self._graph.create_output_port_message_iterator(msg_iter_port)