1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
// =============================================================================
// Copyright (c) 2026 Haixing Hu.
//
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Dispatches temporary-resource checks through the typed catalog.
use super::AsyncFileSystemContractSuite;
use super::FileSystemCapability;
use crate::ContractCheckId;
use crate::ContractCheckOutcome;
use crate::ContractFailure;
impl<'a> AsyncFileSystemContractSuite<'a> {
/// Executes all asynchronous temporary-resource checks in catalog order.
///
/// # Returns
///
/// Returns `Ok(())` after every temporary-resource check completes, or a
/// `ContractFailure` when a check cannot complete.
///
/// # Errors
///
/// Returns a `ContractFailure` if any temporary-resource check fails.
pub(super) async fn check_temp_resources(&mut self) -> Result<(), ContractFailure> {
for id in [
ContractCheckId::TempFile,
ContractCheckId::TempDirectory,
ContractCheckId::TempAtomic,
ContractCheckId::TempRepeatedLifecycle,
] {
self.check_temp_item(id).await?;
}
Ok(())
}
/// Executes exactly one temporary-resource catalog entry.
///
/// The selected identifier must belong to the temporary lifecycle
/// contract; execution records the resulting check outcome in the suite
/// context.
///
/// # Returns
///
/// Returns `Ok(())` after recording the check outcome.
///
/// # Errors
///
/// Returns a `ContractFailure` if `id` does not select a temporary
/// lifecycle entry, or if the selected provider operation or observation
/// fails to satisfy its contract.
///
/// # Parameters
///
/// - `id`: Temporary-resource check identity selecting the lifecycle case.
pub(super) async fn check_temp_item(&mut self, id: ContractCheckId) -> Result<(), ContractFailure> {
self.context.begin_check(id);
let file = self.capable(FileSystemCapability::TempFile);
let directory = self.capable(FileSystemCapability::TempDirectory);
let mut unverified_reason = None;
let outcome = match id {
ContractCheckId::TempFile => {
unverified_reason = self.execute_temp_file(id).await?;
if file {
ContractCheckOutcome::Passed
} else {
ContractCheckOutcome::RejectedAsExpected
}
}
ContractCheckId::TempDirectory => {
unverified_reason = self.execute_temp_directory(id).await?;
if directory {
ContractCheckOutcome::Passed
} else {
ContractCheckOutcome::RejectedAsExpected
}
}
ContractCheckId::TempAtomic | ContractCheckId::TempRepeatedLifecycle => {
if file {
unverified_reason = self.execute_temp_file(id).await?;
}
if directory && let Some(reason) = self.execute_temp_directory(id).await? {
unverified_reason.get_or_insert(reason);
}
if !file && !directory {
ContractCheckOutcome::NotApplicable {
reason: "no temporary resource capability".to_owned(),
}
} else if id == ContractCheckId::TempAtomic && !self.capable(FileSystemCapability::AtomicTempPersist) {
ContractCheckOutcome::RejectedAsExpected
} else {
ContractCheckOutcome::Passed
}
}
_ => {
return Err(ContractFailure::message_only("selected entry is not temporary lifecycle").at(id));
}
};
let outcome = match unverified_reason {
Some(reason) => ContractCheckOutcome::Unverified { reason },
None => outcome,
};
self.context.record_check(
id,
crate::internal::check_catalog::specification(id).capability,
outcome,
);
Ok(())
}
}