1 # The MIT License (MIT)
3 # Copyright (c) 2017 Philippe Proulx <pproulx@efficios.com>
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:
12 # The above copyright notice and this permission notice shall be included in
13 # all copies or substantial portions of the Software.
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
23 from bt2
import native_bt
, object, utils
24 import bt2
.field_class
25 import collections
.abc
32 def _trace_destruction_listener_from_native(user_listener
, trace_ptr
):
33 trace
= bt2
.trace
.Trace
._create
_from
_ptr
_and
_get
_ref
(trace_ptr
)
37 class Trace(object._SharedObject
, collections
.abc
.Mapping
):
38 _get_ref
= staticmethod(native_bt
.trace_get_ref
)
39 _put_ref
= staticmethod(native_bt
.trace_put_ref
)
42 count
= native_bt
.trace_get_stream_count(self
._ptr
)
46 def __getitem__(self
, id):
47 utils
._check
_uint
64(id)
49 stream_ptr
= native_bt
.trace_borrow_stream_by_id_const(self
._ptr
, id)
51 if stream_ptr
is None:
54 return bt2
.stream
._Stream
._create
_from
_ptr
_and
_get
_ref
(stream_ptr
)
57 for idx
in range(len(self
)):
58 stream_ptr
= native_bt
.trace_borrow_stream_by_index_const(self
._ptr
, idx
)
59 assert stream_ptr
is not None
61 id = native_bt
.stream_get_id(stream_ptr
)
68 return native_bt
.trace_get_name(self
._ptr
)
70 def _name(self
, name
):
71 utils
._check
_str
(name
)
72 ret
= native_bt
.trace_set_name(self
._ptr
, name
)
73 utils
._handle
_ret
(ret
, "cannot set trace class object's name")
75 _name
= property(fset
=_name
)
77 def create_stream(self
, stream_class
, id=None, name
=None):
78 utils
._check
_type
(stream_class
, bt2
.stream_class
.StreamClass
)
80 if stream_class
.assigns_automatic_stream_id
:
82 raise bt2
.CreationError("id provided, but stream class assigns automatic stream ids")
84 stream_ptr
= native_bt
.stream_create(stream_class
._ptr
, self
._ptr
)
87 raise bt2
.CreationError("id not provided, but stream class does not assign automatic stream ids")
89 utils
._check
_uint
64(id)
90 stream_ptr
= native_bt
.stream_create_with_id(stream_class
._ptr
, self
._ptr
, id)
92 if stream_ptr
is None:
93 raise bt2
.CreationError('cannot create stream object')
95 stream
= bt2
.stream
._Stream
._create
_from
_ptr
(stream_ptr
)
102 def add_destruction_listener(self
, listener
):
103 '''Add a listener to be called when the trace is destroyed.'''
104 if not callable(listener
):
105 raise TypeError("'listener' parameter is not callable")
107 fn
= native_bt
.py3_trace_add_destruction_listener
108 listener_from_native
= functools
.partial(_trace_destruction_listener_from_native
,
111 listener_id
= fn(self
._ptr
, listener_from_native
)
112 if listener_id
is None:
113 utils
._raise
_bt
2_error
('cannot add destruction listener to trace object')
115 return bt2
._ListenerHandle(listener_id
, self
)