Struct DirStorageStrategy 

pub struct DirStorageStrategy {
    pub format: FormatStrategy,
    pub atomic_write: AtomicWriteConfig,
    pub extension: Option<String>,
    pub filename_encoding: FilenameEncoding,
}

Strategy configuration for directory-based storage operations.

Fields

format: FormatStrategy

File format to use for serialisation (JSON or TOML).

atomic_write: AtomicWriteConfig

Atomic write configuration (retry count, temp-file cleanup).

extension: Option<String>

Custom file extension. When None the extension is derived from format ("json" or "toml").

filename_encoding: FilenameEncoding

Filename encoding strategy for entity IDs.

Implementations

impl DirStorageStrategy

pub fn new() -> Self

Create a new strategy with default values.

pub fn with_format(self, format: FormatStrategy) -> Self

Set the file format.

Arguments

• format - FormatStrategy::Json or FormatStrategy::Toml.

Returns

self with the updated format (builder pattern).

pub fn with_extension(self, ext: impl Into<String>) -> Self

Set a custom file extension.

Arguments

• ext - Extension string without the leading dot (e.g. "json").

Returns

self with the updated extension (builder pattern).

pub fn with_filename_encoding(self, encoding: FilenameEncoding) -> Self

Set the filename encoding strategy.

Arguments

• encoding - One of FilenameEncoding::Direct, UrlEncode, or Base64.

Returns

self with the updated encoding (builder pattern).

pub fn with_retry_count(self, count: usize) -> Self

Set the retry count for atomic writes.

Arguments

• count - Number of rename attempts before returning an error.

Returns

self with the updated retry count (builder pattern).

pub fn with_cleanup(self, cleanup: bool) -> Self

Set whether to clean up orphaned temporary files.

Arguments

• cleanup - When true, stale .tmp.* files are removed after every successful atomic write (best-effort; errors are silently ignored).

Returns

self with the updated cleanup flag (builder pattern).

pub fn get_extension(&self) -> String

Returns the effective file extension for this strategy.

Uses self.extension when set; otherwise derives "json" or "toml" from self.format.

Trait Implementations

impl Clone for DirStorageStrategy

fn clone(&self) -> DirStorageStrategy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DirStorageStrategy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DirStorageStrategy

fn default() -> Self

Returns the “default value” for a type.