qubit-fs 0.2.2

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
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

// =============================================================================
//    Copyright (c) 2025 - 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================

// facade tests.
//! Iteration over lexical logical path components.

/// Iterator over the path's lexical component boundaries.
///
/// # Examples
///
/// ```rust
/// use qubit_fs::path::{Path, PathComponents};
///
/// let path = Path::parse("/a/b")?;
/// let components: PathComponents<'_> = path.components();
/// assert_eq!(2, components.count());
/// # Ok::<(), qubit_fs::FsError>(())
/// ```
#[derive(Clone, Debug)]
pub struct PathComponents<'a> {
    /// Remaining lexical text with an absolute leading separator removed.
    remaining: Option<&'a str>,
}

impl<'a> PathComponents<'a> {
    /// Creates an iterator for `text`, removing only the absolute root marker.
    pub(crate) fn new(text: &'a str, absolute: bool, literal: bool) -> Self {
        let text = if absolute && !literal {
            text.strip_prefix('/').unwrap_or(text)
        } else {
            text
        };
        Self {
            remaining: (!text.is_empty()).then_some(text),
        }
    }
}

impl<'a> Iterator for PathComponents<'a> {
    type Item = &'a str;

    /// Returns the next lexical component, including empty literal components.
    fn next(&mut self) -> Option<Self::Item> {
        let remaining = self.remaining?;
        match remaining.split_once('/') {
            Some((component, rest)) => {
                self.remaining = Some(rest);
                Some(component)
            }
            None => {
                self.remaining = None;
                Some(remaining)
            }
        }
    }
}