flexstr 0.11.7

A flexible, simple to use, clone-efficient string type 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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

use alloc::{borrow::Cow, rc::Rc, sync::Arc};
use core::{convert::Infallible, str::FromStr};
use std::{
    ffi::{OsStr, OsString},
    path::{Path, PathBuf},
};

use crate::flex::{
    FlexStr, ImmutableBytes, RefCounted, RefCountedMut, partial_eq_impl, ref_counted_mut_impl,
};

use flexstr_support::StringToFromBytes;

/// Local `Path` type (NOTE: This can't be shared between threads)
pub type LocalPath = FlexStr<'static, Path, Rc<Path>>;

/// Shared `Path` type
pub type SharedPath = FlexStr<'static, Path, Arc<Path>>;

/// Local `Path` type that can optionally hold borrows (NOTE: This can't be shared between threads)
pub type LocalPathRef<'s> = FlexStr<'s, Path, Rc<Path>>;

/// Shared `Path` type that can optionally hold borrows
pub type SharedPathRef<'s> = FlexStr<'s, Path, Arc<Path>>;

const _: () = assert!(
    size_of::<Option<LocalPath>>() <= size_of::<PathBuf>(),
    "Option<LocalPath> must be less than or equal to the size of PathBuf"
);
const _: () = assert!(
    size_of::<Option<SharedPath>>() <= size_of::<PathBuf>(),
    "Option<SharedPath> must be less than or equal to the size of PathBuf"
);

// *** ImmutableBytes ***

impl ImmutableBytes for Path {}

// *** RefCountedMut ***

ref_counted_mut_impl!(Path);

// *** From for FlexStr ***

// NOTE: Cannot be implemented generically because of impl<T> From<T> for T
impl<'s, R: RefCounted<Path>> From<PathBuf> for FlexStr<'s, Path, R> {
    fn from(p: PathBuf) -> Self {
        FlexStr::from_owned(p)
    }
}

impl<'s, R: RefCounted<Path>> From<String> for FlexStr<'s, Path, R> {
    fn from(s: String) -> Self {
        FlexStr::from_owned(s.into())
    }
}

impl<'s, R: RefCounted<Path>> From<OsString> for FlexStr<'s, Path, R> {
    fn from(s: OsString) -> Self {
        FlexStr::from_owned(s.into())
    }
}

impl<'s, R: RefCounted<Path>> From<&'s str> for FlexStr<'s, Path, R> {
    fn from(s: &'s str) -> Self {
        FlexStr::from_borrowed(Path::new(s))
    }
}

impl<'s, R: RefCounted<Path>> From<&'s OsStr> for FlexStr<'s, Path, R> {
    fn from(s: &'s OsStr) -> Self {
        FlexStr::from_borrowed(Path::new(s))
    }
}

// *** PartialEq ***

partial_eq_impl!(Path, Path);
partial_eq_impl!(&Path, Path);
partial_eq_impl!(PathBuf, Path);
partial_eq_impl!(Cow<'s, Path>, Path);

// *** AsRef ***

impl<'s, S: ?Sized + StringToFromBytes, R: RefCounted<S>> AsRef<Path> for FlexStr<'s, S, R>
where
    S: AsRef<Path>,
{
    fn as_ref(&self) -> &Path {
        self.as_ref_type().as_ref()
    }
}

// *** FromStr ***

impl<R: RefCounted<Path>> FromStr for FlexStr<'static, Path, R> {
    type Err = Infallible;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Ok(FlexStr::from_borrowed(Path::new(s)).into_owned())
    }
}