[eclipse-iceoryx#139] Introduce signal and id_tracker traits

Author: elfenpiff

iceoryx2-cal/src/event/id_tracker.rs

@@ -0,0 +1,19 @@
+// Copyright (c) 2024 Contributors to the Eclipse Foundation
+//
+// See the NOTICE file(s) distributed with this work for additional
+// information regarding copyright ownership.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Apache Software License 2.0 which is available at
+// https://www.apache.org/licenses/LICENSE-2.0, or the MIT license
+// which is available at https://opensource.org/licenses/MIT.
+//
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+
+use super::TriggerId;
+
+pub trait IdTracker<Id: TriggerId> {
+    fn set(&self, id: Id);
+    fn reset_next(&self) -> Id;
+    fn reset_all<F: FnMut(Id)>(&self, callback: F);
+}

iceoryx2-cal/src/event/id_tracker/mod.rs

@@ -10,7 +10,9 @@
 //
 // SPDX-License-Identifier: Apache-2.0 OR MIT
 
+pub mod id_tracker;
 pub mod process_local;
+pub mod signal;
 pub mod unix_datagram_socket;
 
 use std::{fmt::Debug, time::Duration};

iceoryx2-cal/src/event/mod.rs

@@ -0,0 +1,22 @@
+// Copyright (c) 2024 Contributors to the Eclipse Foundation
+//
+// See the NOTICE file(s) distributed with this work for additional
+// information regarding copyright ownership.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Apache Software License 2.0 which is available at
+// https://www.apache.org/licenses/LICENSE-2.0, or the MIT license
+// which is available at https://opensource.org/licenses/MIT.
+//
+// SPDX-License-Identifier: Apache-2.0 OR MIT
+
+use std::time::Duration;
+
+use super::{ListenerWaitError, NotifierNotifyError};
+
+pub trait SignalMechanism {
+    fn notify(&self) -> Result<(), NotifierNotifyError>;
+    fn try_wait(&self) -> Result<(), ListenerWaitError>;
+    fn timed_wait(&self, timeout: Duration) -> Result<(), ListenerWaitError>;
+    fn blocking_wait(&self) -> Result<(), ListenerWaitError>;
+}