Struct PathStyle 

pub struct PathStyle { /* private fields */ }

The rules of a source’s paths: which characters separate the parts, how a root looks, whether names differ by case, and which names are hidden.

posix is /-separated with one root, case-sensitive, with dot names hidden. windows has drive roots such as C:\ and share roots such as \\server\share\, accepts both / and \ when a path is typed or pasted, writes \, ignores case, and hides nothing by name. host is the style of the machine the application runs on, the default of a source.

use gpui_cn::PathStyle;

let windows = PathStyle::windows();
let path = windows.path("c:/Users\\me/");
assert_eq!(path.as_str(), "c:\\Users\\me");
assert_eq!(path, windows.path("C:\\users\\ME"));
assert_eq!(windows.path("C:\\").parent(), None);

Implementations

impl PathStyle

pub fn posix() -> Self

/ paths with one root, case-sensitive.

pub fn windows() -> Self

Drive and share roots, \ as the written separator, with / accepted too, and names that ignore case.

pub fn host() -> Self

The style of the machine the application runs on.

pub fn with_display_separator(self, separator: char) -> Self

Writes / instead of \ in a Windows-style path. A POSIX style always writes /.

pub fn with_case_sensitive(self, case_sensitive: bool) -> Self

Sets whether two names that differ only by case are different names.

pub fn with_computer_root(self, computer_root: bool) -> Self

Whether a Windows-style source lists its drives as a root above the drive roots, as “This PC” does. With it, Up from C:\ goes to that listing, which the source answers for the path \. Without it, a drive root is its own parent.

pub fn is_windows(&self) -> bool

Whether this is a Windows style.

pub fn separator(&self) -> char

The separator the picker writes.

pub fn is_separator(&self, c: char) -> bool

Whether c separates the parts of a path when it is typed.

pub fn is_case_sensitive(&self) -> bool

Whether names that differ only by case are different names.

pub fn has_computer_root(&self) -> bool

Whether the source lists a root above the drives.

pub fn is_hidden_name(&self, name: &str) -> bool

Whether a name is hidden by the style’s own rule: a leading dot on a POSIX style, nothing on a Windows style, where hidden is an attribute the source reads.

pub fn fold<'a>(&self, name: &'a str) -> Cow<'a, str>

The name as the style compares it: lower case when case does not matter.

pub fn compare_names(&self, a: &str, b: &str) -> Ordering

Orders two names the way a listing sorts them: without regard to case, then by the name itself, whatever the style’s case rule.

pub fn path(&self, text: impl AsRef<str>) -> SourcePath

The path text names in this style.

pub fn normalize_pasted( &self, text: &str, env: &dyn Fn(&str) -> Option<String>, ) -> String

The path text for a pasted text: a file:// URL becomes a path, and a Windows-style path loses its surrounding quotes and spaces, takes the style’s separator, and has a lone drive letter made a drive root. %NAME% in a Windows-style path is expanded through env, and stays as it is when env does not know the name. A POSIX-style path is left as it is: a Windows-looking path pasted there is not guessed at.

Trait Implementations

impl Clone for PathStyle

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PathStyle

impl Debug for PathStyle

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

Formats the value using the given formatter.

impl Default for PathStyle

fn default() -> Self

Returns the “default value” for a type.

impl Eq for PathStyle

impl PartialEq for PathStyle

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PathStyle