Commit | Line | Data |
---|---|---|
f6a5e476 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 | |
c946c9de PP |
24 | from bt2 import interrupter as bt2_interrupter |
25 | from bt2 import connection as bt2_connection | |
26 | from bt2 import component as bt2_component | |
f6a5e476 | 27 | import functools |
c946c9de PP |
28 | from bt2 import port as bt2_port |
29 | from bt2 import logging as bt2_logging | |
f6a5e476 PP |
30 | import bt2 |
31 | ||
32 | ||
61d96b89 FD |
33 | def _graph_port_added_listener_from_native( |
34 | user_listener, component_ptr, component_type, port_ptr, port_type | |
35 | ): | |
5265f5e3 | 36 | component = bt2_component._create_component_from_const_ptr_and_get_ref( |
61d96b89 FD |
37 | component_ptr, component_type |
38 | ) | |
49e6b55c | 39 | port = bt2_port._create_from_const_ptr_and_get_ref(port_ptr, port_type) |
871a292a | 40 | user_listener(component, port) |
f6a5e476 PP |
41 | |
42 | ||
c3044a97 | 43 | class Graph(object._SharedObject): |
a49e2cc3 PP |
44 | _get_ref = staticmethod(native_bt.graph_get_ref) |
45 | _put_ref = staticmethod(native_bt.graph_put_ref) | |
bbb3650f | 46 | |
253a9ecc PP |
47 | def __init__(self, mip_version=0): |
48 | utils._check_uint64(mip_version) | |
49 | ||
50 | if mip_version > bt2.get_maximal_mip_version(): | |
51 | raise ValueError('unknown MIP version {}'.format(mip_version)) | |
52 | ||
53 | ptr = native_bt.graph_create(mip_version) | |
f6a5e476 PP |
54 | |
55 | if ptr is None: | |
614743a5 | 56 | raise bt2._MemoryError('cannot create graph object') |
f6a5e476 PP |
57 | |
58 | super().__init__(ptr) | |
59 | ||
61d96b89 FD |
60 | def add_component( |
61 | self, | |
62 | component_class, | |
63 | name, | |
64 | params=None, | |
b20382e2 | 65 | obj=None, |
c946c9de | 66 | logging_level=bt2_logging.LoggingLevel.NONE, |
61d96b89 | 67 | ): |
5265f5e3 | 68 | if isinstance(component_class, bt2_component._SourceComponentClassConst): |
871a292a | 69 | cc_ptr = component_class._ptr |
b20382e2 | 70 | add_fn = native_bt.bt2_graph_add_source_component |
bc5c9924 | 71 | cc_type = native_bt.COMPONENT_CLASS_TYPE_SOURCE |
5265f5e3 | 72 | elif isinstance(component_class, bt2_component._FilterComponentClassConst): |
871a292a | 73 | cc_ptr = component_class._ptr |
b20382e2 | 74 | add_fn = native_bt.bt2_graph_add_filter_component |
bc5c9924 | 75 | cc_type = native_bt.COMPONENT_CLASS_TYPE_FILTER |
5265f5e3 | 76 | elif isinstance(component_class, bt2_component._SinkComponentClassConst): |
871a292a | 77 | cc_ptr = component_class._ptr |
b20382e2 | 78 | add_fn = native_bt.bt2_graph_add_sink_component |
871a292a | 79 | cc_type = native_bt.COMPONENT_CLASS_TYPE_SINK |
c946c9de | 80 | elif issubclass(component_class, bt2_component._UserSourceComponent): |
deec48a6 | 81 | cc_ptr = component_class._bt_cc_ptr |
b20382e2 | 82 | add_fn = native_bt.bt2_graph_add_source_component |
871a292a | 83 | cc_type = native_bt.COMPONENT_CLASS_TYPE_SOURCE |
c946c9de | 84 | elif issubclass(component_class, bt2_component._UserSinkComponent): |
deec48a6 | 85 | cc_ptr = component_class._bt_cc_ptr |
b20382e2 | 86 | add_fn = native_bt.bt2_graph_add_sink_component |
bc5c9924 | 87 | cc_type = native_bt.COMPONENT_CLASS_TYPE_SINK |
c946c9de | 88 | elif issubclass(component_class, bt2_component._UserFilterComponent): |
deec48a6 | 89 | cc_ptr = component_class._bt_cc_ptr |
b20382e2 | 90 | add_fn = native_bt.bt2_graph_add_filter_component |
871a292a | 91 | cc_type = native_bt.COMPONENT_CLASS_TYPE_FILTER |
f6a5e476 | 92 | else: |
61d96b89 FD |
93 | raise TypeError( |
94 | "'{}' is not a component class".format( | |
95 | component_class.__class__.__name__ | |
96 | ) | |
97 | ) | |
f6a5e476 PP |
98 | |
99 | utils._check_str(name) | |
cc81b5ab | 100 | utils._check_log_level(logging_level) |
b20382e2 PP |
101 | base_cc_ptr = component_class._bt_component_class_ptr() |
102 | ||
103 | if obj is not None and not native_bt.bt2_is_python_component_class(base_cc_ptr): | |
104 | raise ValueError('cannot pass a Python object to a non-Python component') | |
f6a5e476 | 105 | |
3e03e5e3 FD |
106 | if params is not None and not isinstance(params, (dict, bt2.MapValue)): |
107 | raise TypeError("'params' parameter is not a 'dict' or a 'bt2.MapValue'.") | |
108 | ||
b20382e2 | 109 | params = bt2.create_value(params) |
3e03e5e3 | 110 | |
bbb3650f | 111 | params_ptr = params._ptr if params is not None else None |
f6a5e476 | 112 | |
b20382e2 PP |
113 | status, comp_ptr = add_fn( |
114 | self._ptr, cc_ptr, name, params_ptr, obj, logging_level | |
115 | ) | |
fb25b9e3 | 116 | utils._handle_func_status(status, 'cannot add component to graph') |
bc5c9924 | 117 | assert comp_ptr |
5265f5e3 | 118 | return bt2_component._create_component_from_const_ptr(comp_ptr, cc_type) |
f6a5e476 PP |
119 | |
120 | def connect_ports(self, upstream_port, downstream_port): | |
49e6b55c FD |
121 | utils._check_type(upstream_port, bt2_port._OutputPortConst) |
122 | utils._check_type(downstream_port, bt2_port._InputPortConst) | |
61d96b89 FD |
123 | status, conn_ptr = native_bt.graph_connect_ports( |
124 | self._ptr, upstream_port._ptr, downstream_port._ptr | |
125 | ) | |
126 | utils._handle_func_status(status, 'cannot connect component ports within graph') | |
127 | assert conn_ptr | |
9012866a | 128 | return bt2_connection._ConnectionConst._create_from_ptr(conn_ptr) |
f6a5e476 | 129 | |
871a292a SM |
130 | def add_port_added_listener(self, listener): |
131 | if not callable(listener): | |
f6a5e476 PP |
132 | raise TypeError("'listener' parameter is not callable") |
133 | ||
fb25b9e3 | 134 | fn = native_bt.bt2_graph_add_port_added_listener |
61d96b89 FD |
135 | listener_from_native = functools.partial( |
136 | _graph_port_added_listener_from_native, listener | |
137 | ) | |
f6a5e476 | 138 | |
871a292a SM |
139 | listener_ids = fn(self._ptr, listener_from_native) |
140 | if listener_ids is None: | |
614743a5 | 141 | raise bt2._Error('cannot add listener to graph object') |
d09c69f7 | 142 | |
22b4de6a PP |
143 | def run_once(self): |
144 | status = native_bt.graph_run_once(self._ptr) | |
145 | utils._handle_func_status(status, 'graph object could not run once') | |
146 | ||
f6a5e476 PP |
147 | def run(self): |
148 | status = native_bt.graph_run(self._ptr) | |
0e312dbd | 149 | utils._handle_func_status(status, 'graph object stopped running') |
f6a5e476 | 150 | |
d73bb381 | 151 | def add_interrupter(self, interrupter): |
c946c9de | 152 | utils._check_type(interrupter, bt2_interrupter.Interrupter) |
d73bb381 | 153 | native_bt.graph_add_interrupter(self._ptr, interrupter._ptr) |
f6a5e476 | 154 | |
d73bb381 PP |
155 | def interrupt(self): |
156 | native_bt.graph_interrupt(self._ptr) |