[eclipse-iceoryx#231] Add test interface to file lock

iceoryx2-cal/src/monitoring/file_lock.rs

@@ -19,6 +19,7 @@ use iceoryx2_bb_posix::{
         ProcessCleaner, ProcessCleanerCreateError, ProcessGuard, ProcessGuardCreateError,
         ProcessMonitor, ProcessMonitorCreateError, ProcessMonitorStateError, ProcessState,
     },
+    testing::__internal_process_guard_staged_death,
 };
 use iceoryx2_bb_system_types::{file_name::FileName, path::Path};
 
@@ -31,8 +32,8 @@ use crate::{
 };
 
 use super::{
-    Monitoring, MonitoringBuilder, MonitoringCleaner, MonitoringCreateTokenError,
-    MonitoringMonitor, MonitoringStateError, MonitoringToken,
+    testing::__InternalMonitoringTokenTestable, Monitoring, MonitoringBuilder, MonitoringCleaner,
+    MonitoringCreateTokenError, MonitoringMonitor, MonitoringStateError, MonitoringToken,
 };
 
 #[derive(Debug)]
@@ -141,7 +142,7 @@ impl MonitoringCleaner for Cleaner {}
 
 #[derive(Debug)]
 pub struct Token {
-    _guard: ProcessGuard,
+    guard: ProcessGuard,
     name: FileName,
 }
 
@@ -153,6 +154,12 @@ impl NamedConcept for Token {
 
 impl MonitoringToken for Token {}
 
+impl __InternalMonitoringTokenTestable for Token {
+    fn staged_death(self) {
+        __internal_process_guard_staged_death(self.guard);
+    }
+}
+
 #[derive(Debug)]
 pub struct Monitor {
     monitor: ProcessMonitor,
@@ -215,8 +222,8 @@ impl MonitoringBuilder<FileLockMonitoring> for Builder {
         let msg = "Unable to create FileLockMonitoring token";
         let process_state_path = self.config.path_for(&self.name);
         match ProcessGuard::new(&process_state_path) {
-            Ok(_guard) => Ok(Token {
-                _guard,
+            Ok(guard) => Ok(Token {
+                guard,
                 name: self.name,
             }),
             Err(ProcessGuardCreateError::InsufficientPermissions) => {

iceoryx2-cal/src/monitoring/mod.rs

@@ -81,6 +81,8 @@ pub use crate::{
 
 pub mod file_lock;
 pub mod process_local;
+#[doc(hidden)]
+pub mod testing;
 
 /// Represents the state of a monitored process.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]

iceoryx2-cal/src/monitoring/testing.rs

@@ -0,0 +1,15 @@
+// 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
+
+pub trait __InternalMonitoringTokenTestable {
+    fn staged_death(self);
+}