qubit-fs 0.2.0

Provider-neutral synchronous and asynchronous filesystem abstraction for Rust
Documentation 
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

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Atomicity requirement used by write, rename, and persist operations.

/// Atomicity contract requested by an operation.
///
/// # Examples
///
/// ```rust
/// use qubit_fs::metadata::AtomicityRequirement;
///
/// assert_eq!(AtomicityRequirement::Preferred, AtomicityRequirement::default());
/// ```
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub enum AtomicityRequirement {
    /// Success must be atomic; unsupported guarantees fail before side effects.
    Required,
    /// Prefer an atomic method but permit a reported non-atomic result.
    Preferred,
    /// Do not require atomicity, although an implementation may still use it.
    NotRequired,
}

impl Default for AtomicityRequirement {
    /// Prefers atomic behavior while permitting an explicit fallback.
    #[inline]
    fn default() -> Self {
        Self::Preferred
    }
}