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
113
114
115
116
117
// =============================================================================
// Copyright (c) 2026 Haixing Hu.
//
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Independent missing-path and seeded metadata evidence.
use qubit_fs::error::FsErrorKind;
use qubit_fs::error::FsOperation;
use crate::AsyncFileSystemContractSuite;
use crate::ContractCheckId;
use crate::ContractCheckOutcome;
use crate::ContractFailure;
use crate::FixtureSupport;
use crate::internal::verify_condition;
use crate::internal::verify_fs_error;
impl AsyncFileSystemContractSuite<'_> {
/// Executes both metadata entries through their independent drivers.
///
/// # Returns
///
/// `Ok(())` after both metadata checks complete.
///
/// # Errors
///
/// Returns the first failure raised while preparing or verifying either
/// check.
pub(super) async fn check_stat(&mut self) -> Result<(), ContractFailure> {
for id in [ContractCheckId::StatBasic, ContractCheckId::StatFileKind] {
self.check_stat_item(id).await?;
}
Ok(())
}
/// Records exactly the selected metadata entry.
///
/// # Parameters
///
/// * `id` - Metadata check to execute and record.
///
/// # Returns
///
/// `Ok(())` after the selected check's outcome is recorded.
///
/// # Errors
///
/// Returns a failure raised while preparing or verifying the check, with
/// its identity attached to the failure.
pub(super) async fn check_stat_item(&mut self, id: ContractCheckId) -> Result<(), ContractFailure> {
self.context.begin_check(id);
let spec = crate::internal::check_catalog::specification(id);
let outcome =
match id {
ContractCheckId::StatBasic => {
let relative = self.context.relative_name("stat-missing");
let path = self.fixture.path(&relative).map_err(|error| {
ContractFailure::with_source("stat missing path preparation failed", error).at(id)
})?;
let error = match self.fixture.file_system().stat(&path).await {
Err(error) => error,
Ok(_) => {
return Err(ContractFailure::message_only("stat missing path succeeded").at(id));
}
};
verify_fs_error(
error,
FsErrorKind::NotFound,
FsOperation::Stat,
&path,
self.context.properties().info().provider_id(),
None,
id,
)?;
ContractCheckOutcome::RejectedAsExpected
}
ContractCheckId::StatFileKind => {
let bytes = b"stateful stat";
let relative = self.context.relative_name("stat-file");
let prepared =
self.fixture.seed_file(&relative, bytes).await.map_err(|error| {
ContractFailure::with_source("stat file preparation failed", error).at(id)
})?;
match prepared {
FixtureSupport::Supported(path) => {
self.context.record_created(path.clone());
let metadata = self.fixture.file_system().stat(&path).await.map_err(|error| {
ContractFailure::with_source("seeded file stat failed", error).at(id)
})?;
verify_condition(
metadata.is_file_like(),
id,
"stat/file-kind: seeded resource is not file-like",
)?;
verify_condition(
metadata.len().is_none_or(|length| length == bytes.len() as u64),
id,
"stat file length mismatch",
)?;
ContractCheckOutcome::Passed
}
FixtureSupport::Unsupported => ContractCheckOutcome::Unverified {
reason: "fixture cannot seed a stat resource".to_owned(),
},
}
}
_ => {
return Err(ContractFailure::message_only("selected entry is not a metadata check").at(id));
}
};
self.context.record_check(id, spec.capability, outcome);
Ok(())
}
}