qubit-fs 0.2.2

Provider-neutral synchronous and asynchronous filesystem abstraction for Rust
Documentation
// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
// facade.
//! Validated temporary-file creation request.

use crate::temp::TempOptions;

/// A facade-created temporary-file request.
///
/// # Examples
///
/// ```rust
/// use qubit_fs::spi::CreateTempFileRequest;
/// use qubit_fs::temp::TempOptions;
///
/// assert!(std::any::type_name::<CreateTempFileRequest>().contains("CreateTempFileRequest"));
/// assert_eq!(TempOptions::default(), TempOptions::new());
/// ```
pub struct CreateTempFileRequest {
    /// Validated temporary-file creation options.
    options: TempOptions,
}

impl CreateTempFileRequest {
    /// Creates this request inside the facade boundary.
    ///
    /// # Parameters
    /// - `options`: Validated temporary-file creation options.
    ///
    /// # Returns
    /// A provider temporary-file request.
    #[allow(dead_code)]
    #[inline]
    pub(crate) const fn new(options: TempOptions) -> Self {
        Self { options }
    }

    /// Returns requested temporary-file options.
    ///
    /// # Returns
    /// The immutable temporary-file creation options.
    #[inline]
    #[must_use]
    pub const fn options(&self) -> &TempOptions {
        &self.options
    }
}