xray-tui 1.4.1

A layer inspector for OCI-compliant images
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

use std::path::Path;

/// A small helper struct that contains a [Path] and can iterate over its components without changing the underlying [Path] instance.
///
/// The contained [Path] can be restored to its original state if needed.
#[derive(Clone)]
pub struct RestorablePath<'a> {
    path: &'a Path,
    current_component_idx: u8,
    is_using_relative_path: bool,
}

impl<'a> RestorablePath<'a> {
    /// Creates a new [RestorablePath] using the provided [Path].
    pub fn new(path: &'a Path) -> Self {
        RestorablePath {
            path,
            current_component_idx: 0,
            is_using_relative_path: !path.starts_with("/"),
        }
    }

    /// Returns the current [Self::path] component.
    pub(super) fn get_current_component(&self) -> Option<&Path> {
        self.path
            .iter()
            .nth(self.current_component_idx as usize)
            .map(Path::new)
    }

    /// Returns a new [RestorablePath] with its state reset to the original state of this instance.
    pub(super) fn restore(&self) -> Self {
        RestorablePath {
            path: self.path,
            current_component_idx: 0,
            is_using_relative_path: self.is_using_relative_path,
        }
    }

    /// Returns a new [RestorablePath] with its path component index increased by `1`.
    pub(super) fn advance(&self) -> Self {
        RestorablePath {
            path: self.path,
            current_component_idx: self.current_component_idx + 1,
            is_using_relative_path: self.is_using_relative_path,
        }
    }

    /// Strips the leading slash from the contained path.
    pub(super) fn strip_prefix(&mut self) {
        self.path = self.path.strip_prefix("/").ok().unwrap_or(self.path);
    }

    pub(super) fn is_using_relative_path(&self) -> bool {
        self.is_using_relative_path
    }
}