mirror of
https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git
synced 2026-10-25 12:39:18 +03:00
c9378d6c63
PEP 703 [0] discusses making the GIL optional in certain builds of the CPython interpreter. This build option was available experiementally in Python 3.13 but has since been stabilized in Python 3.14 per PEP 779 [1]. According to the porting guide [2], there is no strict requirement that C extensions must be thread-safe. Experiments have shown that no logic changes are required if callers use sychronization mechanisms provided by the Python standard library. The documentation has been updated to call this out specifically using terminology from the porting guide [3]. [0]: https://peps.python.org/pep-0703/ [1]: https://peps.python.org/pep-0779/ [2]: https://py-free-threading.github.io/porting/#define-and-document-thread-safety-guarantees [3]: https://py-free-threading.github.io/documentation-principles/#free-threading-terminology Signed-off-by: Vincent Fazio <vfazio@gmail.com> Link: https://patch.msgid.link/20260527215922.18678-3-vfazio@gmail.com Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>
61 lines
1.8 KiB
Python
61 lines
1.8 KiB
Python
# SPDX-License-Identifier: LGPL-2.1-or-later
|
|
# SPDX-FileCopyrightText: 2022 Bartosz Golaszewski <brgl@bgdev.pl>
|
|
|
|
from dataclasses import dataclass
|
|
from enum import Enum
|
|
|
|
from . import _ext
|
|
|
|
__all__ = ["EdgeEvent"]
|
|
|
|
|
|
@dataclass(frozen=True, init=False, repr=False)
|
|
class EdgeEvent:
|
|
"""
|
|
Immutable object containing data about a single edge event.
|
|
|
|
Synchronization: none required
|
|
"""
|
|
|
|
class Type(Enum):
|
|
"""Possible edge event types."""
|
|
|
|
RISING_EDGE = _ext.EDGE_EVENT_TYPE_RISING
|
|
"""Rising edge event."""
|
|
FALLING_EDGE = _ext.EDGE_EVENT_TYPE_FALLING
|
|
"""Falling edge event."""
|
|
|
|
event_type: Type
|
|
"""Edge event type."""
|
|
timestamp_ns: int
|
|
"""Timestamp of the event in nanoseconds."""
|
|
line_offset: int
|
|
"""Offset of the line on which this event was registered."""
|
|
global_seqno: int
|
|
"""Global sequence number of this event."""
|
|
line_seqno: int
|
|
"""Event sequence number specific to the concerned line."""
|
|
|
|
def __init__(
|
|
self,
|
|
event_type: int,
|
|
timestamp_ns: int,
|
|
line_offset: int,
|
|
global_seqno: int,
|
|
line_seqno: int,
|
|
):
|
|
object.__setattr__(self, "event_type", EdgeEvent.Type(event_type))
|
|
object.__setattr__(self, "timestamp_ns", timestamp_ns)
|
|
object.__setattr__(self, "line_offset", line_offset)
|
|
object.__setattr__(self, "global_seqno", global_seqno)
|
|
object.__setattr__(self, "line_seqno", line_seqno)
|
|
|
|
def __str__(self) -> str:
|
|
return "<EdgeEvent type={} timestamp_ns={} line_offset={} global_seqno={} line_seqno={}>".format( # noqa: UP032
|
|
self.event_type,
|
|
self.timestamp_ns,
|
|
self.line_offset,
|
|
self.global_seqno,
|
|
self.line_seqno,
|
|
)
|