X-Git-Url: http://git.efficios.com/?p=babeltrace.git;a=blobdiff_plain;f=src%2Fbindings%2Fpython%2Fbt2%2Fbt2%2Fmessage.py;h=80c5db432795c4bf2003919f69b2d6adeb5daf88;hp=35cb1bbe6b2886b88cd5d4a0852b3a22636bf02a;hb=0235b0db7de5bcacdb3650c92461f2ce5eb2143d;hpb=cfbd7cf3bde05e8a6606478889dcd663604ef7b5 diff --git a/src/bindings/python/bt2/bt2/message.py b/src/bindings/python/bt2/bt2/message.py index 35cb1bbe..80c5db43 100644 --- a/src/bindings/python/bt2/bt2/message.py +++ b/src/bindings/python/bt2/bt2/message.py @@ -1,83 +1,74 @@ -# The MIT License (MIT) +# SPDX-License-Identifier: MIT # # Copyright (c) 2017 Philippe Proulx -# -# 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.clock_snapshot -import bt2.packet -import bt2.stream -import bt2.event -import bt2 +from bt2 import clock_snapshot as bt2_clock_snapshot +from bt2 import packet as bt2_packet +from bt2 import stream as bt2_stream +from bt2 import event as bt2_event def _create_from_ptr(ptr): msg_type = native_bt.message_get_type(ptr) - - if msg_type not in _MESSAGE_TYPE_TO_CLS: - raise bt2.Error('unknown message type: {}'.format(msg_type)) - return _MESSAGE_TYPE_TO_CLS[msg_type]._create_from_ptr(ptr) -class _Message(object._SharedObject): +class _MessageConst(object._SharedObject): _get_ref = staticmethod(native_bt.message_get_ref) _put_ref = staticmethod(native_bt.message_put_ref) @staticmethod def _check_has_default_clock_class(clock_class): if clock_class is None: - raise bt2.NonexistentClockSnapshot( + raise ValueError( 'cannot get default clock snapshot: stream class has no default clock class' ) +class _Message(_MessageConst): + pass + + class _MessageWithDefaultClockSnapshot: def _get_default_clock_snapshot(self, borrow_clock_snapshot_ptr): snapshot_ptr = borrow_clock_snapshot_ptr(self._ptr) - return bt2.clock_snapshot._ClockSnapshot._create_from_ptr_and_get_ref( + return bt2_clock_snapshot._ClockSnapshotConst._create_from_ptr_and_get_ref( snapshot_ptr, self._ptr, self._get_ref, self._put_ref ) -class _EventMessage(_Message, _MessageWithDefaultClockSnapshot): - _borrow_default_clock_snapshot_ptr = staticmethod( +class _EventMessageConst(_MessageConst, _MessageWithDefaultClockSnapshot): + _borrow_default_clock_snapshot = staticmethod( native_bt.message_event_borrow_default_clock_snapshot_const ) + _borrow_event = staticmethod(native_bt.message_event_borrow_event_const) + _event_pycls = property(lambda _: bt2_event._EventConst) @property def default_clock_snapshot(self): self._check_has_default_clock_class(self.event.stream.cls.default_clock_class) - return self._get_default_clock_snapshot(self._borrow_default_clock_snapshot_ptr) + return self._get_default_clock_snapshot(self._borrow_default_clock_snapshot) @property def event(self): - event_ptr = native_bt.message_event_borrow_event(self._ptr) + event_ptr = self._borrow_event(self._ptr) assert event_ptr is not None - return bt2.event._Event._create_from_ptr_and_get_ref( + return self._event_pycls._create_from_ptr_and_get_ref( event_ptr, self._ptr, self._get_ref, self._put_ref ) -class _PacketMessage(_Message, _MessageWithDefaultClockSnapshot): +class _EventMessage(_EventMessageConst, _Message): + _borrow_event = staticmethod(native_bt.message_event_borrow_event) + _stream_pycls = property(lambda _: bt2_stream._Stream) + _event_pycls = property(lambda _: bt2_event._Event) + + +class _PacketMessageConst(_MessageConst, _MessageWithDefaultClockSnapshot): + _packet_pycls = bt2_packet._PacketConst + @property def default_clock_snapshot(self): self._check_has_default_clock_class(self.packet.stream.cls.default_clock_class) @@ -85,31 +76,47 @@ class _PacketMessage(_Message, _MessageWithDefaultClockSnapshot): @property def packet(self): - packet_ptr = self._borrow_packet_ptr(self._ptr) + packet_ptr = self._borrow_packet(self._ptr) assert packet_ptr is not None - return bt2.packet._Packet._create_from_ptr_and_get_ref(packet_ptr) + return self._packet_pycls._create_from_ptr_and_get_ref(packet_ptr) -class _PacketBeginningMessage(_PacketMessage): - _borrow_packet_ptr = staticmethod(native_bt.message_packet_beginning_borrow_packet) +class _PacketMessage(_PacketMessageConst, _Message): + _packet_pycls = bt2_packet._Packet + + +class _PacketBeginningMessageConst(_PacketMessageConst): + _borrow_packet = staticmethod( + native_bt.message_packet_beginning_borrow_packet_const + ) _borrow_default_clock_snapshot_ptr = staticmethod( native_bt.message_packet_beginning_borrow_default_clock_snapshot_const ) -class _PacketEndMessage(_PacketMessage): - _borrow_packet_ptr = staticmethod(native_bt.message_packet_end_borrow_packet) +class _PacketBeginningMessage(_PacketMessage): + _borrow_packet = staticmethod(native_bt.message_packet_beginning_borrow_packet) + + +class _PacketEndMessageConst(_PacketMessageConst): + _borrow_packet = staticmethod(native_bt.message_packet_end_borrow_packet_const) _borrow_default_clock_snapshot_ptr = staticmethod( native_bt.message_packet_end_borrow_default_clock_snapshot_const ) -class _StreamMessage(_Message, _MessageWithDefaultClockSnapshot): +class _PacketEndMessage(_PacketMessage): + _borrow_packet = staticmethod(native_bt.message_packet_end_borrow_packet) + + +class _StreamMessageConst(_MessageConst, _MessageWithDefaultClockSnapshot): + _stream_pycls = property(lambda _: bt2_stream._StreamConst) + @property def stream(self): stream_ptr = self._borrow_stream_ptr(self._ptr) assert stream_ptr - return bt2.stream._Stream._create_from_ptr_and_get_ref(stream_ptr) + return self._stream_pycls._create_from_ptr_and_get_ref(stream_ptr) @property def default_clock_snapshot(self): @@ -118,57 +125,83 @@ class _StreamMessage(_Message, _MessageWithDefaultClockSnapshot): status, snapshot_ptr = self._borrow_default_clock_snapshot_ptr(self._ptr) if status == native_bt.MESSAGE_STREAM_CLOCK_SNAPSHOT_STATE_UNKNOWN: - return bt2.clock_snapshot._UnknownClockSnapshot() + return bt2_clock_snapshot._UnknownClockSnapshot() - return bt2.clock_snapshot._ClockSnapshot._create_from_ptr_and_get_ref( + return bt2_clock_snapshot._ClockSnapshotConst._create_from_ptr_and_get_ref( snapshot_ptr, self._ptr, self._get_ref, self._put_ref ) + +class _StreamMessage(_StreamMessageConst, _Message): def _default_clock_snapshot(self, raw_value): utils._check_uint64(raw_value) self._set_default_clock_snapshot(self._ptr, raw_value) - _default_clock_snapshot = property(fset=_default_clock_snapshot) + _default_clock_snapshot = property( + fget=_StreamMessageConst.default_clock_snapshot.fget, + fset=_default_clock_snapshot, + ) + _stream_pycls = property(lambda _: bt2_stream._Stream) -class _StreamBeginningMessage(_StreamMessage): - _borrow_stream_ptr = staticmethod(native_bt.message_stream_beginning_borrow_stream) +class _StreamBeginningMessageConst(_StreamMessageConst): + _borrow_stream_ptr = staticmethod( + native_bt.message_stream_beginning_borrow_stream_const + ) _borrow_default_clock_snapshot_ptr = staticmethod( native_bt.message_stream_beginning_borrow_default_clock_snapshot_const ) + + +class _StreamBeginningMessage(_StreamMessage): + _borrow_stream_ptr = staticmethod(native_bt.message_stream_beginning_borrow_stream) _set_default_clock_snapshot = staticmethod( native_bt.message_stream_beginning_set_default_clock_snapshot ) -class _StreamEndMessage(_StreamMessage): - _borrow_stream_ptr = staticmethod(native_bt.message_stream_end_borrow_stream) +class _StreamEndMessageConst(_StreamMessageConst): + _borrow_stream_ptr = staticmethod(native_bt.message_stream_end_borrow_stream_const) _borrow_default_clock_snapshot_ptr = staticmethod( native_bt.message_stream_end_borrow_default_clock_snapshot_const ) + + +class _StreamEndMessage(_StreamMessage): + _borrow_stream_ptr = staticmethod(native_bt.message_stream_end_borrow_stream) _set_default_clock_snapshot = staticmethod( native_bt.message_stream_end_set_default_clock_snapshot ) -class _MessageIteratorInactivityMessage(_Message, _MessageWithDefaultClockSnapshot): - _borrow_default_clock_snapshot_ptr = staticmethod( - native_bt.message_message_iterator_inactivity_borrow_default_clock_snapshot_const +class _MessageIteratorInactivityMessageConst( + _MessageConst, _MessageWithDefaultClockSnapshot +): + _borrow_clock_snapshot_ptr = staticmethod( + native_bt.message_message_iterator_inactivity_borrow_clock_snapshot_const ) @property - def default_clock_snapshot(self): - # This kind of message always has a default clock class: no + def clock_snapshot(self): + # This kind of message always has a clock class: no # need to call self._check_has_default_clock_class() here. - return self._get_default_clock_snapshot(self._borrow_default_clock_snapshot_ptr) + return self._get_default_clock_snapshot(self._borrow_clock_snapshot_ptr) + + +class _MessageIteratorInactivityMessage( + _MessageIteratorInactivityMessageConst, _Message +): + pass -class _DiscardedMessage(_Message, _MessageWithDefaultClockSnapshot): +class _DiscardedMessageConst(_MessageConst, _MessageWithDefaultClockSnapshot): + _stream_pycls = property(lambda _: bt2_stream._StreamConst) + @property def stream(self): stream_ptr = self._borrow_stream_ptr(self._ptr) assert stream_ptr - return bt2.stream._Stream._create_from_ptr_and_get_ref(stream_ptr) + return self._stream_pycls._create_from_ptr_and_get_ref(stream_ptr) @property def count(self): @@ -176,15 +209,9 @@ class _DiscardedMessage(_Message, _MessageWithDefaultClockSnapshot): if avail is native_bt.PROPERTY_AVAILABILITY_AVAILABLE: return count - def _set_count(self, count): - utils._check_uint64(count) - self._set_count(self._ptr, count) - - _count = property(fset=_set_count) - def _check_has_default_clock_snapshots(self): if not self._has_default_clock_snapshots: - raise bt2.NonexistentClockSnapshot( + raise ValueError( 'cannot get default clock snapshot: such a message has no clock snapshots for this stream class' ) @@ -201,12 +228,21 @@ class _DiscardedMessage(_Message, _MessageWithDefaultClockSnapshot): return self._get_default_clock_snapshot(self._borrow_end_clock_snapshot_ptr) -class _DiscardedEventsMessage(_DiscardedMessage): +class _DiscardedMessage(_DiscardedMessageConst, _Message): + _stream_pycls = property(lambda _: bt2_stream._Stream) + + def _set_count(self, count): + utils._check_uint64(count) + self._set_count(self._ptr, count) + + _count = property(fget=_DiscardedMessageConst.count.fget, fset=_set_count) + + +class _DiscardedEventsMessageConst(_DiscardedMessageConst): _borrow_stream_ptr = staticmethod( native_bt.message_discarded_events_borrow_stream_const ) _get_count = staticmethod(native_bt.message_discarded_events_get_count) - _set_count = staticmethod(native_bt.message_discarded_events_set_count) _borrow_beginning_clock_snapshot_ptr = staticmethod( native_bt.message_discarded_events_borrow_beginning_default_clock_snapshot_const ) @@ -219,12 +255,16 @@ class _DiscardedEventsMessage(_DiscardedMessage): return self.stream.cls.discarded_events_have_default_clock_snapshots -class _DiscardedPacketsMessage(_DiscardedMessage): +class _DiscardedEventsMessage(_DiscardedMessage): + _borrow_stream_ptr = staticmethod(native_bt.message_discarded_events_borrow_stream) + _set_count = staticmethod(native_bt.message_discarded_events_set_count) + + +class _DiscardedPacketsMessageConst(_DiscardedMessageConst): _borrow_stream_ptr = staticmethod( native_bt.message_discarded_packets_borrow_stream_const ) _get_count = staticmethod(native_bt.message_discarded_packets_get_count) - _set_count = staticmethod(native_bt.message_discarded_packets_set_count) _borrow_beginning_clock_snapshot_ptr = staticmethod( native_bt.message_discarded_packets_borrow_beginning_default_clock_snapshot_const ) @@ -237,6 +277,11 @@ class _DiscardedPacketsMessage(_DiscardedMessage): return self.stream.cls.discarded_packets_have_default_clock_snapshots +class _DiscardedPacketsMessage(_DiscardedPacketsMessageConst, _DiscardedMessage): + _borrow_stream_ptr = staticmethod(native_bt.message_discarded_packets_borrow_stream) + _set_count = staticmethod(native_bt.message_discarded_packets_set_count) + + _MESSAGE_TYPE_TO_CLS = { native_bt.MESSAGE_TYPE_EVENT: _EventMessage, native_bt.MESSAGE_TYPE_MESSAGE_ITERATOR_INACTIVITY: _MessageIteratorInactivityMessage, @@ -247,3 +292,14 @@ _MESSAGE_TYPE_TO_CLS = { native_bt.MESSAGE_TYPE_DISCARDED_EVENTS: _DiscardedEventsMessage, native_bt.MESSAGE_TYPE_DISCARDED_PACKETS: _DiscardedPacketsMessage, } + +_MESSAGE_TYPE_TO_CLS = { + native_bt.MESSAGE_TYPE_EVENT: _EventMessageConst, + native_bt.MESSAGE_TYPE_MESSAGE_ITERATOR_INACTIVITY: _MessageIteratorInactivityMessageConst, + native_bt.MESSAGE_TYPE_STREAM_BEGINNING: _StreamBeginningMessageConst, + native_bt.MESSAGE_TYPE_STREAM_END: _StreamEndMessageConst, + native_bt.MESSAGE_TYPE_PACKET_BEGINNING: _PacketBeginningMessageConst, + native_bt.MESSAGE_TYPE_PACKET_END: _PacketEndMessageConst, + native_bt.MESSAGE_TYPE_DISCARDED_EVENTS: _DiscardedEventsMessageConst, + native_bt.MESSAGE_TYPE_DISCARDED_PACKETS: _DiscardedPacketsMessageConst, +}